skills.rest
talesofai
talesofaiOFFICIAL
Explore all skills by this author →
WebsiteGitHub

skill-authoring

Create and validate Claude Code Skills scaffolds with YAML frontmatter.

1|Updated Jan 9, 2026
Search Tags:#automation#validation#yaml-frontmatter#project-structure#skill-design#skill-templates#cc-skills
One-click install
npx skills add https://github.com/talesofai/bot-agent --skill skill-authoring-talesofai
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: skill-authoring
Source: https://github.com/talesofai/bot-agent/tree/main/.claude/skills/skill-authoring
Command: npx skills add https://github.com/talesofai/bot-agent --skill skill-authoring-talesofai

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) and assets (resource) components.

What problem does it solve?

This Skill automates the design, scaffolding, and validation of Claude Code Skills (CC Skills), ensuring consistent structure and YAML frontmatter across projects.

Core Features & Use Cases

  • Create skill scaffolds under .claude/skills/<skill-name>/ with SKILL.md
  • Validate YAML frontmatter (name, description) and enforce lowercase slug naming
  • Provide templates and references for quick skill authoring
  • Offer a reusable validation script (scripts/validate_skill.sh) to ensure correctness

Quick Start

Create a new skill directory under .claude/skills/ and add SKILL.md with frontmatter. Use the provided template in assets/skill-template/SKILL.md as a starting point. Run scripts/validate_skill.sh <skill-dir> to verify structure and frontmatter.

Frequently Asked Questions about skill-authoring

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

FAQPage Schema
How do I create a Claude Code Skill scaffold with proper YAML frontmatter?▼

To create a Claude Code Skill scaffold, generate a directory under .claude/skills/<skill-name>/ and add a SKILL.md file with YAML frontmatter containing only name and description fields, using the provided template as a starting point.

What does YAML frontmatter validation require for CC Skills?▼

YAML frontmatter validation for CC Skills requires strictly enforcing lowercase slug naming for the skill directory and ensuring the frontmatter contains only the name and description fields, verified via a dedicated validation script.

How do I validate the project structure of a new skill before deploying it?▼

You validate a skill's project structure by running the reusable scripts/validate_skill.sh script against the skill directory, which checks for correct frontmatter formatting and structural compliance.

Can I use custom metadata fields in SKILL.md frontmatter when designing skills?▼

No, the skill authoring process strictly enforces YAML frontmatter to contain only the name and description fields, rejecting custom metadata to maintain consistent structure across all CC Skills projects.

What is the best way to organize supporting scripts and references for a skill?▼

The best way to organize supporting components is to place executable validation logic in a scripts directory and reference materials in a references directory within the .claude/skills/<skill-name>/ scaffold.

Why does my skill validation fail when the directory name contains uppercase letters?▼

Skill validation fails because the process enforces lowercase slug format for skill naming, requiring the directory name under .claude/skills/ to be entirely lowercase to pass the validation script checks.

Related Skills

Explore More Software Engineering Skills→
enbiyagoralenbiyagoral
2

new-skill

Generate a standardized SKILL.md and directory scaffold for Claude Code skills.

Community
Intermediate
SkillsCatalogSkillsCatalog
1

skill-validator

Validate agent skill directories against the SKILL.md specification.

Official
Advanced
otrebuotrebu
4

skill-creator

Create standardized Claude Skill scaffolds with YAML frontmatter validation.

Community
Intermediate
ajoslinajoslin
24

skill-creator

Automate Skill scaffolding, validation, and packaging with template generation and executable scripts.

Community
Advanced