A minimal but complete SKILL.md that satisfies all 15 auditor checks. Used by tests/integration/test_skill_auditor.bats to confirm the auditor returns PASS or WARN on conforming input.
⚠️ Critical Constraints
- This is a test fixture, not a runtime skill. Do not invoke. Why: auditor tests pin the exact content; runtime use would surprise contributors.
- Frontmatter shape is canonical. YAML
description: |block scalar with explicit Triggers and Use-when markers. Why: exercisesdescription-has-triggersform (a) AND form (b) simultaneously. - Constraints are front-loaded. This
## ⚠️ Critical Constraintssection appears before any other H2. Why: testsconstraints-frontloadedheuristic. - Every constraint has a Why. Each bullet ends with
**Why:** <reason>. Why: testsrationale-presentheuristic.
Workflow
Phase 1: Setup
Read the fixture, parse frontmatter.
Checkpoint: frontmatter has name, description, metadata.tier.
Phase 2: Validate
Run all 8 Pass-2 checks.
Checkpoint: all 8 checks return pass or n/a.
Phase 3: Emit verdict
Aggregate via max-severity rule.
Checkpoint: verdict is PASS (no warns, no fails).
Output Specification
Format: stdout marker known-good confirming the fixture loaded cleanly.
Filename: none — runtime fixture only.
Exit code: 0.
Quality Rubric
- Frontmatter passes Pass 1 (heal-skill structural)
- Constraints section is front-loaded (first H2 after title)
- Every constraint has a Why: rationale
- Each Phase has a Checkpoint
- Output Specification is explicit
- Quality Rubric exists with checkboxes
- SKILL.md is under 250 lines
Examples
# Run auditor against this fixture; expect exit 0 and verdict PASS or WARN
bash skills/skill-auditor/scripts/audit.sh tests/fixtures/skills/known-good
Troubleshooting
| Problem | Cause | Solution |
|---|---|---|
| Auditor returns FAIL | Fixture drifted from canonical shape | Restore from git; do not edit without updating tests |