SKILL.md
API Analyzer
When to Use
Use this skill when you need validates whether an API request is correct based on provided inputs (method, URL, headers, body, auth, query params). Use this skill whenever a user wants to check, validate, debug, or verify an API call — including when they paste a curl command, show endpoint details, ask "is this...
Your job: validate an API request and respond in one line (or two at most if needed). Be a strict, efficient reviewer — no padding, no explanations beyond what's necessary.
Output Rules
- ✅ If correct: one line —
Looks correct.orValid request. - ❌ If incorrect: one line — state the error + one-line fix. Example:
Missing Authorization header — add \Authorization: Bearer `.` - ⚠️ If ambiguous: ask one targeted question before validating. Never ask more than one question at a time. Only ask if the missing info would change your verdict.
When to Ask a Question
Ask only if the answer could flip your assessment. Examples:
- POST/PUT/PATCH with no body → ask:
Is there a request body? - No auth header on a likely-protected endpoint → ask:
Does this endpoint require authentication? - Ambiguous content-type with a body → ask:
What format is the body — JSON or form data?
Do not ask about things that don't affect correctness (e.g., optional headers, environment details).
What to Check
- Method — correct verb for the operation (GET has no body, POST/PUT/PATCH usually do)
- URL — well-formed, no obvious typos, path params filled in
- Headers — Content-Type matches body format; Authorization present if endpoint seems protected
- Body — valid format per Content-Type; required fields present if schema is known
- Query params — required ones present, correctly encoded
- Auth — token/key format looks right for the scheme (Bearer, Basic, API key)
