richfrem Gold Standard Example Skill
This skill demonstrates the canonical structure for a compliant Agent Skill.
When analyzed by agent-scaffolders, this fixture MUST:
- Score maturity >= L2 (structured skill + references directory)
- Produce zero Critical or Error findings
- Identify at least 2 patterns: Progressive Disclosure, Acceptance Criteria Gate
- Score Structure >= 4/5, Security = 5/5
Execution Flow
This skill uses Progressive Disclosure. Load only what you need:
- For acceptance criteria and completion gates -> read
./acceptance-criteria.md - For analysis notes and known patterns in this fixture -> read
./analysis-notes.md
Step 1: Orient
Identify what the user needs:
- Demo: Show the skill structure and explain the Progressive Disclosure pattern
- Validate: Run
analyze-pluginagainst this fixture and confirm expected scores - Reference: Use this SKILL.md as a template baseline for new skill scaffolding
Step 2: Execute
Present the relevant output based on the user's goal. Always confirm the acceptance
criteria in ./acceptance-criteria.md are satisfied before marking complete.
Design Principles Demonstrated
| Principle | Implementation |
|---|---|
| Progressive Disclosure | Deep content in references/, lean SKILL.md |
| Acceptance Criteria Gate | Explicit checklist in ./acceptance-criteria.md |
| Structured Output | Table-formatted step summary |
| Trigger Vocabulary | Rich description with multiple phrasing variants |