# skill-evaluation

Скилл skill-evaluation оценивает агентский скилл по методике, собранной из рекомендаций Anthropic для Claude Code и доклада Matt Pocock «How to Write Great Skills». Выдаёт скоркард по 4 осям с баллами 0–100 и ссылками на строки SKILL.md.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf (Devin Desktop), Claude.ai · ★ 141 у репозитория
- Автор: ft.ia.br
- Лицензия: Apache-2.0 · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/fabricioctelles/skills/tree/HEAD/skills/skill-evaluation/SKILL.md
- Обновлён: 2026-10-29
- Проверка безопасности: автоматическая, 2026-11-16 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/skills/skill-evaluation

## Что делает

Скилл прогоняет указанный SKILL.md по 18 критериям, сгруппированным в четыре оси: Trigger (как скилл вызывается), Structure (шаги, указатели на справку, потолок 500 строк), Steering (leading words, критерии завершения, раздел грабель) и Pruning (тест на удаление лишних фраз, дубли, устаревший материал). 14 критериев считаются всегда, ещё 4 — только для подходящих категорий из `references/categories.md`. Каждый балл сопровождается цитатой: файл, секция, строка.

Итог — взвешенный средний балл 0–100 и файл `<target>/EVALUATION.md` с разбором причин провала и списком правок по приоритету. Через параметр `compare` можно поставить два скилла рядом. Для сложных осей скилл сам подтягивает `references/mechanics.md`, где лежат определения leading words, deletion test и типов отказов.

Работает и без человека: в CI `scripts/score.py --fail-below 60` возвращает ненулевой код, если скилл набрал меньше порога. Тот же прогон можно повесить на PR, меняющий скиллы репозитория. Учитывайте, что порог 60 — флаг скрипта, а не встроенный в скилл дефолт.

## Установка

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

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

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

### Codex

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

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

### Cursor

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

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install fabricioctelles/skills skills/skill-evaluation
```

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

### Gemini CLI

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

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

### Windsurf (Devin Desktop)

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

### Claude.ai

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

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

## Когда брать
- проверить, сработает ли description скилла как триггер для модели
- найти пустые фразы в SKILL.md через deletion test
- получить балл 0–100 и разбор слабых мест перед публикацией скилла
- сравнить два скилла бок о бок
- загейтить изменения скиллов в PR через `--fail-below` в CI

## Примеры запросов агенту
- Оцени скилл в `skills/pdf-report/`
- Сделай скоркард для `~/.claude/skills/my-skill/SKILL.md`
- Сравни два скилла: `skills/old-linter/` и `skills/new-linter/`

## Похожие
- [evaluation-rubrics](https://affpapa.org/nevibecode/skills/evaluation-rubrics.md) — скилл · 792 установки
- [yao-meta-skill](https://affpapa.org/nevibecode/skills/yao-meta-skill.md) — скилл · 686 установок
- [skill-doctor](https://affpapa.org/nevibecode/skills/skill-doctor.md) — скилл · 15 установок
- [skill-compass](https://affpapa.org/nevibecode/skills/skill-compass.md) — скилл · ★ 214 у репозитория
- [project-min-evaluation](https://affpapa.org/nevibecode/skills/project-min-evaluation.md) — скилл · 5700 установок
- [evaluate-skill](https://affpapa.org/nevibecode/skills/edonadei-evaluate-skill.md) — скилл · ★ 237 у репозитория

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

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

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