skill-writer

Creates and validates SKILL.md frontmatter for Claude Code skills.

31|6|Updated Dec 13, 2025
One-click install
npx skills add https://github.com/WaterplanAI/agentic-config --skill skill-writer-waterplanai
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: skill-writer
Source: https://github.com/WaterplanAI/agentic-config/tree/main/core/skills/skill-writer
Command: npx skills add https://github.com/WaterplanAI/agentic-config --skill skill-writer-waterplanai

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill Writer helps authors create well-formed SKILL.md files and enforce best practices for Claude Code skills, reducing errors and onboarding time.

Core Features & Use Cases

  • Generate precise SKILL.md frontmatter and directory structure for new skills.
  • Validate naming conventions, field constraints (character limits, allowed characters, reserved words), and formatting.
  • Provide templates, examples, and one-level supporting files to accelerate skill creation and ensure compliance with standards.

Quick Start

Run the Skill Writer to scaffold a new Claude Code skill by creating the SKILL.md with proper frontmatter in .claude/skills/{name}/ and following 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 a SKILL.md file with proper frontmatter for Claude Code?

SKILL.md frontmatter defines metadata for Claude Code skills. Use the Skill Writer to generate a correctly formatted frontmatter template with required fields like name, description, and allowed-tools, then place it in .claude/skills/{name}/ to scaffold a new skill.

What validation rules apply to Claude Code skill naming and structure?

Claude Code skills must follow naming conventions, character limits, and reserved-word restrictions. The Skill Writer validates these constraints automatically, checking field formatting and ensuring one-level references to supporting files comply with skill standards.

Can I use templates to speed up skill development?

Yes. The Skill Writer provides templates and examples that accelerate skill creation by automating directory structure and frontmatter generation, reducing manual setup time and enforcing best practices across your skill projects.

Why should I validate my SKILL.md before publishing?

Validation catches structural errors, missing required fields, and formatting issues early. Running validation through the Skill Writer ensures your skill meets Claude Code standards and reduces deployment errors and user onboarding friction.

Does the Skill Writer work with existing skills or only new ones?

The Skill Writer scaffolds new skills and updates existing ones. It applies the same validation and frontmatter rules to both workflows, helping you maintain consistency across skill versions and migrations.