your-skill-name — скилл для Claude Code: что делает и как установить
Шаблонный скилл от Grafana для создания инструкций агентам с PromQL-примерами и разметкой по спецификации Agent Skills.
npx skills add grafana/skills --skill your-skill-name -a claude-code
npx skills add grafana/skills --skill template -a claude-codeЧто делает your-skill-name
Репозиторий grafana/skills предлагает этот шаблон для оформления новых навыков под Claude Code и другие среды. Структура SKILL.md разбита на разделы: краткий обзор, ключевые концепции, типовые конфигурации и практические рекомендации. Автор советует избегать общих объяснений программирования и сосредоточиться на специфике Grafana, иллюстрируя правила примерами вроде PromQL-запроса rate(http_requests_total[5m]).
Файл рассчитан на спецификацию Agent Skills и содержит метаданные: название, лицензию Apache-2.0, перечень инструментов allowed-tools и совместимость. Для Claude Code предусмотрены поля user-invocable и disable-model-invocation. Описание навыка ограничено 1024 знаками, а объём самого SKILL.md рекомендовано держать в пределах 500 строк. Детальные справочники предписано выносить в директорию references/. Если раздуть основной файл длинными руководствами, агенту станет труднее удерживать рабочий контекст.
Какие задачи решает
- подготовить структуру нового скилла по спецификации Agent Skills
- ограничить размер файла SKILL.md выносом документации в references/
- настроить отображение команды в меню Claude Code через user-invocable
- задать предварительно одобренные инструменты в allowed-tools
Примеры запросов агенту
- Создай новый скилл для мониторинга Grafana на основе шаблона your-skill-name
- Заполни секцию Key Concepts примерами PromQL-запросов по образцу из SKILL.md
- Вынеси подробное руководство из SKILL.md в папку references/
Как установить your-skill-name
1Через Skills CLI (Vercel)
npx skills add grafana/skills --skill your-skill-name -a claude-codenpx skills add grafana/skills --skill template -a claude-code2Вручную: положить файлы
~/.claude/skills/template/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/template/
1Через Skills CLI (Vercel)
npx skills add grafana/skills --skill template -a codex2Вручную: положить файлы
.agents/skills/template/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add grafana/skills --skill template -a cursor2Вручную: положить файлы
.cursor/skills/template/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install grafana/skills template2Вручную: положить файлы
.github/skills/template/SKILL.md1Через Skills CLI (Vercel)
npx skills add grafana/skills --skill template -a gemini-cli2Командой платформы
gemini skills install https://github.com/grafana/skills --path templateВручную: положить файлы
.devin/skills/template/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add grafana/skills --skill template -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Из того же набора47
Похожие
Рядом в теме «Настройка агента: память, контекст, субагенты»
Все скиллы по теме «Настройка агента: память, контекст, субагенты» →Вопросы о your-skill-name
Как установить your-skill-name в Claude Code?
Выполните в терминале команду npx skills add grafana/skills --skill your-skill-name -a claude-code.
Зачем нужен your-skill-name?
Это базовый шаблон скилла от Grafana, задающий структуру инструкций для ИИ-агентов. Он помогает авторам оформлять PromQL-запросы, рекомендации и метаданные.
Какой максимальный размер у описания и файла SKILL.md?
Поле description ограничено 1024 символами. Сам файл SKILL.md рекомендовано держать в пределах 500 строк, вынося большие объёмы текста в каталог references/.
Исходный текст
SKILL.md · Apache-2.0
--- name: your-skill-name description: > Clear description of what this skill does and when to use it. Use when the user asks about X or wants to work with Y. Include specific trigger phrases so agents auto-load it correctly. Max 1024 characters. # ── Agent Skills spec fields (https://agentskills.io/specification) ────────── # license: Apache-2.0 # Recommended for open-source skills # compatibility: Claude Code, Cursor # Only if skill has specific env requirements (max 500 chars) # metadata: # Custom key-value pairs # author: grafana-labs # allowed-tools: Bash(git:*) Read # Pre-approved tools (experimental) # ── Claude Code extension fields (not part of the spec) ────────────────────── # user-invocable: true # Show in / menu (default: true) # disable-model-invocation: false # Prevent agent auto-loading (default: false) --- # Your Skill Title ## Overview Brief introduction to what this skill covers. Focus on Grafana-specific knowledge — don't explain general programming concepts the AI already knows well. ## Key Concepts Document the important concepts, patterns, or syntax. Code examples are more effective than prose. ```promql # Example rate(http_requests_total[5m]) ``` ## Common Patterns Describe the most frequently needed patterns or configurations. ## Best Practices - List recommendations specific to this skill's domain - Include common pitfalls to avoid --- > **Keep SKILL.md under 500 lines.** Move detailed reference material to `references/` files and > link to them from here. See [agentskills.io/specification](https://agentskills.io/specification).
© grafana · Apache-2.0 · grafana/skills