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

your-skill-name — скилл для Claude Code: что делает и как установить

Шаблонный скилл от Grafana для создания инструкций агентам с PromQL-примерами и разметкой по спецификации Agent Skills.

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

Что делает 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-code
npx skills add grafana/skills --skill template -a claude-code

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

~/.claude/skills/template/SKILL.md

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

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

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

admin Скилл для работы с аккаунтом Grafana Cloud: создаёт стеки, выдаёт токены сервисных аккаунтов, настраивает SSO и RBAC. CX Codex +1 4 200установок plugin-bundle-size Помогает уменьшить размер входного файла module.js в плагинах приложений Grafana через React.lazy и разделение чанков в Webpack. CX Codex +1 4 200установок admission-control Помогает писать валидаторы и мутаторы для приложений на grafana-app-sdk: проверка и правка ресурсов до сохранения в Kubernetes. CX Codex +1 4 200установок grafana-scenes Скилл для сборки страниц плагинов Grafana на фреймворке @grafana/scenes: панели, переменные, drilldown-навигация. CX Codex +1 4 200установок prometheus-cardinality-troubleshooter Диагностирует активные проблемы с кардинальностью Prometheus: рост памяти, медленные запросы, ошибки приёма метрик и всплески счёта. CX Codex +1 3 800установок skill-authoring Помогает писать и проверять SKILL.md по рубрике из четырёх критериев, которую использует CI-гейт grafana/skills. Пригодится, когда скилл не срабатывает или не проходит ревью. CX Codex +1 3 800установок prometheus-label-strategy Помогает спроектировать схему меток Prometheus, оценить кардинальность и убрать лишние лейблы в коде приложения или таргетах сбора до отправки в хранилище. CX Codex +1 3 800установок k6-perf-test-website Разворачивает гибридные нагрузочные тесты сайта на k6, связывает протокольные сценарии с проверками в браузере и следит за нагрузкой генератора. CX Codex +1 3 300установок

Похожие

prometheus-grafana devops-skills Скилл помогает агенту поднять сбор метрик в Prometheus, писать запросы PromQL и собирать панели Grafana. Пригодится, когда в проект нужно добавить мониторинг. CX Codex +1 449установок promql-cli samber Скилл учит агента гонять PromQL через CLI promql-cli: instant- и range-запросы, поиск метрик, вывод таблицей, CSV, JSON или графиком. CX Codex +1 4 400установок cost-export ruvnet Выгружает телеметрию расходов агента в формате Prometheus textfile или отправляет JSON через вебхук для внешнего мониторинга. CX Codex +1 681установок grafana-dashboards Seth Hobson Скилл помогает создавать Grafana-дашборды для метрик систем и приложений. Подойдёт для мониторинга, SLO и операционных интерфейсов наблюдаемости. CX Codex 13 097установок slo-implementation Seth Hobson Помогает задать измеримые цели надёжности, считать запас ошибок и настраивать оповещения. Пригодится, когда нужно отслеживать доступность и задержку сервиса. CX Codex 10 400установок dashboard-builder affaan-m Скилл помогает создавать рабочие дашборды для Grafana и SigNoz на основе вопросов дежурного инженера, а не случайного списка метрик. CX Codex +1 4 800установок

Рядом в теме «Настройка агента: память, контекст, субагенты»

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

Вопросы о 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

Смотрите также

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

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