Find agent skills by outcome

return False

SKILL.md not found

return False

No YAML frontmatter found

Writing & Content

match = re.match(r'^---\n(.*?)\n---'

content

For skills where output quality depends on seeing examples

provide input/output pairs:

Follow this style: type(scope): brief description

then detailed explanation.

Here is a sensible default format

but use your best judgment:

Use these patterns when skills need to produce consistent

high-quality output.

Productivity

For complex tasks

break operations into clear

Productivity

For tasks with branching logic

guide Claude through decision points:

Writing & Content

2. Plan reusable skill contents (scripts

references

When creating a new skill from scratch

always run the `init_skill.py` script:

- Use cases: Templates

images

Files not intended to be loaded into context

but rather used within the output Claude produces.

- Avoid duplication: Information should live in either SKILL.md or references files

not both.

Marketing

- Examples: `assets/logo.png` for brand assets

`assets/slides.pptx` for PowerPoint templates

- Benefits: Keeps SKILL.md lean

loaded only when Claude determines it's needed

- Best practice: If files are large (>10k words)

include grep search patterns in SKILL.md

Coding & Debugging

- Use cases: Database schemas

API documentation

- Frontmatter (YAML): Contains `name` and `description` fields. These are the only fields that Claude reads to determine when the skill gets used

thus it is very important to be clear and comprehensive in describing what the skill is

- Examples: `references/finance.md` for financial schemas

`references/mnda.md` for company NDA template

- Benefits: Token efficient

deterministic

Think of Claude as exploring a path: a narrow bridge with cliffs needs specific guardrails (low freedom)

while an open field allows many routes (high freedom).

└── assets/ - Files used in output (templates

icons

**Low freedom (specific scripts

few parameters)**: Use when operations are fragile and error-prone