skill-creator

skill-creator is a meta-skill that provides guidance for creating effective skills — modular, self-contained packages that extend an agent's capabilities with specialized knowledge, workflows, and tool integrations. It addresses the problem of authoring skills that trigger reliably and stay context-efficient, explaining the anatomy of a skill (a required SKILL.md with YAML frontmatter plus optional bundled scripts, references, and assets) and the quality bar for the name and description that determine when a skill is used.

The skill teaches the progressive-disclosure design principle — a three-level loading system where metadata is always in context, the SKILL.md body loads when the skill triggers, and bundled resources load only as needed — and walks through a structured creation process: understanding the skill with concrete usage examples, planning the reusable contents (deciding which workflows warrant scripts, which knowledge belongs in references, and which files belong as assets), and iterating. It distinguishes scripts (deterministic, token-efficient executable code), references (documentation loaded on demand, with grep-pattern guidance for large files), and assets (files used in output such as templates, fonts, and boilerplate). Bundled helper scripts — init_skill.py, package_skill.py, and quick_validate.py — support scaffolding, packaging, and validation.

The target users are skill authors and developers who want to build or refine skills, whether creating from scratch or improving an existing one. It is a documentation-and-tooling skill (with a LICENSE.txt) whose value is the authoring methodology plus the Python utilities for initializing, validating, and packaging a skill directory.