# Example Skill

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

- Skill: `richfrem/example-skill` (Agent Skill, multi-file: 5 files)
- Install (CLI): `npx skillmds@latest add richfrem/example-skill`
- Raw SKILL.md: https://api.skillmd.com/api/skills/richfrem/example-skill/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML, Security
- Author: richfrem (https://skillmd.com/u/richfrem)
- Updated: 2026-09-10
- Page: https://skillmd.com/skills/richfrem/example-skill

---


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