Skip to main content
skill CX Codex

skill-creator · capawesome-team — Claude Code skill: create and install

The skill-creator skill guides the creation of agent skills, from metadata checks to a structured SKILL.md. Use it for agent procedures, not general documentation.

MIT 147 installs ★ 56 updated 2026-10-20

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add capawesome-team/skills --skill skill-creator -a claude-code
Open on GitHub

What skill-creator does

skill-creator walks through building a skill that follows the agentskills.io spec. It covers naming and description rules, directory layout, and drafting SKILL.md. The workflow includes assets/skill-template.md, references/checklist.md, and scripts/validate-metadata.py for checking metadata.

The instructions place larger schemas and rule sets in references/, while small CLI tools belong in scripts/. Keep the main skill instructions below 500 lines. Metadata validation runs with python3; if the script reports an error, revise the fields and run the check again.

This workflow excludes README files, general documentation, and library code without agent procedures. That boundary matters: those tasks do not fit the skill’s authoring steps.

What it helps with

  • set up a new skill directory structure
  • write a skill description with negative triggers
  • validate a skill name and description
  • move long procedures into references/
  • check SKILL.md paths and content against a checklist

Example prompts for the agent

  • Create a skill for our release process and draft its SKILL.md.
  • Run scripts/validate-metadata.py on this skill’s metadata and fix any errors.
  • Split this long procedure between the main instructions and files in references/.

How to install skill-creator

1Skills CLI (Vercel)

npx skills add capawesome-team/skills --skill skill-creator -a claude-code

2Manually: put the files in place

~/.claude/skills/skill-creator/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/skill-creator/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about skill-creator

How do I install skill-creator in Claude Code?

Run npx skills add capawesome-team/skills --skill skill-creator -a claude-code. The skill file is at ~/.claude/skills/skill-creator/SKILL.md.

What does skill-creator do?

It guides the structure and content of an agent skill, including its SKILL.md and metadata checks. Its workflow also covers separating reference material and scripts.

Does skill-creator require Python?

Its metadata check runs python3 scripts/validate-metadata.py --name "[name]" --description "[description]". If validation fails, revise the fields based on the script output and run it again.

Source text

SKILL.md · MIT
---
name: skill-creator
description: Authors and structures professional-grade agent skills following the agentskills.io spec. Use when creating new skill directories, drafting procedural instructions, or optimizing metadata for discoverability. Don't use for general documentation, non-agentic library code, or README files.
metadata:
  author: capawesome-team
  source: https://github.com/capawesome-team/skills/tree/main/.claude/skills/skill-creator
---

# Skill Authoring Procedure

Follow these steps to generate a skill that adheres to the agentskills.io specification and progressive disclosure principles.

## Step 1: Initialize and Validate Metadata
1.  Define a unique `name`: 1-64 characters, lowercase, numbers, and single hyphens only.
2.  Draft a `description`: Max 1,024 characters, written in the third person, including negative triggers.
3.  **Execute Validation Script:** Run the validation script to ensure compliance before proceeding:
    `python3 scripts/validate-metadata.py --name "[name]" --description "[description]"`
4.  If the script returns an error, self-correct the metadata based on the `stderr` output and re-run until successful.

## Step 2: Structure the Directory
1.  Create the root directory using the validated `name`.
2.  Initialize the following subdirectories:
    *   `scripts/`: For tiny CLI tools and deterministic logic.
    *   `references/`: For flat (one-level deep) context like schemas or API docs.
    *   `assets/`: For output templates, JSON schemas, or static files.
3.  Ensure no human-centric files (README.md, INSTALLATION.md) are created.

## Step 3: Draft Core Logic (SKILL.md)
1.  Use the template in `assets/skill-template.md` as the starting point.
2.  Write all instructions in the **third-person imperative** (e.g., "Extract the text," "Run the build").
3.  **Enforce Progressive Disclosure:**
    *   Keep the main logic under 500 lines.
    *   If a procedure requires a large schema or complex rule set, move it to `references/`.
    *   Command the agent to read the specific file only when needed: *"Read references/api-spec.md to identify the correct endpoint."*

## Step 4: Identify and Bundle Scripts
1.  Identify "fragile" tasks (regex, complex parsing, or repetitive boilerplate).
2.  Outline a single-purpose script for the `scripts/` directory.
3.  Ensure the script uses standard output (stdout/stderr) to communicate success or failure to the agent.

## Step 5: Final Logic Validation
1.  Review the `SKILL.md` for "hallucination gaps" (points where the agent is forced to guess).
2.  Verify all file paths are **relative** and use forward slashes (`/`).
3.  Cross-reference the final output against `references/checklist.md`.

## Error Handling
*   **Metadata Failure:** If `scripts/validate-metadata.py` fails, identify the specific error (e.g., "STYLE ERROR") and rewrite the field to remove first/second person pronouns.
*   **Context Bloat:** If the draft exceeds 500 lines, extract the largest procedural block and move it to a file in `references/`.

© capawesome-team · MIT · capawesome-team/skills

Similar skills

All skills for Agent setup: memory, context, orchestration →

skill-creator by other authors comes first.

skill-creator official anthropics skill-creator is a Claude Code skill that creates and refines skills, then tests them with prompts, evaluations, and performance checks. CX Codex +1 414,180installs skill-creator openclaw skill-creator is a Claude Code skill that helps author, validate, and restructure SKILL.md files and resources when creating a skill or revising an existing one. CX Codex +1 6,700installs skill-creator official openai skill-creator is a Claude Code skill for creating and updating agent skills, organizing procedures, scripts, and documentation while keeping token overhead low. CX Codex +1 5,300installs skill-creator sickn33 skill-creator is a Claude Code skill for drafting and reviewing reusable skills. It supports skill authoring and packaging tasks. CX Codex +1 988installs skill-creator himself65 skill-creator — a skill that walks you through creating a new agent skill, fixing one that misbehaves, or scoring it against a rubric. Useful when a manual routine should become repeatable. CX Codex +1 3,300installs novel-creator mave99a novel-creator guides story writing through interactive RPG choices and compiles Markdown chapters into a finished EPUB ebook. CX Codex +1 776installs omero-integration K-Dense-AI omero-integration — a skill that lets your agent inventory and automate microscopy data on OMERO.server: object traversal, metadata export, import planning. CX Codex +1 2,100installs suede-release-linter JasonColapietro suede-release-linter lints a local release folder and scores how ready it is: missing files, thin metadata, artwork and stem trouble, split gaps, sample and rights blockers. CX Codex +1 ★ 121repo stars lamindb K-Dense-AI Keeps a LaminDB registry of biological datasets and models: artifact registration, schemas, Bionty annotation, metadata search. CX Codex +1 2,100installs happycapy-skill-creator happycapy-ai happycapy-skill-creator adapts existing skills from anthropics/skills for HappyCapy environments. It strips Docker dependencies and bundles the result into a .skill archive. CX Codex +1 ★ 138repo stars skill-creator-primer sammcj The skill-creator-primer Claude Code skill guides the creation, editing, and review of Agent Skills. It activates before work on any Agent Skill, including changes to its description, scripts, or references. CX Codex +1 ★ 173repo stars

From the same set32

The whole set →
ionic-appflow-migration ionic-appflow-migration walks the agent through moving an Ionic Appflow project to Capawesome Cloud: one-command organization import, then swapping the Live Update SDK. CX Codex +1 1,200installs capacitor-vue capacitor-vue guides agents through Vue 3 Composition API patterns, custom composables, and router deep linking for Capacitor mobile apps. CX Codex +1 1,200installs capacitor-platforms capacitor-platforms walks the agent through adding and configuring the Capawesome desktop platforms for Capacitor — Electron and Tauri. Useful when a web app needs to ship on macOS, Windows and Linux. CX Codex +1 1,100installs capgo-cloud-migration capgo-cloud-migration walks the agent through moving a Capacitor project from Capgo to Capawesome Cloud: it finds Capgo usage and swaps the plugin, config, channels and CI/CD. CX Codex +1 972installs capawesome-mcp Walks the agent through connecting an MCP client to the hosted Capawesome MCP server for documentation search and Capawesome Cloud API management. CX Codex +1 965installs capacitor-mcp Connects your MCP client to the hosted Capacitor MCP server by Capawesome. Gives the agent access to versioned Capacitor docs, plugin catalogs, and Ionic blog posts. CX Codex +1 905installs ionic-framework-mcp Connects your MCP client to the hosted Ionic Framework MCP server with official v8 and v9 documentation and framework examples. CX Codex +1 899installs capacitor-android-dex-optimization The capacitor-android-dex-optimization Claude Code skill configures R8 for a Capacitor Android app. It activates for a DEX optimization finding in Play Console, a startup crash after minification, or an R8 release-build failure. CX Codex +1 189installs

Project sponsors

Companies that keep this analytics open