skill-create — Claude Code skill: what it does, how to install
Creates a new Agent Skill from a template with a ready SKILL.md and optional folders. Useful when starting a skill or checking its structure.
npx skills add SkillsCatalog/registry --skill skill-create -a claude-codeWhat skill-create does
This skill generates a new Agent Skill directory containing SKILL.md and README.md. The basic template includes those files, with-scripts adds scripts/main.py, and with-assets adds assets/.gitkeep as well. You can provide a name, description, and author.
Names must use lowercase letters and hyphens, begin with a letter, and stay within 1–64 characters. Existing directories are left untouched. Python 3.9+ is required; the skill uses Python’s standard library and has no external dependencies.
What it helps with
- create a new skill from a template
- generate a valid
SKILL.md - add
scriptsandassetsdirectories - set skill metadata such as description and author
- enforce skill naming rules
Example prompts for the agent
- Create a new skill named
pdf-tools. - Create
data-analyzerwith thewith-scriptstemplate. - Create
api-testerwith the description “Test REST APIs” and authoracme-corp.
How to install skill-create
1Skills CLI (Vercel)
npx skills add SkillsCatalog/registry --skill skill-create -a claude-code2Manually: put the files in place
~/.claude/skills/skill-create/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/skill-create/
1Skills CLI (Vercel)
npx skills add SkillsCatalog/registry --skill skill-create -a codex2Manually: put the files in place
.agents/skills/skill-create/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add SkillsCatalog/registry --skill skill-create -a cursor2Manually: put the files in place
.cursor/skills/skill-create/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install SkillsCatalog/registry skill-create2Manually: put the files in place
.github/skills/skill-create/SKILL.md1Skills CLI (Vercel)
npx skills add SkillsCatalog/registry --skill skill-create -a gemini-cli2Platform CLI
gemini skills install https://github.com/SkillsCatalog/registry --path skills/skill-createManually: put the files in place
.devin/skills/skill-create/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add SkillsCatalog/registry --skill skill-create -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about skill-create
How do I install skill-create in Claude Code?
Run npx skills add SkillsCatalog/registry --skill skill-create -a claude-code. The skill is then available at ~/.claude/skills/skill-create/SKILL.md.
What does skill-create do?
It builds an Agent Skill directory with SKILL.md and README.md, while the selected template can add scripts and assets.
What does skill-create require?
Python 3.9+ is required. It relies on the Python standard library and will not overwrite an existing directory.
Source text
SKILL.md · MIT
---
name: skill-create
description: Create new Agent Skills from templates with best-practice structure, pre-populated SKILL.md, and optional scripts/assets directories.
version: 1.0.0
license: MIT
author: "@anthropic-agent-skills"
tags:
- creation
- templates
- tooling
- development
---
## Instructions
Use this skill to create new Agent Skills from templates. It generates a properly structured skill directory with a valid SKILL.md file and optional scripts/assets folders.
### When to Use
- Starting a new skill from scratch
- Ensuring proper skill structure and naming
- Quickly prototyping new skill ideas
- Teaching others how to structure skills
### How to Use
Create a new skill with a name:
```
Create a new skill called "pdf-tools"
```
Create a skill with a specific template:
```
Create a new skill called "data-analyzer" using the with-scripts template
```
Available templates:
- **basic** - Just SKILL.md (default)
- **with-scripts** - SKILL.md + scripts directory
- **with-assets** - SKILL.md + scripts + assets directories
### Output
Creates a complete skill directory:
**Basic template:**
```
pdf-tools/
├── SKILL.md
└── README.md
```
**With-scripts template:**
```
pdf-tools/
├── SKILL.md
├── README.md
└── scripts/
└── main.py
```
**With-assets template:**
```
pdf-tools/
├── SKILL.md
├── README.md
├── scripts/
│ └── main.py
└── assets/
└── .gitkeep
```
## Examples
**Basic skill:**
```
User: Create a new skill called "code-formatter"
Agent: Creating skill "code-formatter" with basic template...
Created:
✓ code-formatter/SKILL.md
✓ code-formatter/README.md
Next steps:
1. Edit SKILL.md with your skill's instructions
2. Add any supporting files
3. Run skill-validator to check compliance
```
**Interactive mode:**
```
User: Create a new skill
Agent: I'll help you create a new skill.
Skill name: code-formatter
Description: Format code in various languages
Template: with-scripts
License: MIT
Creating...
✓ Created code-formatter with with-scripts template
```
**With metadata:**
```
User: Create a new skill called "api-tester" with description "Test REST APIs" and author "acme-corp"
Agent: Creating skill "api-tester"...
✓ Created with custom metadata:
- Description: Test REST APIs
- Author: acme-corp
- License: MIT (default)
```
## Limitations
- Skill names must be lowercase with hyphens only (1-64 chars)
- Names must start with a letter
- Will not overwrite existing directories
- Templates are minimal - intended as starting points
## Dependencies
- Python 3.9+
- No external dependencies (uses Python stdlib)
© @anthropic-agent-skills · MIT · SkillsCatalog/registry