agentsclimarketplace
Sign in

Example skill

Skill richfrem/agent-plugins-skills/plugins/agent-scaffolders/tests/gold-standard-plugin/skills/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.From its SKILL.md

Install
npx -y skills add richfrem/agent-plugins-skills --skill example-skill

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

One thing to look at

  • 4 stars4 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.

SKILL.md

1.9 KB, 320 tokens by cl100k_base, as published. Nobody here has run it

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

PrincipleImplementation
Progressive DisclosureDeep content in references/, lean SKILL.md
Acceptance Criteria GateExplicit checklist in ./acceptance-criteria.md
Structured OutputTable-formatted step summary
Trigger VocabularyRich description with multiple phrasing variants

What ships with it: 4 files

1.4 KB alongside SKILL.md

references/

Keep looking

Skills are one crate of 326,851. Ordering is by how many stacks a row turns up in, so the top of any crate is what has actually been picked rather than what has the most stars.