skill-writer

Create and validate SKILL.md definitions for Claude Code skills.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill eliminates the guesswork from Skill development, ensuring your creations work reliably across all projects.

Core Features & Use Cases

  • Skill Development: Creates precise SKILL.md files with proper YAML frontmatter and validation.

Quick Start

Create a new skill for analyzing TypeScript code patterns.

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 compliant SKILL.md file for a Claude Code skill?

Skill Writer automates SKILL.md creation with validation for naming conventions, YAML frontmatter, and structure. It enforces naming rules (max 64 chars, lowercase alphanumeric and hyphens), description length caps (≤1024 chars), and ensures files stay under 500 lines while following the Skill Writer guidelines.

What validation does the skill authoring process enforce?

Skill Writer validates skill names against reserved terms like 'anthropic' and 'claude', checks description length limits, enforces project-agnostic flags, detects anti-bash patterns, and verifies one-level file references. It applies pattern-based templates for read-only, documentation, multi-file refactoring, and workflow skills.

Can I use Skill Writer to update an existing skill definition?

Yes, Skill Writer supports both creation and updates of SKILL.md definitions. It applies the same validation and best practices whether you're authoring a new skill or modifying an existing one to maintain compliance with Skill Writer guidelines.

What file formats and templates does Skill Writer support?

Skill Writer supports YAML frontmatter and SKILL.md markdown files. It includes pattern-based templates for simple read-only skills, documentation skills, multi-file refactoring workflows, and workflow skills to accelerate authoring while ensuring structural compliance.

What are the naming requirements for Claude Code skills?

Skill names must be 64 characters or fewer, use only lowercase alphanumeric characters and hyphens, and cannot contain reserved terms like 'anthropic' or 'claude'. Skill Writer enforces these conventions automatically during the creation and validation process.

Does Skill Writer check for best practices in skill definitions?

Yes, Skill Writer applies AI-guided best practices during authoring, including anti-bash pattern detection, file reference structure validation, and compliance checks against the Skill Writer guidelines to ensure reliable, professional-grade skill definitions.