Find agent skills by outcome

- 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

Coding & Debugging

Medium freedom (pseudocode or scripts with parameters): Use when a preferred pattern exists

some variation is acceptable

Writing & Content

The context window is a public good. Skills share the context window with everything else Claude needs: system prompt

conversation history

High freedom (text-based instructions): Use when multiple approaches are valid

decisions depend on context

Productivity

specialized knowledge

workflows

4. Bundled resources - Scripts

references

3. Domain expertise - Company-specific knowledge

schemas

Skills are modular

self-contained packages that extend Claude's capabilities by providing

Skill Creator

---

Productivity

description: Guide for creating effective skills. This skill should be used when users want to create a new skill (or update an existing skill) that extends Claude's capabilities with specialized knowledge

workflows

implied_action: The subject is in a still moment of deep contemplation

gazing at something unseen off-camera.

use_case: Training AI models for emotional portrait generation

cinematic lighting styles