Engineering
skill-creator avatar

skill-creator

A framework for building modular, reusable agent skills. Provides guidelines for structuring SKILL.md, bundled scripts, references, and assets to extend Claude's capabilities.

Introduction

The skill-creator is a foundational development tool designed for users looking to build, maintain, and refine specialized skills for Claude. By leveraging a modular architecture, this skill helps developers move beyond general-purpose prompting toward creating durable, domain-specific procedural knowledge. It is ideal for software engineers, automation architects, and technical power users who need to codify repeatable workflows, integrate external tools, or manage company-specific schemas and business logic within the Claude Code ecosystem.

  • Standardized structure for skills requiring a SKILL.md file, YAML metadata, and optional bundled resources.
  • Guidance on managing context through a three-level loading system: metadata, main instructions, and on-demand external references.
  • Best practices for resource organization, including separation of deterministic scripts (Python/Bash) and static assets (templates/boilerplate).
  • Logic for implementing Progressive Disclosure to keep context windows lean while maintaining access to deep technical documentation.
  • Methodology for decomposing complex tasks into concrete, replicable examples to ensure high-quality skill triggers.

When using the skill-creator, you should prioritize clarity in your YAML frontmatter to ensure precise trigger matching. Use the skill to bundle your internal APIs, design tokens, or compliance checklists into a portable format that can be shared across teams or repositories. Remember to avoid duplicating information between the core instructions and external reference files; keep essential procedural steps in the SKILL.md and move large technical schemas, API docs, or policy documents into the references/ directory. For repeatable technical tasks, such as generating infrastructure as code or boilerplate testing files, utilize the scripts/ directory to provide Claude with reliable, executable logic. Always define clear thresholds for when a skill should be invoked to prevent overlapping contexts and ensure that the agent remains focused on the specific domain or task it was built to handle.

Repository Stats

Stars
2,839
Forks
329
Open Issues
7
Language
Python
Default Branch
main
Sync Status
Idle
Last Synced
Apr 29, 2026, 05:24 AM
View on GitHub