# skill-authoring

Помогает писать и проверять SKILL.md по рубрике из четырёх критериев, которую использует CI-гейт grafana/skills. Пригодится, когда скилл не срабатывает или не проходит ревью.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 3800 установок · ★ 290
- Автор: grafana
- Лицензия: Apache-2.0 · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/grafana/skills/tree/HEAD/skills/grafana-core/skill-authoring/SKILL.md
- Обновлён: 2026-10-25
- HTML: https://affpapa.org/nevibecode/skills/skill-authoring

## Что делает

Скилл ведёт через каноническую структуру: YAML-фронтматтер, тело, папки `references/`, `scripts/` и `assets/`. Отдельно разбирается приём «pushy description» — описание, которое заставляет агента подхватывать скилл, и трёхуровневая модель progressive disclosure. Внутри есть дерево решений для нового скилла: выбрать плагин-папку, оценить длину тела, написать описание, собрать тело под рубрику, зарегистрировать в манифестах маркетплейса.

Рубрика — четыре критерия по шкале 0–3: conciseness, actionability, workflow clarity, progressive disclosure. CI отклоняет PR, если тронутый SKILL.md набирает меньше 75. Оценку ставит LLM-судья, и разброс между прогонами достигает 7–10 баллов, поэтому автор советует выпускать только после трёх подряд локальных 100.

Локальная проверка идёт через `./scripts/lint-skills.sh skills/<plugin>/<your-skill>` и `tessl skill review --json skills/<plugin>/<your-skill>`. Для запуска `--optimize` нужна авторизация в Tessl. Если скилл задуман как routing-документ, `--optimize` может втянуть бандл обратно в SKILL.md — такой файл придётся править руками.

## Требования
- Работает с: Grafana

## Установка

### Claude Code (родная платформа)

1. **Через Skills CLI (Vercel)**
```bash
npx skills add grafana/skills --skill skill-authoring -a claude-code
```

2. **Вручную: положить файлы**
- Файл: `~/.claude/skills/skill-authoring/SKILL.md` — Папка скилла целиком; для одного проекта — .claude/skills/skill-authoring/

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add grafana/skills --skill skill-authoring -a codex
```

2. **Вручную: положить файлы**
- Файл: `.agents/skills/skill-authoring/SKILL.md` — Для всех проектов — ~/.agents/skills/

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add grafana/skills --skill skill-authoring -a cursor
```

2. **Вручную: положить файлы**
- Файл: `.cursor/skills/skill-authoring/SKILL.md` — Cursor читает и .agents/skills/, и .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install grafana/skills skill-authoring
```

2. **Вручную: положить файлы**
- Файл: `.github/skills/skill-authoring/SKILL.md`

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add grafana/skills --skill skill-authoring -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/grafana/skills --path skills/grafana-core/skill-authoring
```

### Windsurf (Devin Desktop)

**Вручную: положить файлы**
- Файл: `.devin/skills/skill-authoring/SKILL.md` — Старый путь .windsurf/skills/ тоже читается

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add grafana/skills --skill skill-authoring -a opencode
```

### Claude.ai

**Claude.ai**
- Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/grafana/skills/tree/HEAD/skills/grafana-core/skill-authoring/SKILL.md

## Когда брать
- написать описание скилла, которое агент действительно подхватит
- разбить длинный SKILL.md на бандл с references
- поднять оценку Tessl выше порога слияния 75
- разобрать вербальные замечания судьи по каждому критерию
- проверить скилл линтером до коммита

## Примеры запросов агенту
- этот скилл не срабатывает, посмотри описание и почини триггеры
- Tessl поставил 72 — разбери замечания и подними оценку
- разбей этот SKILL.md на references, тело слишком длинное

## Похожие
- [validate-skills](https://affpapa.org/nevibecode/skills/validate-skills.md) — скилл · 7300 установок
- [open-knowledge-write-skill](https://affpapa.org/nevibecode/skills/open-knowledge-write-skill.md) — скилл · 6900 установок
- [create-skill](https://affpapa.org/nevibecode/skills/neolabhq-create-skill.md) — скилл · 1200 установок
- [hermes-agent-skill-authoring](https://affpapa.org/nevibecode/skills/hermes-agent-skill-authoring.md) — скилл · 518 установок
- [quarto-authoring](https://affpapa.org/nevibecode/skills/quarto-authoring.md) — скилл · 1400 установок
- [dashfix](https://affpapa.org/nevibecode/skills/dashfix.md) — скилл · 2300 установок

Из того же набора: [grafana/skills](https://affpapa.org/nevibecode/by/grafana/skills.md) — 47 карточек

_Часть страницы не вошла по размеру — она есть в HTML-версии._

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md