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:
- For acceptance criteria and completion gates -> read
references/acceptance-criteria.md - For analysis notes and known patterns in this fixture -> read
references/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 references/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 references/acceptance-criteria.md |
| Structured Output | Table-formatted step summary |
| Trigger Vocabulary | Rich description with multiple phrasing variants |
More from richfrem/agent-plugins-skills
markdown-to-msword-converter
Converts Markdown files to one MS Word document per file using plugin-local scripts. V2 includes L5 Delegated Constraint Verification for strict binary artifact linting.
52excel-to-csv
>
32zip-bundling
Create technical ZIP bundles of code, design, and documentation for external review or context sharing. Use when you need to package multiple project files into a portable `.zip` archive instead of a single Markdown file.
29learning-loop
(Industry standard: Loop Agent / Single Agent) Primary Use Case: Self-contained research, content generation, and exploration where no inner delegation is required. Self-directed research and knowledge capture loop. Use when: starting a session (Orientation), performing research (Synthesis), or closing a session (Seal, Persist, Retrospective). Ensures knowledge survives across isolated agent sessions.
26ollama-launch
Start and verify the local Ollama LLM server. Use when Ollama is needed for RLM distillation, seal snapshots, embeddings, or any local LLM inference — and it's not already running. Checks if Ollama is running, starts it if not, and verifies the health endpoint.
26spec-kitty-checklist
A standard Spec-Kitty workflow routine.
26