skill-writer

Create Claude Code Skills with valid SKILL.md YAML frontmatter.

Updated May 15, 2026
One-click install
npx skills add https://github.com/JBonfim/skill-developer --skill skill-writer-jbonfim
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: skill-writer
Source: https://github.com/JBonfim/skill-developer/tree/main/.agents/skills/skill-writer
Command: npx skills add https://github.com/JBonfim/skill-developer --skill skill-writer-jbonfim

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill prevents wasted time when creating new Claude Code Skills by ensuring the required SKILL.md frontmatter and structure are correct for reliable discovery and activation.

Core Features & Use Cases

  • Skill scope and structure guidance: Helps you define one clear capability per Skill and choose the right location (personal vs project).
  • Correct SKILL.md frontmatter: Ensures the YAML includes required fields (name, description) and follows naming/length rules.
  • High-discoverability descriptions and content layout: Guides you to write descriptions with the right triggers and to organize instructions with actionable sections.
  • Validation and troubleshooting: Provides a checklist to verify file placement, YAML validity, and prompt-discovery issues.
  • Optional supporting files: Shows when to add references, examples, scripts, or templates to support progressive disclosure.

Quick Start

Tell the AI what capability you want (for example, “Help me create a Skill for generating Conventional Commit messages from my diffs”) and ask it to draft the SKILL.md with correct frontmatter and step-by-step instructions.

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 Claude Code skill with correct YAML frontmatter?

To create a Claude Code skill, draft a SKILL.md file with valid YAML frontmatter containing required name and description fields, following strict naming and length rules to ensure proper skill discoverability and activation.

Why does my Claude Code skill not show up during prompt discovery?

Skill discovery fails when the SKILL.md YAML frontmatter is invalid, naming rules are broken, or file placement is incorrect. Validate your YAML structure, check description length limits, and verify the file is in the correct personal or project directory.

What is the correct SKILL.md structure for authoring Claude Code skills?

A correct SKILL.md structure requires YAML frontmatter with name and description fields, followed by clear instruction content organized into practical, actionable sections that define one specific capability per skill for reliable activation.

Can I convert an existing prompt into a validated Claude Code skill package?

Yes, you can convert existing prompts into a validated skill package by wrapping them in a SKILL.md file with proper YAML frontmatter and organizing the prompt instructions into clear, actionable sections that fit the skill authoring requirements.

When should I add supporting files to a Claude Code skill?

Add optional supporting files like references, examples, scripts, or templates to your Claude Code skill when you need to support progressive disclosure and provide additional context that cannot fit cleanly within the main SKILL.md instructions.