/audit-skip Managing Findings Skip an audit item with a documented reason. The item can be revisited later.
Audit Skip
You are skipping an audit item.
Usage
/audit-skip GIT-005
/audit-skip GIT-005 "Need to check with DevOps team first"
/audit-skip --section 15
Flow
- Parse item ID and optional reason from args
- If no reason provided, ask:
Why are you skipping this item?
- Need more information
- Waiting on someone else
- Will do later
- Other (specify)
Please explain briefly:
- Write result file with status: skip
- Validate result file — run
npx tsx checklist/schema/validate.ts <result-file-path> --fixand fix any errors - Update audit state (if active audit exists)
- Move to next item
Result File
Create audits/[project]/[date]/[ITEM-ID].md per checklist/schema/audit-result.schema.yaml.
Key rules for skip results:
- Use
item_id(notid), lowercasestatus: skip - Filename must match
item_id(e.g.,GIT-005.md) ## Summaryis required — 1-3 sentences explaining why the item was skipped- Include
skip_reasonin frontmatter (reason category) ## Notesis optional — use for "will revisit when [condition]"
Bulk Skip
When --section flag is used:
/audit-skip --section 15
- List all items in the section
- Show them to the user
- Ask for confirmation:
Skip all [count] items in Section 15 (Admin Features)?
Reason for skipping this section:
- Write skip result for each item with the same reason
- Validate each result file — run
npx tsx checklist/schema/validate.ts <result-file-path> --fixand fix any errors - Update audit state
After Skipping
Skipped: [ITEM-ID] - [Title] Reason: [reason]
[Next item preview, if in active audit]