# Create New Skills

Guides the creation of custom Agent Skills for Claude Code. It designs SKILL.md files, configures activation triggers, and organizes helper scripts.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · ★ 1556
- Author: disler
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/disler/claude-code-hooks-multi-agent-observability/tree/HEAD/.claude/skills/meta-skill/SKILL.md
- Updated: 2026-02-08
- HTML: https://affpapa.org/en/nevibecode/skills/create-new-skills

## What it 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.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add disler/claude-code-hooks-multi-agent-observability --skill meta-skill -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/meta-skill/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/meta-skill/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add disler/claude-code-hooks-multi-agent-observability --skill meta-skill -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/meta-skill/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add disler/claude-code-hooks-multi-agent-observability --skill meta-skill -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/meta-skill/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install disler/claude-code-hooks-multi-agent-observability meta-skill
```

2. **Manually: put the files in place**
- File: `.github/skills/meta-skill/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add disler/claude-code-hooks-multi-agent-observability --skill meta-skill -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/disler/claude-code-hooks-multi-agent-observability --path .claude/skills/meta-skill
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/meta-skill/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add disler/claude-code-hooks-multi-agent-observability --skill meta-skill -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/disler/claude-code-hooks-multi-agent-observability/tree/HEAD/.claude/skills/meta-skill/SKILL.md

## When to use it
- Scaffold a valid `SKILL.md` file 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
- 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

## Similar
- [setup-matt-pocock-skills](https://affpapa.org/en/nevibecode/skills/setup-matt-pocock-skills.md) — skill · 1052851 installs
- [ask-matt](https://affpapa.org/en/nevibecode/skills/ask-matt.md) — skill · 766587 installs
- [to-tickets](https://affpapa.org/en/nevibecode/skills/to-tickets.md) — skill · 711230 installs
- [writing-plans](https://affpapa.org/en/nevibecode/skills/writing-plans.md) — skill · 282859 installs
- [caveman-review](https://affpapa.org/en/nevibecode/skills/caveman-review.md) — skill · 411800 installs
- [caveman-compress](https://affpapa.org/en/nevibecode/skills/caveman-compress.md) — skill · 411500 installs

From the same set: [disler/claude-code-hooks-multi-agent-observability](https://affpapa.org/en/nevibecode/by/disler/claude-code-hooks-multi-agent-observability.md) — 4 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md