skills.rest
compozy
compozyOFFICIAL
Explore all skills by this author →
Website𝕏@compozyaiGitHub

skill-writer

Generate and validate SKILL.md frontmatter for Claude Skill definitions.

2.5k|134|Updated Mar 28, 2026
Search Tags:#documentation#validation#best-practices#claude-code#frontmatter#skill-design#skill-writer
One-click install
npx skills add https://github.com/compozy/compozy --skill skill-writer-compozy
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: skill-writer
Source: https://github.com/compozy/compozy/tree/main/.agents/skills/skill-writer
Command: npx skills add https://github.com/compozy/compozy --skill skill-writer-compozy

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill guides users through creating well-formed Agent Skills for Claude Code, ensuring SKILL.md frontmatter, clear structure, and recoverable progressive disclosure.

Core Features & Use Cases

  • Frontmatter validation: Ensures the Skill's YAML frontmatter includes a valid name and description that match the directory and provide actionable triggers.
  • Structure guidance: Outlines the recommended multi-file layout (SKILL.md, references, scripts, assets) and how to reference advanced content.
  • Quality enforcement: Provides best practices for naming, concise descriptions, and progressive disclosure for complex Skills.
  • Use Cases: Use when creating a new Skill, updating SKILL.md, troubleshooting Skill discovery, or converting prompts into Skills.

Quick Start

Describe your Skill in a concise YAML frontmatter and create the initial SKILL.md using the template.

Frequently Asked Questions about skill-writer

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I create valid SKILL.md frontmatter for Claude Code?▼

Structure your Claude Skill using a multi-file layout with SKILL.md, references, scripts, and assets. This layout supports progressive disclosure, keeping the main file concise while referencing advanced content separately.

Why does my Claude Skill not show up during skill discovery?▼

Convert a prompt into a Skill by wrapping it in a SKILL.md file with correct YAML frontmatter. Ensure the name matches the directory, add an actionable description, and organize supporting scripts or references into separate files for progressive disclosure.

What is progressive disclosure when designing Claude Skills?▼

Progressive disclosure is a skill design practice that keeps SKILL.md concise by moving advanced content into separate references, scripts, and assets. This ensures the core definition loads efficiently while remaining extensible for complex tasks.

Can I include scripts and dependencies in my Claude Skill definition?▼

Yes, you can include scripts and dependencies in your Claude Skill. The skill-writer detects dependencies from scripts and lists components, ensuring they are properly referenced and validated within the SKILL.md structure.

Related Skills

Explore More Design & Creative Skills→
leonanpereirapintoleonanpereirapinto
1

skill-writer

Create validated SKILL.md files with matching directory names for Claude Code skills.

Community
Advanced
openproseopenprose
1.7k

open-prose

Validate OpenProse Skill Units with mandatory SKILL.md and YAML frontmatter metadata.

Official
Advanced
RytassRytass
6

skill-authoring

Create structured Claude Code skills with YAML frontmatter and Markdown templates.

Official
Basic
519lab519lab
2

thoth-agent-skill-authoring

Automate authoring and validation of SKILL.md frontmatter and structure for Thoth Agent.

Official
Advanced