skill-creator · capawesome-team — скилл для Claude Code: создание и установка
Скилл skill-creator помогает спроектировать папку нового скилла, написать SKILL.md и проверить метаданные. Используйте его для инструкций агенту, а не для обычной документации.
MIT 147 установок ★ 56 обновлён 2026-10-20
npx skills add capawesome-team/skills --skill skill-creator -a claude-codeЧто делает skill-creator
skill-creator ведёт по этапам создания скилла по спецификации agentskills.io: задаёт требования к имени и описанию, предлагает структуру каталогов и помогает подготовить SKILL.md. В процедуре есть шаблон assets/skill-template.md, чек-лист references/checklist.md и скрипт scripts/validate-metadata.py, который проверяет метаданные.
Скилл предлагает выносить большие схемы и сложные правила в references/, а небольшие CLI-инструменты — в scripts/. Основную логику инструкции следует удерживать короче 500 строк. Для проверки метаданных нужен python3; если проверка завершается ошибкой, процедура предписывает исправить поля и запустить её снова.
Скилл не предназначен для README, общей документации и кода библиотек без агентных инструкций. Это ограничение важно: для таких задач его процедура будет не к месту.
Какие задачи решает
- создать структуру каталогов нового скилла
- сформулировать описание скилла с негативными триггерами
- проверить имя и описание через скрипт
- разнести длинные инструкции по
references/ - проверить пути и содержание
SKILL.mdпо чек-листу
Примеры запросов агенту
- Создай скилл для нашего процесса релиза и подготовь
SKILL.md. - Проверь метаданные нового скилла командой
scripts/validate-metadata.pyи исправь ошибки. - Разбей длинную процедуру на основную инструкцию и материалы в
references/.
Как установить skill-creator
1Через Skills CLI (Vercel)
npx skills add capawesome-team/skills --skill skill-creator -a claude-code2Вручную: положить файлы
~/.claude/skills/skill-creator/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/skill-creator/
1Через Skills CLI (Vercel)
npx skills add capawesome-team/skills --skill skill-creator -a codex2Вручную: положить файлы
.agents/skills/skill-creator/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add capawesome-team/skills --skill skill-creator -a cursor2Вручную: положить файлы
.cursor/skills/skill-creator/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install capawesome-team/skills .claude/skills/skill-creator2Вручную: положить файлы
.github/skills/skill-creator/SKILL.md1Через Skills CLI (Vercel)
npx skills add capawesome-team/skills --skill skill-creator -a gemini-cli2Командой платформы
gemini skills install https://github.com/capawesome-team/skills --path .claude/skills/skill-creatorВручную: положить файлы
.devin/skills/skill-creator/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add capawesome-team/skills --skill skill-creator -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о skill-creator
Как установить skill-creator в Claude Code?
Выполните npx skills add capawesome-team/skills --skill skill-creator -a claude-code. Файл скилла находится по пути ~/.claude/skills/skill-creator/SKILL.md.
Что делает skill-creator?
Он помогает спроектировать структуру скилла, написать SKILL.md и проверить метаданные. Также процедура охватывает вынос справочных материалов и скриптов в отдельные каталоги.
Нужен ли Python для работы skill-creator?
Для проверки метаданных процедура запускает python3 scripts/validate-metadata.py --name "[name]" --description "[description]". При ошибке нужно исправить поля по сообщению скрипта и повторить проверку.
Исходный текст
SKILL.md · MIT
---
name: skill-creator
description: Authors and structures professional-grade agent skills following the agentskills.io spec. Use when creating new skill directories, drafting procedural instructions, or optimizing metadata for discoverability. Don't use for general documentation, non-agentic library code, or README files.
metadata:
author: capawesome-team
source: https://github.com/capawesome-team/skills/tree/main/.claude/skills/skill-creator
---
# Skill Authoring Procedure
Follow these steps to generate a skill that adheres to the agentskills.io specification and progressive disclosure principles.
## Step 1: Initialize and Validate Metadata
1. Define a unique `name`: 1-64 characters, lowercase, numbers, and single hyphens only.
2. Draft a `description`: Max 1,024 characters, written in the third person, including negative triggers.
3. **Execute Validation Script:** Run the validation script to ensure compliance before proceeding:
`python3 scripts/validate-metadata.py --name "[name]" --description "[description]"`
4. If the script returns an error, self-correct the metadata based on the `stderr` output and re-run until successful.
## Step 2: Structure the Directory
1. Create the root directory using the validated `name`.
2. Initialize the following subdirectories:
* `scripts/`: For tiny CLI tools and deterministic logic.
* `references/`: For flat (one-level deep) context like schemas or API docs.
* `assets/`: For output templates, JSON schemas, or static files.
3. Ensure no human-centric files (README.md, INSTALLATION.md) are created.
## Step 3: Draft Core Logic (SKILL.md)
1. Use the template in `assets/skill-template.md` as the starting point.
2. Write all instructions in the **third-person imperative** (e.g., "Extract the text," "Run the build").
3. **Enforce Progressive Disclosure:**
* Keep the main logic under 500 lines.
* If a procedure requires a large schema or complex rule set, move it to `references/`.
* Command the agent to read the specific file only when needed: *"Read references/api-spec.md to identify the correct endpoint."*
## Step 4: Identify and Bundle Scripts
1. Identify "fragile" tasks (regex, complex parsing, or repetitive boilerplate).
2. Outline a single-purpose script for the `scripts/` directory.
3. Ensure the script uses standard output (stdout/stderr) to communicate success or failure to the agent.
## Step 5: Final Logic Validation
1. Review the `SKILL.md` for "hallucination gaps" (points where the agent is forced to guess).
2. Verify all file paths are **relative** and use forward slashes (`/`).
3. Cross-reference the final output against `references/checklist.md`.
## Error Handling
* **Metadata Failure:** If `scripts/validate-metadata.py` fails, identify the specific error (e.g., "STYLE ERROR") and rewrite the field to remove first/second person pronouns.
* **Context Bloat:** If the draft exceeds 500 lines, extract the largest procedural block and move it to a file in `references/`.
© capawesome-team · MIT · capawesome-team/skills
Похожие скиллы
Все скиллы по теме «Настройка агента: память, контекст, субагенты» →Сначала — skill-creator от других авторов.