skills.rest
leonanpereirapinto
leonanpereirapintoCOMMUNITY
Explore all skills by this author →
𝕏@leonanpereirapGitHub

skill-writer

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

1|Updated Mar 27, 2026
Search Tags:#templates#best-practices#claude-code#frontmatter#skill-creation#skill-discovery#markdown-guide
One-click install
npx skills add https://github.com/leonanpereirapinto/ai-utils --skill skill-writer-leonanpereirapinto
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: skill-writer
Source: https://github.com/leonanpereirapinto/ai-utils/tree/main/.claude/skills/skill-writter
Command: npx skills add https://github.com/leonanpereirapinto/ai-utils --skill skill-writer-leonanpereirapinto

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill guides users through creating well-structured Agent Skills for Claude Code, ensuring SKILL.md frontmatter is correct and Skill structure is consistent across projects.

Core Features & Use Cases

  • Validates frontmatter fields (name and description) and ensures the directory name matches the Skill ID.
  • Provides a template and step-by-step guidance to assemble multi-file Skills with optional references, scripts, and templates.
  • Assists in drafting high-quality Skill documentation that enables reliable discovery and activation in Claude Code.

Quick Start

Create a new Skill directory, add SKILL.md with correct frontmatter, and write clear, actionable instructions for Claude Code.

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 valid frontmatter?▼

To create a Claude Code Skill, define a clear purpose and add valid YAML frontmatter to a SKILL.md file, ensuring the directory name matches the Skill ID for proper activation and discovery.

What is the required structure for a multi-file Skill in Claude Code?▼

A multi-file Skill structure requires a main SKILL.md directory matching the frontmatter name, alongside optional references, scripts, and templates, with documented dependencies and safe defaults.

Why does my Claude Code Skill fail to activate during discovery?▼

Skill activation fails when the directory name does not match the frontmatter name, the YAML is invalid, or the documentation lacks concise, actionable usage guidelines for Claude Code.

Can I use markdown templates to guide Claude Skill creation?▼

Yes, you can use markdown templates to assemble multi-file Skills, validate frontmatter fields like name and description, and draft high-quality documentation for reliable discovery.

What's the best way to document dependencies in a SKILL.md file?▼

Document dependencies in a SKILL.md file by listing required components, specifying optional references, and establishing safe defaults while verifying YAML validity and defensible content.

Do I need to match my Skill directory name to the frontmatter ID?▼

Yes, you must match the Skill directory name to the frontmatter ID to apply a project-wide structure, ensure consistency, and enable reliable discovery within Claude Code.

Related Skills

Explore More Software Engineering Skills→
ldzhhxxldzhhxx
1

hermes-agent-skill-authoring

Create and validate SKILL.md files for the Hermes Agent repository.

Community
Intermediate
Hex-4Hex-4

plugin-settings

Manages Claude Code plugin settings via YAML frontmatter in .local.md files.

Community
Advanced
lucasfthlucasfth

llm-wiki

Ingest sources into an interlinked markdown wiki with YAML frontmatter and linting.

Community
Advanced
fabioc-alohafabioc-aloha
1

API Documentation Skill

Scaffold technical documentation projects with templates for API endpoints and guides.

Community
Intermediate