create-skill · coco-research — скилл для Claude Code: что делает и как установить
Скилл create-skill помогает проектировать скиллы для ИИ-агентов: объясняет структуру каталогов, разметку SKILL.md и правила формулирования триггеров в описании.
MIT ★ 328 обновлён 2026-10-29
npx skills add coco-research/coco --skill create-skill -a claude-codeЧто делает 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-code2Вручную: положить файлы
~/.claude/skills/create-skill/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/create-skill/
1Через Skills CLI (Vercel)
npx skills add coco-research/coco --skill create-skill -a codex2Вручную: положить файлы
.agents/skills/create-skill/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add coco-research/coco --skill create-skill -a cursor2Вручную: положить файлы
.cursor/skills/create-skill/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install coco-research/coco adapters/cursor/skills/create-skill2Вручную: положить файлы
.github/skills/create-skill/SKILL.md1Через Skills CLI (Vercel)
npx skills add coco-research/coco --skill create-skill -a gemini-cli2Командой платформы
gemini skills install https://github.com/coco-research/coco --path adapters/cursor/skills/create-skillВручную: положить файлы
.devin/skills/create-skill/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Claude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в 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 от других авторов.