skill-creator

Progressive disclosure is a skill architecture design pattern that organizes content into a 3-level loading system: Level 1 metadata, Level 2 instructions, and Level 3 resources. You need it when designing Claude Skills to keep context lean, scalable, and easy to maintain across projects.

To design a Claude Skill, start by writing a lean SKILL.md with frontmatter to define Level 1 metadata. Then, add Level 2 instructions and optional Level 3 resources like references, scripts, and assets in recommended directories to structure the skill architecture.

Yes, this skill design approach uses a progressive-disclosure workflow with structured templates and clear roles for directories. It applies when planning new skills, organizing skill architecture, or writing skill content across projects, ensuring skills remain scalable and easy to extend.

The best way to structure Claude Skill directories is using recommended folders like references, scripts, and assets with clear roles. This structured template approach keeps content lean and context-efficient by separating Level 2 instructions from Level 3 resources.

Your Claude Skill architecture becomes hard to maintain when it lacks a disciplined progressive-disclosure model. Without a 3-level loading system separating metadata, instructions, and resources, content grows unmanageable and consumes excessive context.

Yes, you need to write a SKILL.md file to create a new skill. Start with a lean SKILL.md containing frontmatter for Level 1 metadata, then add optional references and scripts as needed to complete the skill architecture.