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

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

Скилл skill-doctor оценивает настройку агента по истории реальных сессий Claude Code или Codex — какие скиллы работают, а какие нет, и предлагает исправления с доказательствами из диалогов.

MIT 15 установок ★ 30 251 обновлён 2026-10-23

Установить в Claude Code · Через маркетплейс плагинов Все способы и платформы ↓
/plugin marketplace add alirezarezvani/claude-skills
/plugin install skill-doctor@claude-code-skills
Открыть на GitHub

Что делает skill-doctor

Скилл анализирует локальную историю проектов Claude Code и Codex, находит установленные скиллы в .claude/skills, .agents/skills, .codex/skills, отслеживает их вызовы в диалогах и оценивает сессии по двум рубрикам — эффективность (scorers/efficiency.md) и качество кода (scorers/code-quality.md). Всё остаётся на машине: транскрипты редактируются от секретов, помечаются chmod 0600 и никуда не загружаются.

После сбора данных скилл выставляет метки из таблиц рубрик (никаких чисел от себя), агрегатор score_aggregator.py проверяет их и считает общую оценку (0.5·efficiency + 0.35·code_quality + 0.15·skill_coverage). Если проверка падает с кодом 4, исправь названное и запусти снова — обходить этот шаг нельзя. Затем render_report.py создаёт самодостаточный HTML-отчёт без JS и CDN, с поддержкой тёмной темы и печати в PDF. Скилл предлагает правки для найденных скиллов, но применяет их только после явного согласия на каждый файл. Ноль предложений — нормальный результат, если текущие инструкции достаточны.

Какие задачи решает

  • понять, какие скиллы реально используются в проектах
  • получить оценку настройки агента из истории сессий
  • найти повторяющиеся проблемы в диалогах с Claude Code
  • получить правки скиллов с ссылкой на конкретные сессии

Примеры запросов агенту

  • Оцени мою настройку агента по последним сессиям
  • Какие скиллы у меня работают, а какие нет
  • Проверь историю Claude Code за 90 дней и предложи исправления

Как установить skill-doctor

1Через маркетплейс плагинов

/plugin marketplace add alirezarezvani/claude-skills
/plugin install skill-doctor@claude-code-skills

Команда ставит плагин skill-doctor целиком, со всеми его скиллами

2Через Skills CLI (Vercel)

npx skills add alirezarezvani/claude-skills --skill skill-doctor -a claude-code

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

~/.claude/skills/skill-doctor/SKILL.md

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

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

Вопросы о skill-doctor

Как установить skill-doctor в Claude Code?

Выполни /plugin marketplace add alirezarezvani/claude-skills, затем /plugin install skill-doctor@claude-code-skills. Для Codex скопируй SKILL.md в .agents/skills/skill-doctor/.

Что делает skill-doctor?

Собирает историю сессий Claude Code или Codex, оценивает их по рубрикам эффективности и качества кода, находит паттерны проблем и предлагает правки для установленных скиллов. Всё локально, ничего не уходит в сеть.

Что будет, если история сессий пустая?

Скрипт collect_sessions.py запишет sessions_sampled: 0 в inventory.json, и скилл предложит попробовать --days 90 или указать другой репозиторий через --repo. Без сессий оценивать нечего.

Исходный текст

SKILL.md · MIT
---
name: skill-doctor
description: Use when the user wants their agent setup graded from real conversation history, asks which installed skills are actually working, or wants evidence-backed skill edits — scores recent local Claude Code / Codex sessions against efficiency and code-quality rubrics, then drafts skill changes gated by a deterministic aggregator and renders one local shareable report.
argument-hint: "[optional: --repo PATH, --days N, or a question about the setup]"
license: MIT
metadata:
  version: 1.0.0
  build_pattern: "Rebuild of warpdotdev/common-skills skill-doctor (MIT): harvest → LLM-judges-with-rubrics → deterministic aggregation gate → self-contained HTML report"
  distinct_from: "skillopt-sleep (nightly automated replay loop with adopt gate; this is one interactive graded pass); write-a-skill (authors a skill from expertise; this improves skills from observed session evidence); self-eval (grades this session's own work; this grades a window of past sessions)"
---

# skill-doctor — grade the agent setup from real sessions

> **Privacy is the contract.** Everything runs locally. Transcripts are condensed,
> secret-redacted, chmod-0600, and never uploaded — the only shareable artifact is
> the report the user chooses to share.

Run from the repo being graded. Every artifact goes to one fresh scratch dir, never
into the repo:

```bash
RUN="$(mktemp -d "${TMPDIR:-/tmp}/skill-doctor-XXXXXXXX")"
python scripts/collect_sessions.py --out "$RUN"          # 1 — harvest + redact
```

**1 — Collect.** Scans Claude Code project-history JSONL and Codex rollouts,
discovers repo skills (`.claude/skills`, `.agents/skills`, `.codex/skills`, plugin
layouts), detects skill usage (`Skill` invocations, slash commands, SKILL.md paths), samples
newest-first, and writes redacted transcripts. Read `$RUN/inventory.json`: if
`sessions_sampled` is 0, tell the user there is nothing recent to score (suggest
`--days 90` or `--repo`) and stop. `skills_found` 0 is fine — the report becomes a
case for creating skills.

**2 — Score.** `python scripts/score_aggregator.py --inventory "$RUN/inventory.json"
--emit-template > "$RUN/session_scores.json"`. Read each transcript in
`$RUN/transcripts/` and judge it against **both** rubrics — `scorers/efficiency.md`
and `scorers/code-quality.md`. Fill the template with a **label from the rubric's
table** and a 1–3 sentence reason citing transcript specifics. Never invent numeric
scores — the aggregator derives them from labels. Use `insufficient_evidence` when
a transcript shows no judgeable diff. Also write 1–5 `top_findings`: the most
impactful cross-session patterns, concrete and specific.

**3 — Draft edits.** Follow `references/skill_edit_governance.md` (the filing bar:
would a competent agent with the current instructions still fail this way?). For
each suggestion that clears it, write the full improved SKILL.md to
`$RUN/proposed/<skill>/SKILL.md`, produce `diff -u <current> <proposed>`, and record
it in `$RUN/suggestions.json` citing the sampled session id(s) that motivated it.
Zero suggestions is a valid success — say why per finding. Never modify the user's
real skill files in this step.

**4 — Aggregate (the gate).** `python scripts/score_aggregator.py --inventory
"$RUN/inventory.json" --scores "$RUN/session_scores.json" --suggestions
"$RUN/suggestions.json"`. It validates labels against the rubric tables, refuses
scores for unsampled sessions, requires substantive reasons, rejects suggestions
that cite no scored session, computes `overall = 0.5·efficiency +
0.35·code_quality + 0.15·skill_coverage`, and writes `report.json`. **Exit 4 is a
stop**: fix what it names and re-run; never hand-edit report.json around it.

**5 — Render + tell.** `python scripts/render_report.py --report "$RUN/report.json"`
→ one self-contained `report.html` (no JS, no CDN, dark-mode + print-to-PDF). Then
tell the user the grade and the top findings in text, link
`file://$RUN/report.html`, and ask whether to apply the proposed diffs to their
real skills — apply only on an explicit yes, skill by skill.

## Hard rules

1. **Never upload transcripts, session files, or any excerpt.** Local only.
2. **Labels only, from the rubric tables.** The aggregator owns all arithmetic.
3. **Every suggestion traces to a scored session** — or it is dropped. Generic best practice is not evidence.
4. **Zero suggestions is a success**, not a failure to report around.
5. **Exit 4 from the aggregator is a stop**, not an error to swallow or bypass.
6. **Never touch the user's real skill files** without an explicit per-skill yes; proposed edits live under `$RUN/proposed/`.
7. **A proposed skill edit follows write-a-skill discipline** — trigger phrase in the description, smallest change that expresses the rule, replace over append.

## Scripts

| Script | Role | Exit codes |
|---|---|---|
| `scripts/collect_sessions.py` | Harvest Claude Code + Codex sessions, redact secrets, sample, inventory | 0 · 3 bad input |
| `scripts/score_aggregator.py` | Validate labels/reasons/suggestions, compute grade, emit report.json | 0 · 2 warnings · 3 bad input · 4 validation failure |
| `scripts/render_report.py` | report.json → single self-contained report.html | 0 · 3 bad input |

All support `--help`, `--output json`, and `--sample` (no real history needed).

## References and assets

- [`scorers/efficiency.md`](scorers/efficiency.md) · [`scorers/code-quality.md`](scorers/code-quality.md) — the two rubrics, preserved verbatim from upstream
- [`references/transcript_scoring_canon.md`](references/transcript_scoring_canon.md) — why rubric-anchored LLM judging works and where it fails (7 sources)
- [`references/session_mining_privacy.md`](references/session_mining_privacy.md) — the local-only contract, redaction pattern canon (7 sources)
- [`references/skill_edit_governance.md`](references/skill_edit_governance.md) — the filing bar for proposing skill edits (7 sources)
- [`assets/session_scores.example.json`](assets/session_scores.example.json) · [`assets/suggestions.example.json`](assets/suggestions.example.json) · [`assets/report.example.json`](assets/report.example.json) — the three handoff shapes

© Alireza Rezvani · MIT · alirezarezvani/claude-skills

Похожие скиллы

Все скиллы по теме «Настройка агента: память, контекст, субагенты» →
improve-agent-setup jackulau Скилл improve-agent-setup для Claude Code разбирает ошибки в записях сессий агента и предлагает улучшения для его инструкций. Запускается по просьбе найти повторяющуюся ошибку или оценить, помогло ли изменение правила. CX Codex +1 ★ 149звёзд репо basecamp-doctor basecamp Скилл basecamp-doctor проверяет состояние Basecamp CLI, учётных данных и интеграции с агентами. Помогает быстро найти, что сломалось в настройке или требует обновления. CX Codex +1 325установок yao-meta-skill Yao Team Скилл yao-meta-skill для Claude Code создаёт, улучшает и проверяет навыки ИИ-агентов. Подключается к задачам миграции, упаковки, маршрутизации и тестирования скиллов. CX Codex +1 686установок skill-compass Evol-ai Скилл skill-compass для Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI и OpenCode. Оценивает качество установленных скиллов, находит слабое место и правит его. Запускается на первом сеансе после установки или по команде. CX Codex +1 ★ 214звёзд репо skill-evaluation ft.ia.br Скилл skill-evaluation оценивает агентский скилл по методике, собранной из рекомендаций Anthropic для Claude Code и доклада Matt Pocock «How to Write Great Skills». Выдаёт скоркард по 4 осям с баллами 0–100 и ссылками на строки SKILL.md. CX Codex +1 ★ 141звёзд репо session-reflection-analysis harperreed Скилл session-reflection-analysis для Claude Code и ещё пяти платформ, который анализирует историю сессии. Находит повторяющиеся ошибки, лишние вызовы инструментов и места, где не хватает документации. CX Codex +1 ★ 339звёзд репо

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

Весь набор →
linkedin-analytics Скилл linkedin-analytics для честного анализа личного экспорта постов в LinkedIn без ложных выводов на малых выборках. Считает медианы и отсекает случайный шум. CX Codex +1 17установок iso13485-audit-prep Скилл iso13485-audit-prep запускает проверку системы менеджмента качества медизделий по шести направлениям перед аудитом ISO 13485, проверкой FDA QSR или закрытием DHF. CX Codex +1 17установок fda-qsr-audit-prep Скилл fda-qsr-audit-prep прогоняет шесть вопросов аудита FDA 21 CFR 820 перед внутренней проверкой, инспекцией или ответом на Form 483. CX Codex +1 17установок md-slides Скилл md-slides превращает markdown-файл со слайдами в одну HTML-страницу с навигацией с клавиатуры, режимом докладчика и печатью по слайду на страницу. CX Codex +1 15установок pw-init Скилл pw-init для Claude Code, который разворачивает Playwright в проекте: конфиг, структуру папок, пример теста и CI-воркфлоу. Запускается одной фразой в чате — и сразу определяет фреймворк. CX Codex +1 15установок linkedin-skills Помогает развивать личный профиль в LinkedIn без автоматизации и спама. Маршрутизирует задачи по пяти направлениям: от стратегии до текстов. CX Codex +1 12установок skillopt-sleep Скилл skillopt-sleep для Claude Code анализирует прошлые сессии и предлагает обновления памяти и скиллов. Запускает офлайн-цикл повторного выполнения задач и проверки правок. CX Codex +1 12установок deep-learning-book Скилл deep-learning-book для Claude Code помогает изучать учебник Deep Learning и применять его идеи к задачам обучения моделей. Он строит маршрут по главам, разбирает сбои обучения и считает параметры, FLOP и память активаций. CX Codex +1 12установок

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

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