skill-creator · gentleman-programming — скилл для Claude Code: создание скиллов
Скилл skill-creator для Claude Code создаёт новые скиллы по спецификации Agent Skills. Оформляет повторяемые паттерны, проектные правила и сложные рабочие процессы.
Apache-2.0 171 установок ★ 678 обновлён 2026-03-28
npx skills add Gentleman-Programming/Gentleman-Skills --skill skill-creator -a claude-codeЧто делает skill-creator
Скилл помогает спроектировать новый скилл: понять, нужен ли он для повторяемого паттерна, выбрать имя и собрать структуру skills/{skill-name}/. Основной файл SKILL.md содержит frontmatter, условия применения, критические правила, короткие примеры, команды и ресурсы.
Он также задаёт выбор между assets/ для шаблонов, схем и конфигураций и references/ для локальной документации. После создания скилл нужно зарегистрировать в AGENTS.md, а перед этим проверить имя, повторяемость паттерна и полноту frontmatter. Правила с prowler-* и обязательным Apache-2.0 относятся к Prowler, поэтому для другого проекта их нужно сверить.
Скилл использует инструменты Read, Edit, Write, Glob, Grep, Bash, WebFetch, WebSearch и Task. Он не предназначен для разовой задачи или тривиального правила.
Какие задачи решает
- создать структуру нового скилла
- описать триггеры и правила для агента
- выбрать между
assets/иreferences/ - добавить скилл в
AGENTS.md - проверить frontmatter перед созданием
Примеры запросов агенту
- Создай скилл для повторяемого паттерна работы с API и добавь его в
AGENTS.md. - Сформируй
SKILL.mdс frontmatter, критическими правилами, примерами кода и разделом команд. - Проверь, нужен ли здесь новый скилл или достаточно ссылки на существующую документацию.
Как установить skill-creator
1Через Skills CLI (Vercel)
npx skills add Gentleman-Programming/Gentleman-Skills --skill skill-creator -a claude-code2Вручную: положить файлы
~/.claude/skills/skill-creator/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/skill-creator/
1Через Skills CLI (Vercel)
npx skills add Gentleman-Programming/Gentleman-Skills --skill skill-creator -a codex2Вручную: положить файлы
.agents/skills/skill-creator/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add Gentleman-Programming/Gentleman-Skills --skill skill-creator -a cursor2Вручную: положить файлы
.cursor/skills/skill-creator/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install Gentleman-Programming/Gentleman-Skills curated/skill-creator/SKILL.md2Вручную: положить файлы
.github/skills/skill-creator/SKILL.md1Через Skills CLI (Vercel)
npx skills add Gentleman-Programming/Gentleman-Skills --skill skill-creator -a gemini-cli2Командой платформы
gemini skills install https://github.com/Gentleman-Programming/Gentleman-Skills --path curated/skill-creatorВручную: положить файлы
.devin/skills/skill-creator/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add Gentleman-Programming/Gentleman-Skills --skill skill-creator -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о skill-creator
Как установить skill-creator в Claude Code?
Выполните npx skills add Gentleman-Programming/Gentleman-Skills --skill skill-creator -a claude-code, затем проверьте файл ~/.claude/skills/skill-creator/SKILL.md.
Что делает skill-creator?
Он помогает создавать скиллы по спецификации Agent Skills: выбрать структуру, оформить SKILL.md, добавить ресурсы и зарегистрировать скилл в AGENTS.md.
Что хранить в assets/, а что в references/?
В assets/ размещают шаблоны, JSON-схемы и конфигурации. references/ предназначен для ссылок на локальные файлы документации, а не на веб-страницы.
Исходный текст
SKILL.md · Apache-2.0
---
name: skill-creator
description: >
Creates new AI agent skills following the Agent Skills spec.
Trigger: When user asks to create a new skill, add agent instructions, or document patterns for AI.
license: Apache-2.0
metadata:
author: gentleman-programming
version: "1.0"
allowed-tools: Read, Edit, Write, Glob, Grep, Bash, WebFetch, WebSearch, Task
---
## When to Create a Skill
Create a skill when:
- A pattern is used repeatedly and AI needs guidance
- Project-specific conventions differ from generic best practices
- Complex workflows need step-by-step instructions
- Decision trees help AI choose the right approach
**Don't create a skill when:**
- Documentation already exists (create a reference instead)
- Pattern is trivial or self-explanatory
- It's a one-off task
---
## Skill Structure
```
skills/{skill-name}/
├── SKILL.md # Required - main skill file
├── assets/ # Optional - templates, schemas, examples
│ ├── template.py
│ └── schema.json
└── references/ # Optional - links to local docs
└── docs.md # Points to docs/developer-guide/*.mdx
```
---
## SKILL.md Template
```markdown
---
name: {skill-name}
description: >
{One-line description of what this skill does}.
Trigger: {When the AI should load this skill}.
license: Apache-2.0
metadata:
author: gentleman-programming
version: "1.0"
---
## When to Use
{Bullet points of when to use this skill}
## Critical Patterns
{The most important rules - what AI MUST know}
## Code Examples
{Minimal, focused examples}
## Commands
```bash
{Common commands}
```
## Resources
- **Templates**: See [assets/](assets/) for {description}
- **Documentation**: See [references/](references/) for local docs
```
---
## Naming Conventions
| Type | Pattern | Examples |
|------|---------|----------|
| Generic skill | `{technology}` | `pytest`, `playwright`, `typescript` |
| Prowler-specific | `prowler-{component}` | `prowler-api`, `prowler-ui`, `prowler-sdk-check` |
| Testing skill | `prowler-test-{component}` | `prowler-test-sdk`, `prowler-test-api` |
| Workflow skill | `{action}-{target}` | `skill-creator`, `jira-task` |
---
## Decision: assets/ vs references/
```
Need code templates? → assets/
Need JSON schemas? → assets/
Need example configs? → assets/
Link to existing docs? → references/
Link to external guides? → references/ (with local path)
```
**Key Rule**: `references/` should point to LOCAL files (`docs/developer-guide/*.mdx`), not web URLs.
---
## Decision: Prowler-Specific vs Generic
```
Patterns apply to ANY project? → Generic skill (e.g., pytest, typescript)
Patterns are Prowler-specific? → prowler-{name} skill
Generic skill needs Prowler info? → Add references/ pointing to Prowler docs
```
---
## Frontmatter Fields
| Field | Required | Description |
|-------|----------|-------------|
| `name` | Yes | Skill identifier (lowercase, hyphens) |
| `description` | Yes | What + Trigger in one block |
| `license` | Yes | Always `Apache-2.0` for Prowler |
| `metadata.author` | Yes | `gentleman-programming` |
| `metadata.version` | Yes | Semantic version as string |
---
## Content Guidelines
### DO
- Start with the most critical patterns
- Use tables for decision trees
- Keep code examples minimal and focused
- Include Commands section with copy-paste commands
### DON'T
- Add Keywords section (agent searches frontmatter, not body)
- Duplicate content from existing docs (reference instead)
- Include lengthy explanations (link to docs)
- Add troubleshooting sections (keep focused)
- Use web URLs in references (use local paths)
---
## Registering the Skill
After creating the skill, add it to `AGENTS.md`:
```markdown
| `{skill-name}` | {Description} | [SKILL.md](skills/{skill-name}/SKILL.md) |
```
---
## Checklist Before Creating
- [ ] Skill doesn't already exist (check `skills/`)
- [ ] Pattern is reusable (not one-off)
- [ ] Name follows conventions
- [ ] Frontmatter is complete (description includes trigger keywords)
- [ ] Critical patterns are clear
- [ ] Code examples are minimal
- [ ] Commands section exists
- [ ] Added to AGENTS.md
## Resources
- **Templates**: See [assets/](assets/) for SKILL.md template
© gentleman-programming · Apache-2.0 · Gentleman-Programming/Gentleman-Skills
Похожие скиллы
Все скиллы по теме «Настройка агента: память, контекст, субагенты» →Сначала — skill-creator от других авторов.