Argument Audit

What it does

The argument-audit skill analyzes arguments provided to a function or piece of code, identifying potential issues like incorrect data types, missing parameters, or logical flaws. It can help debug existing code and proactively prevent errors by flagging suspicious argument combinations before execution. This skill aims to improve the robustness and reliability of software systems.

When to use it

• Debugging: When a function consistently produces unexpected results, use argument-audit to examine the input arguments for inconsistencies or invalid values.
• Code Review: Integrate into code review processes to identify potential argument-related vulnerabilities before they reach production.
• API Design: Validate and refine API designs by testing various argument combinations and ensuring expected behavior.
• Automated Testing: Incorporate argument-audit into automated test suites to proactively catch errors related to function arguments.

Key capabilities

• Argument validation
• Data type checking
• Parameter completeness verification
• Logical flaw detection in argument combinations

Example prompts

• "Analyze the arguments passed to this Python function: def calculate_area(length, width): ..."
• "Check if these parameters are valid for a user registration API call: name=John Doe, email=invalid-email, age=-5."
• “Can you audit the arguments being sent to this Javascript function and tell me what could go wrong?”

Tips & gotchas

The effectiveness of argument-audit depends on having access to the code or API definition being analyzed. It's most useful when combined with clear documentation about expected argument types and constraints.