Find agent skills by outcome

return False

Frontmatter must be a YAML dictionary

return False

SKILL.md not found

Writing & Content

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

content

return False

No YAML frontmatter found

Follow this style: type(scope): brief description

then detailed explanation.

Here is a sensible default format

but use your best judgment:

For skills where output quality depends on seeing examples

provide input/output pairs:

Productivity

For complex tasks

break operations into clear

Use these patterns when skills need to produce consistent

high-quality output.

Productivity

For tasks with branching logic

guide Claude through decision points:

When creating a new skill from scratch

always run the init_skill.py script:

Writing & Content

2. Plan reusable skill contents (scripts

references

- Use cases: Templates

images

- 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

Files not intended to be loaded into context

but rather used within the output Claude produces.

Coding & Debugging

- Use cases: Database schemas

API documentation

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

include grep search patterns in SKILL.md

- Benefits: Keeps SKILL.md lean

loaded only when Claude determines it's needed

- Frontmatter (YAML): Contains name and description fields. These are the only fields that Claude re...

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

PromptBeginner5 minmarkdownQuality: 30

- Examples: references/finance.md for financial schemas

references/mnda.md for company NDA template

- Benefits: Token efficient

deterministic

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

icons

Low freedom (specific scripts

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