skill-creator

Scaffold standardized Claude Skill directories with Ruby scripts and frontmatter validation.

2|Updated Nov 27, 2017
One-click install
npx skills add https://github.com/tomoasleep/dotfiles --skill skill-creator-tomoasleep
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: skill-creator
Source: https://github.com/tomoasleep/dotfiles/tree/main/config/.claude/skills/skill-creator
Command: npx skills add https://github.com/tomoasleep/dotfiles --skill skill-creator-tomoasleep

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires fileutils, optparse, yaml, and includes scripts (resource) components.

What problem does it solve?

Creating cohesive, scalable Claude Skills quickly can be error-prone without a standard scaffold. This guide provides a structured, repeatable framework to bootstrap new Skills with consistent metadata, directories, and validation.

Core Features & Use Cases

  • A canonical Skill skeleton including SKILL.md with required frontmatter
  • Automatic initialization of directories: scripts/, references/, assets/
  • Built-in validation to ensure naming, frontmatter, and structure correctness
  • Step-by-step workflow to initialize, implement, and validate a Skill before deployment

Quick Start

  1. From the script runner, run ruby init_skill.rb <skill-name> to create a new skill directory.
  2. Edit <skill-name>/SKILL.md to fill in name and description in frontmatter, then provide body instructions.
  3. Run ruby validate_skill.rb <skill-path> to verify structure and frontmatter conformance.

Frequently Asked Questions about skill-creator

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

FAQPage Schema
How do I scaffold a new Claude Skill with the correct directory structure?

To scaffold a Claude Skill, run the Ruby script init_skill.rb with your desired skill name. This automatically generates a standardized directory structure including scripts/, references/, and assets/ subdirectories alongside a SKILL.md file with required frontmatter.

What is the standard directory structure required for a modular Claude Skill?

The standard Claude Skill structure includes a root SKILL.md file containing frontmatter and instructions, accompanied by three core subdirectories: scripts/ for execution logic, references/ for documentation, and assets/ for static files.

How do I validate Claude Skill frontmatter and structure before deployment?

You validate Claude Skill structure by running the Ruby script validate_skill.rb with the skill path. This built-in validation checks naming conventions, frontmatter rules, and directory structure to ensure consistent discovery and operation.

Do I need to install external Ruby gems to use this Claude Skill scaffolding tool?

No external Ruby gems are required. The scaffolding and validation scripts rely exclusively on the Ruby standard library, specifically utilizing built-in features like fileutils, optparse, and yaml to ensure zero-dependency operation.

What's the best way to ensure consistent metadata across multiple Claude Skills?

The best way to ensure consistent Claude Skill metadata is using an automated scaffolding framework that enforces frontmatter rules during initialization and validates structure before deployment, eliminating manual file creation errors.

Why does my Claude Skill fail validation after manual directory creation?

Manual creation often fails validation due to missing required frontmatter fields or incorrect directory naming. Using the init_skill.rb scaffold script ensures structural correctness and frontmatter compliance from the start.