Create New Skills — Claude Code skill: what it does, how to install
Guides the creation of custom Agent Skills for Claude Code. It designs SKILL.md files, configures activation triggers, and organizes helper scripts.
npx skills add disler/claude-code-hooks-multi-agent-observability --skill meta-skill -a claude-codeWhat Create New Skills does
This skill guides developers through drafting and packaging new agent capabilities. It asks for the intended task and triggers, builds the directory in .claude/skills/, and writes a standardized SKILL.md. The design relies on three-tier progressive disclosure: the agent keeps only metadata in memory, loads detailed instructions when triggered, and accesses external scripts only when executing specific steps.
Frontmatter rules impose hard limits. The skill name cannot exceed 64 characters, while the description caps at 1024 characters. Clear trigger keywords in the description are mandatory, because vague summaries cause the model to ignore the skill entirely. Projects targeting Claude Code can also use the allowed-tools field to restrict tool access to commands like Grep or Glob.
Complex routines stay in secondary files rather than bloating the main document. The workflow organizes scripts inside scripts/, templates in templates/, and expects Python helpers to declare dependencies inline using PEP 723.
What it helps with
- Scaffold a valid
SKILL.mdfile and skill directory structure - Draft trigger descriptions within the 1024-character frontmatter limit
- Package helper scripts with PEP 723 inline dependencies
- Restrict agent tool permissions using
allowed-tools
Example prompts for the agent
- Help me create a new skill for processing PDF files
- Scaffold a personal skill in
~/.claude/skills/for database analytics - Package video processing scripts into a reusable skill with examples
How to install Create New Skills
1Skills CLI (Vercel)
npx skills add disler/claude-code-hooks-multi-agent-observability --skill meta-skill -a claude-code2Manually: put the files in place
~/.claude/skills/meta-skill/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/meta-skill/
1Skills CLI (Vercel)
npx skills add disler/claude-code-hooks-multi-agent-observability --skill meta-skill -a codex2Manually: put the files in place
.agents/skills/meta-skill/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add disler/claude-code-hooks-multi-agent-observability --skill meta-skill -a cursor2Manually: put the files in place
.cursor/skills/meta-skill/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install disler/claude-code-hooks-multi-agent-observability meta-skill2Manually: put the files in place
.github/skills/meta-skill/SKILL.md1Skills CLI (Vercel)
npx skills add disler/claude-code-hooks-multi-agent-observability --skill meta-skill -a gemini-cli2Platform CLI
gemini skills install https://github.com/disler/claude-code-hooks-multi-agent-observability --path .claude/skills/meta-skillManually: put the files in place
.devin/skills/meta-skill/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add disler/claude-code-hooks-multi-agent-observability --skill meta-skill -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 Create New Skills
How do I install Create New Skills in Claude Code?
Run npx skills add disler/claude-code-hooks-multi-agent-observability --skill meta-skill -a claude-code in your terminal. The skill file will be placed at ~/.claude/skills/meta-skill/SKILL.md.
What does Create New Skills do?
It walks you through designing a new agent skill from scratch. The skill scaffolds the SKILL.md structure, sets up YAML frontmatter with proper limits, and organizes scripts and examples.
What is the difference between project and personal skills?
Skills placed in .claude/skills/ commit to git and stay shared with your project team. Personal skills reside in ~/.claude/skills/ and remain private to your local environment.
