skills.rest
saintgo7
saintgo7COMMUNITY
Explore all skills by this author →
GitHub

claude-code-skill-authoring

Scaffold Claude Code skill directories with valid SKILL.md frontmatter and trigger phrases.

Updated Apr 4, 2026
Search Tags:#scaffolding#skill authoring#YAML frontmatter#trigger phrases#CI validation#REGISTRY
One-click install
npx skills add https://github.com/saintgo7/claude-skills --skill claude-code-skill-authoring
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: claude-code-skill-authoring
Source: https://github.com/saintgo7/claude-skills/tree/main/claude-code-skill-authoring
Command: npx skills add https://github.com/saintgo7/claude-skills --skill claude-code-skill-authoring

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

The claude-code-skill-authoring skill solves the problem of creating Claude Code skills that are hard to discover, fail validation, or don’t trigger reliably due to inconsistent SKILL.md formatting.

Core Features & Use Cases

  • Correct SKILL.md formatting: Ensures the required YAML frontmatter includes valid name/description and stays within constraints for CI parsing.
  • Reliable trigger phrases: Guides writing 5–10 natural invocation phrases in the description so Claude Code can activate the skill.
  • Deterministic scaffolding and validation: Provides a scaffold workflow and checks for REGISTRY ↔ directory consistency during install/uninstall.

Quick Start

Run the scaffold command to create a new skill folder and a starter SKILL.md, then fill in trigger phrases, a core command, and a troubleshooting section.

Frequently Asked Questions about claude-code-skill-authoring

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

FAQPage Schema
How do I create a Claude Code skill that passes CI validation?▼

Skill authoring for Claude Code requires a SKILL.md file with valid YAML frontmatter, 5-10 trigger phrases in the description, and REGISTRY directory consistency to pass CI validation checks.

What is the correct YAML frontmatter format for a SKILL.md file?▼

YAML frontmatter in SKILL.md requires valid name and description fields satisfying parsing constraints so Claude Code can discover the skill and activate it reliably during execution.

How do I write trigger phrases for Claude Code skill activation?▼

Writing 5-10 natural invocation phrases in the SKILL.md description enables reliable Claude Code skill activation by matching how users naturally request tasks during conversations.

Does CI validation check REGISTRY and directory consistency for skills?▼

CI validation verifies REGISTRY and directory consistency during install and uninstall operations to ensure dependable Claude Code skill discovery and activation without conflicts.

What's the best way to scaffold a new Claude Code skill directory?▼

Scaffolding a new Claude Code skill directory involves running the scaffold command to generate the folder structure and starter SKILL.md, then adding trigger phrases, core commands, and troubleshooting sections.

Why does my Claude Code skill fail to trigger during execution?▼

Skills fail to trigger due to inconsistent SKILL.md formatting, missing trigger phrases, or YAML frontmatter violating naming constraints, which prevents reliable parsing and activation by Claude Code.

Related Skills

Explore More Software Engineering Skills→
ahandselahandsel
1

sync-skill-allowlist

Synchronize skill entries in project settings against repository SKILL.md files.

Community
Intermediate
tiankong0101-bytetiankong0101-byte

skill-indexer

Rebuild skill registry indexes and validate SKILL.md metadata.

Community
Intermediate
Hey-DigaHey-Diga
16

create-skill

Guide authors to compose compliant SKILL.md files and scaffold Claude skill directories.

Official
Intermediate
peteanderson80peteanderson80

skill-creator

Generate and validate Codex Skill scaffolds with SKILL.md templates and scripts.

Community
Advanced