Progressive Disclosure with Bundled Files

Keep SKILL.md short by moving detail into files loaded only when needed.

A skill is a folder, so it can carry more than SKILL.md. Reference material, long checklists, and examples live in sibling files that Claude opens only when the task actually needs them — this is progressive disclosure.

.claude/skills/pdf-forms/
  SKILL.md            # short: when to use, the high-level steps
  references/
    field-types.md    # opened only when mapping form fields
    examples.md       # opened only when the user wants a sample

In SKILL.md you point at these files by relative path and say when to read them. The top-level instructions stay scannable; the depth is one hop away for the cases that need it.