example-skill git:20260916.9da4b53A

Immutable. This exact content is served forever at /api/v1/blob/2540437cd11c5069.

---
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
- **Validate**: Run `audit-plugin` against this fixture and confirm expected structure
- **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 |