richfrem/example-skill

Gold Standard Example Skill

This skill demonstrates the canonical structure for a compliant Agent Skill.

When analyzed by agent-plugin-analyzer, 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:

1. For acceptance criteria and completion gates -> read ./acceptance-criteria.md
2. 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-plugin against 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 |