git:20260421.2794248 to git:20260916.9da4b53

---

name: example-skill

description: >

Use when demonstrating a correctly structured agent skill. Trigger when the user asks to

"show a well-formed skill", "give me a skill template", or "what does a compliant SKILL.md

look like". Also triggers for regression testing: this fixture MUST score maturity >= L2

with zero Critical or Error findings.

allowed-tools: Read, Write

---

# 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:

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

- **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 |