skill-writer

Create validated Skill Units with SKILL.md frontmatter and directory structure.

33|1|Updated Jun 21, 2024
One-click install
npx skills add https://github.com/wzhchin/config --skill skill-writer-wzhchin
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: skill-writer
Source: https://github.com/wzhchin/config/tree/main/opencode/skills/skill-writer
Command: npx skills add https://github.com/wzhchin/config --skill skill-writer-wzhchin

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps users create well-structured Agent Skills for Claude Code by guiding the correct frontmatter, directory layout, and validation steps, reducing discovery errors and misconfigurations.

Core Features & Use Cases

  • Guidance for defining Skill scope, placement (personal vs project), and file structure to ensure consistent Skill discovery.
  • Step-by-step instructions for SKILL.md frontmatter and content quality, including optional references/scripts/assets.
  • Progressive disclosure support through separate reference/examples files for advanced usage, troubleshooting, and extension.

Quick Start

Create a new Skill directory with SKILL.md frontmatter and follow the steps to structure, validate, and test the Skill.

Frequently Asked Questions about skill-writer

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

FAQPage Schema
How do I create a well-structured Claude Skill with valid frontmatter?

To create a Claude Skill, define a SKILL.md file with required frontmatter fields like name and description, then structure directory layout and validate the YAML to ensure proper skill discovery.

What is progressive disclosure in Claude Skill structure?

Progressive disclosure in skill structure separates advanced examples and troubleshooting into distinct reference files, keeping the main SKILL.md concise while supporting extended usage and validation steps.

How do I validate a SKILL.md file for Claude Code discovery?

Validating a SKILL.md file involves checking the overall YAML structure, ensuring required frontmatter fields like name and description are present, and verifying optional components and dependencies conform to the expected skill structure.

Does Claude Code skill structure support optional scripts and assets?

Yes, Claude Code skill structure supports optional references, scripts, and assets. These components are defined alongside required frontmatter fields and managed through progressive disclosure in separate files.

What's the best way to organize personal vs project Claude Skills?

Organizing personal vs project Claude Skills requires defining skill scope and placement correctly, following the directory layout guidance to ensure consistent file structure and reliable skill discovery across different contexts.