Supporting Files via paths:

~12 min · skills, paths, supporting-files, templates

Level 0🌱 Novice

0 XP0/70 lessons0/11 achievements

0/120 XP to next level120 XP to go0% complete

Bundled context the Skill needs every time

The paths: field loads files into the Skill's context on every invocation. Use it for: reference checklists (OWASP, accessibility, brand guidelines), output templates, code snippets the Skill needs to know about, schemas it should validate against. Anything stable that the Skill should always have at hand.

Don't load entire codebases via paths: — the host has Read for that. paths: is for resources that belong to the Skill, not the surrounding project.

Code

Paths block + folder·yaml

# In SKILL.md frontmatter
paths:
  - checklists/owasp-top10.md
  - checklists/wcag-2.2.md
  - templates/finding.md
  - schemas/openapi.yaml

Folder layout·text

.claude/skills/security-audit/
├── SKILL.md
├── checklists/
│   ├── owasp-top10.md
│   └── wcag-2.2.md
├── templates/
│   └── finding.md
└── schemas/
    └── openapi.yaml

External links

Skill paths reference

Exercise

Add a real reference file to one of your Skills via paths: (a checklist, a brand-voice doc, an output template). Verify the Skill uses it. Note how the output changed once the reference was in scope.

Progress

Progress is local-only — sign in to sync across devices.

← PreviousThe Markdown Body — Clear, Concrete, Bounded Next →Scripts — Determinism Inside a Skill

Spotted a bug or have feedback on this page?Report an Issue

Comments 0

🔔 Reply notifications (sign in)

No comments yet — be the first.