К основному содержанию
скилл CX Codex

create-skill · coco-research — скилл для Claude Code: что делает и как установить

Скилл create-skill помогает проектировать скиллы для ИИ-агентов: объясняет структуру каталогов, разметку SKILL.md и правила формулирования триггеров в описании.

MIT ★ 328 обновлён 2026-10-29

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add coco-research/coco --skill create-skill -a claude-code
Открыть на GitHub

Что делает create-skill

Скилл проводит разработчика через четыре стадии подготовки собственного навыка: сбор требований, проектирование метаданных, написание инструкций и проверку качества. Внутри заложены правила оформления SKILL.md: ограничение имени до 64 символов, лимит описания в 1024 знака и запрет раздувать основной документ длиннее 500 строк. Подробные примеры и справочники выносятся в отдельные файлы reference.md или examples.md с глубиной ссылок в один уровень.

Каталог ~/.cursor/skills-cursor/ трогать нельзя: он зарезервирован под системные скиллы самого редактора. Для пользовательских решений скилл предлагает разделение на персональные пути в домашней папке и проектные каталоги внутри репозитория.

Какие задачи решает

  • спроектировать архитектуру нового скилла для агента с нуля
  • составить описание с чёткими условиями срабатывания триггеров
  • структурировать каталоги с кодом, шаблонами и примерами
  • проверить готовый файл SKILL.md по чек-листу требований

Примеры запросов агенту

  • Помоги составить SKILL.md для проверки пулреквестов по стандартам команды
  • Спроектируй скилл для миграций базы данных с исполняемыми скриптами
  • Проверь структуру и описание для моего нового скилла

Как установить create-skill

1Через Skills CLI (Vercel)

npx skills add coco-research/coco --skill create-skill -a claude-code

2Вручную: положить файлы

~/.claude/skills/create-skill/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/create-skill/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о create-skill

Как установить create-skill в Claude Code?

Выполните команду npx skills add coco-research/coco --skill create-skill -a claude-code в терминале. Файл скилла также можно положить вручную по пути ~/.claude/skills/create-skill/SKILL.md.

Что делает скилл create-skill?

Он задаёт наводящие вопросы о задаче, помогает определить уровень свободы действий агента и генерирует готовую структуру файлов для навыка.

Какие ограничения налагаются на описание скилла?

Поле description должно быть от третьего лица, содержать максимум 1024 знака и явно перечислять сценарии, когда агенту нужно активировать этот навык.

Исходный текст

SKILL.md · MIT
---
name: create-skill
description: Guides users through creating effective Agent Skills for Cursor. Use when the user wants to create, write, or author a new skill, or asks about skill structure, best practices, or SKILL.md format.
---
# Creating Skills in Cursor

This skill guides you through creating effective Agent Skills for Cursor. Skills are markdown files that teach the agent how to perform specific tasks: reviewing PRs using team standards, generating commit messages in a preferred format, querying database schemas, or any specialized workflow.

## Before You Begin: Gather Requirements

Before creating a skill, gather essential information from the user about:

1. **Purpose and scope**: What specific task or workflow should this skill help with?
2. **Target location**: Should this be a personal skill (~/.cursor/skills/) or project skill (.cursor/skills/)?
3. **Trigger scenarios**: When should the agent automatically apply this skill?
4. **Key domain knowledge**: What specialized information does the agent need that it wouldn't already know?
5. **Output format preferences**: Are there specific templates, formats, or styles required?
6. **Existing patterns**: Are there existing examples or conventions to follow?

### Inferring from Context

If you have previous conversation context, infer the skill from what was discussed. You can create skills based on workflows, patterns, or domain knowledge that emerged in the conversation.

### Gathering Additional Information

If you need clarification, use the AskQuestion tool when available:

```
Example AskQuestion usage:
- "Where should this skill be stored?" with options like ["Personal (~/.cursor/skills/)", "Project (.cursor/skills/)"]
- "Should this skill include executable scripts?" with options like ["Yes", "No"]
```

If the AskQuestion tool is not available, ask these questions conversationally.

---

## Skill File Structure

### Directory Layout

Skills are stored as directories containing a `SKILL.md` file:

```
skill-name/
├── SKILL.md              # Required - main instructions
├── reference.md          # Optional - detailed documentation
├── examples.md           # Optional - usage examples
└── scripts/              # Optional - utility scripts
    ├── validate.py
    └── helper.sh
```

### Storage Locations

| Type | Path | Scope |
|------|------|-------|
| Personal | ~/.cursor/skills/skill-name/ | Available across all your projects |
| Project | .cursor/skills/skill-name/ | Shared with anyone using the repository |

**IMPORTANT**: Never create skills in `~/.cursor/skills-cursor/`. This directory is reserved for Cursor's internal built-in skills and is managed automatically by the system.

### SKILL.md Structure

Every skill requires a `SKILL.md` file with YAML frontmatter and markdown body:

```markdown
---
name: your-skill-name
description: Brief description of what this skill does and when to use it
---

# Your Skill Name

## Instructions
Clear, step-by-step guidance for the agent.

## Examples
Concrete examples of using this skill.
```

### Required Metadata Fields

| Field | Requirements | Purpose |
|-------|--------------|---------|
| `name` | Max 64 chars, lowercase letters/numbers/hyphens only | Unique identifier for the skill |
| `description` | Max 1024 chars, non-empty | Helps agent decide when to apply the skill |

---

## Writing Effective Descriptions

The description is **critical** for skill discovery. The agent uses it to decide when to apply your skill.

### Description Best Practices

1. **Write in third person** (the description is injected into the system prompt):
   - Good: "Processes Excel files and generates reports"
   - Avoid: "I can help you process Excel files"
   - Avoid: "You can use this to process Excel files"

2. **Be specific and include trigger terms**:
   - Good: "Extract text and tables from PDF files, fill forms, merge documents. Use when working with PDF files or when the user mentions PDFs, forms, or document extraction."
   - Vague: "Helps with documents"

3. **Include both WHAT and WHEN**:
   - WHAT: What the skill does (specific capabilities)
   - WHEN: When the agent should use it (trigger scenarios)

---

## Core Authoring Principles

### 1. Concise is Key

The context window is shared with conversation history, other skills, and requests. Every token competes for space.

**Default assumption**: The agent is already very smart. Only add context it doesn't already have.

### 2. Keep SKILL.md Under 500 Lines

For optimal performance, the main SKILL.md file should be concise. Use progressive disclosure for detailed content.

### 3. Progressive Disclosure

Put essential information in SKILL.md; detailed reference material in separate files that the agent reads only when needed.

**Keep references one level deep** - link directly from SKILL.md to reference files. Deeply nested references may result in partial reads.

### 4. Set Appropriate Degrees of Freedom

| Freedom Level | When to Use | Example |
|---------------|-------------|---------|
| **High** (text instructions) | Multiple valid approaches, context-dependent | Code review guidelines |
| **Medium** (pseudocode/templates) | Preferred pattern with acceptable variation | Report generation |
| **Low** (specific scripts) | Fragile operations, consistency critical | Database migrations |

---

## Common Patterns

### Template Pattern

Provide output format templates for consistent results.

### Examples Pattern

For skills where output quality depends on seeing examples, provide concrete input/output pairs.

### Workflow Pattern

Break complex operations into clear steps with checklists.

### Feedback Loop Pattern

For quality-critical tasks, implement validation loops.

---

## Skill Creation Workflow

### Phase 1: Discovery
Gather purpose, location, triggers, requirements, existing patterns.

### Phase 2: Design
Draft name, description, outline sections, identify supporting files.

### Phase 3: Implementation
Create directory, write SKILL.md, create reference files and scripts.

### Phase 4: Verification
Check line count, description specificity, terminology consistency, file references.

---

## Summary Checklist

### Core Quality
- [ ] Description is specific and includes key terms
- [ ] Description includes both WHAT and WHEN
- [ ] Written in third person
- [ ] SKILL.md body is under 500 lines
- [ ] Consistent terminology throughout
- [ ] Examples are concrete, not abstract

### Structure
- [ ] File references are one level deep
- [ ] Progressive disclosure used appropriately
- [ ] Workflows have clear steps
- [ ] No time-sensitive information

© coco-research · MIT · coco-research/coco

Похожие скиллы

Все скиллы по теме «Настройка агента: память, контекст, субагенты» →

Сначала — create-skill от других авторов.

create-skill NeoLabHQ Скилл create-skill для Claude Code, Codex, Cursor и других агентов, который ведёт через процесс написания нового скилла по методике TDD. Сначала субагент проваливает тест без документа, потом скилл пишется под конкретные нарушения. CX Codex +1 1 300установок create-skill siviter-xyz Скилл create-skill для Claude Code помогает создавать и обновлять скиллы для ИИ-агентов. Он подключается к таким просьбам и ведёт по структуре файлов и правилам проектирования. CX Codex +1 2 800установок create-skill SethGammon Скилл create-skill интервьюирует разработчика и упаковывает повторяющийся сценарий в готовый SKILL.md с проверкой на реальном коде проекта. CX Codex +1 ★ 937звёзд репо create-skill aeonfun Скилл create-skill берёт описание в одну строку и собирает из него готовый скилл: разбирает запрос, проверяет дубликаты, ищет документацию по API и открывает PR. CX Codex +1 ★ 797звёзд репо create-skill Samarth Gupta Скилл create-skill для Claude Code помогает проектировать и собирать скиллы и слэш-команды, уточняя задачу и сценарии запуска. CX Codex +1 ★ 276звёзд репо convex-create-component convex Скилл convex-create-component для Claude Code и Codex создаёт переиспользуемые Convex-компоненты с изолированными таблицами и чётким API. Выделяет backend-логику в отдельный модуль, владеющий своими данными. CX Codex +1 138 900установок recipe-create-meet-space официальный googleworkspace Скилл recipe-create-meet-space для Google Workspace в Claude Code автоматизирует создание конференции Meet и отправку ссылки по email. Требует предварительно загруженные скиллы gws-meet и gws-gmail. CX Codex +1 31 000установок create-payment-credential stripe Скилл create-payment-credential для Claude Code, который достаёт платёжные реквизиты из кошелька Link и доводит покупку до конца. Работает на Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI и OpenCode. CX Codex +1 27 200установок create-auth better-auth Скилл create-auth проводит агента через планирование и настройку аутентификации в TypeScript/JavaScript-проекте на Better Auth: от сканирования кода до страниц входа. CX Codex +1 15 300установок create-game-assets gamedev-skills Скилл create-game-assets для Claude Code планирует, генерирует и проверяет игровую графику. Он запускается при создании арта, исправлении прозрачности или подготовке спрайтов. CX Codex +1 13 900установок create-prd phuryn Скилл create-prd для Claude Code помогает написать компактный, готовый к решениям Product Requirements Document по шаблону из восьми разделов: резюме, контакты, контекст, цели, сегменты рынка, ценность по JTBD, решение и релиз. CX Codex +1 11 300установок

Из того же набора82

Весь набор →
database-architect Субагент database-architect помогает спроектировать схему данных, выбрать архитектуру БД и подготовить план миграции. Вызывайте его при работе с моделями данных, масштабированием или микросервисами. CX Codex ★ 328звёзд репо tailwind-patterns Скилл tailwind-patterns помогает настраивать Tailwind CSS v4 через CSS, собирать адаптивные макеты и проектировать дизайн-токены. Пригодится и при переносе проекта с v3. CX Codex +1 ★ 328звёзд репо c4-architecture Скилл c4-architecture генерирует архитектурную документацию по модели C4: контекст системы, контейнеры, компоненты и деплоймент в формате Mermaid. CX Codex +1 ★ 328звёзд репо create-subagent Скилл create-subagent помогает создавать изолированных субагентов с готовыми системными промптами для ревью кода, отладки и работы с данными. CX Codex +1 ★ 328звёзд репо ultra-think Скилл ultra-think для Claude Code разбирает архитектурные развилки с четырёх сторон, сравнивает подходы и выдаёт одну рекомендацию. CX Codex +1 ★ 328звёзд репо generate-tests Скилл generate-tests пишет тесты для файла, модуля или компонента, сначала определяя фреймворк и конвенции проекта. CX Codex +1 ★ 328звёзд репо m0-handoff Скилл m0-handoff сохраняет состояние сессии в STATE.md и локальный демон M0, чтобы продолжить работу после сжатия контекста или в другой сессии. CX Codex +1 ★ 328звёзд репо goal Хранит активную цель проекта в .goal.md, чтобы агент продолжал работу над задачей между сессиями. CX Codex +1 ★ 328звёзд репо

Спонсоры проекта

Компании, которые помогают держать аналитику открытой