skill-creator

Guide construction of Claude skills with SKILL.md structure and YAML frontmatter.

Updated Nov 27, 2025
One-click install
npx skills add https://github.com/DevHammad0/physical-ai-robotics-textbook --skill skill-creator-devhammad0
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: skill-creator
Source: https://github.com/DevHammad0/physical-ai-robotics-textbook/tree/main/.claude/skills/skill-creator
Command: npx skills add https://github.com/DevHammad0/physical-ai-robotics-textbook --skill skill-creator-devhammad0

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

Creating effective AI skills can be challenging, requiring a deep understanding of structure, content, and best practices. This skill provides a comprehensive, step-by-step guide to design, develop, and package high-quality skills that seamlessly extend Claude's capabilities, ensuring consistency and efficiency.

Core Features & Use Cases

  • Structured Skill Design: Learn the anatomy of a skill, including SKILL.md, scripts/, references/, and assets/, to organize specialized knowledge and tools effectively.
  • Progressive Disclosure: Understand how skills manage context efficiently through a three-level loading system, optimizing for performance and relevance.
  • Automated Initialization & Packaging: Utilize provided scripts (init_skill.py, package_skill.py) to quickly scaffold new skills and validate/package them for distribution.
  • Use Case: An AI developer wants to create a new skill to integrate Claude with a proprietary API. This skill guides them through defining the problem, planning reusable resources (scripts for API calls, references for API docs), initializing the skill, and packaging it for deployment.

Quick Start

Using the skill-creator skill, explain the purpose of the references/ directory and provide an example of when to use it.

Frequently Asked Questions about skill-creator

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

FAQPage Schema
How do I create a Claude skill from scratch?

Creating a Claude skill involves defining YAML frontmatter with name and description, structuring a SKILL.md file following predefined patterns, and organizing optional scripts, references, and assets. The skill-creator guides you through each component, from planning reusable resources to packaging for deployment.

What's the purpose of the references directory in a skill?

The references/ directory stores domain documentation, API specifications, and contextual materials that Claude accesses during skill execution. Use it when you need to bundle external knowledge—such as API docs or technical specs—so Claude can reference them without reloading the full context on every call.

Can I automate skill packaging and validation?

Yes, skill-creator provides automated scripts including init_skill.py for scaffolding new skills and package_skill.py for validation and packaging. These scripts accelerate setup and ensure your skill meets structural and technical requirements before distribution.

How does progressive disclosure optimize skill context?

Skills manage context through a three-level loading system that loads metadata first, then core logic, then supplementary references on demand. This approach keeps performance high and ensures Claude receives only relevant information at each execution stage.

What metadata and structure do I need to package a skill for deployment?

A deployable skill requires YAML frontmatter specifying name and description, a SKILL.md body following one of the predefined patterns, and optional scripts and assets organized in dedicated directories. skill-creator validates this structure and prepares your skill for distribution.

Can I integrate my proprietary API into a Claude skill?

Yes, skills support tool integration through reusable scripts and bundled API references. Plan your API integration as a resource, store API documentation in references/, and use scripts to handle API calls, allowing Claude to invoke your proprietary system seamlessly.