skill-writer

Contract-first Claude skill design establishes a contract-driven structure for creating SKILL.md files, ensuring consistent frontmatter fields and lean JSONL execution blocks before adding detailed guidance.

To write a SKILL.md file using progressive disclosure, keep the JSONL behavior block lean by moving heavy guidance into linked support docs, ensuring rapid iteration and safe defaults.

Yes, you can apply contract-first design to refactor existing AI skills by enforcing explicit frontmatter fields and restructuring prompts into a lean JSONL behavior block.

The best way to structure JSONL-first prompts is to define a lean JSONL behavior block within the SKILL.md file, enforcing explicit frontmatter and linking to external support docs for heavy guidance.

Your SKILL.md file needs explicit frontmatter fields to enforce consistent contract-driven structure and safe defaults, ensuring the AI skill behaves predictably during rapid iteration.

You should move heavy guidance out of your SKILL.md file into linked support docs when applying progressive disclosure, keeping the core JSONL behavior block lean for faster processing.