session-reflection-analysis — скилл для Claude Code: обзор
Скилл анализирует историю диалогов Claude Code, чтобы находить неэффективные действия и снижать трату токенов в будущих задачах. Пригодится для ретроспективы после долгих рабочих сессий.
npx skills add harperreed/dotfiles --skill session-reflection-analysis -a claude-codeЧто делает session-reflection-analysis
Анализ сессий строится вокруг истории диалогов проекта в каталоге ~/.claude/projects/. Скилл не читает тяжёлые файлы *.jsonl целиком, так как они моментально исчерпают лимит контекста. Вместо этого с помощью утилиты jq он собирает сжатую выжимку: оставляет первые 300 символов сообщений, имена вызванных инструментов и размеры ответов без полного содержимого.
Полученную выжимку скилл передаёт субагенту через инструмент Task. Агент выявляет шаблоны проблем: многократное чтение одних и тех же файлов или нехватку правил в CLAUDE.md. По итогам формируется структурированный файл ретроспективы с готовыми вставками кода для правил или новых скриптов.
Без установленной в системе утилиты jq обработка логов завершится с ошибкой ещё до запуска анализа. Скилл только формирует предложения и никогда не внедряет правки в проект автоматически.
Какие задачи решает
- выявить лишние траты токенов в сессиях Claude Code
- найти частые ошибки и повторные вызовы инструментов
- сформировать дополнения для файла CLAUDE.md
- составить список идей для новых скиллов и слэш-команд
Примеры запросов агенту
- Проанализируй последнюю сессию и покажи, где мы зря потратили токены
- Проведи ретроспективу работы в этом проекте за неделю
- Разбери историю вызовов инструментов и предложи правила для CLAUDE.md
Как установить session-reflection-analysis
1Через Skills CLI (Vercel)
npx skills add harperreed/dotfiles --skill session-reflection-analysis -a claude-code2Вручную: положить файлы
~/.claude/skills/session-reflection-analysis/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/session-reflection-analysis/
1Через Skills CLI (Vercel)
npx skills add harperreed/dotfiles --skill session-reflection-analysis -a codex2Вручную: положить файлы
.agents/skills/session-reflection-analysis/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add harperreed/dotfiles --skill session-reflection-analysis -a cursor2Вручную: положить файлы
.cursor/skills/session-reflection-analysis/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install harperreed/dotfiles session-reflection-analysis2Вручную: положить файлы
.github/skills/session-reflection-analysis/SKILL.md1Через Skills CLI (Vercel)
npx skills add harperreed/dotfiles --skill session-reflection-analysis -a gemini-cli2Командой платформы
gemini skills install https://github.com/harperreed/dotfiles --path .claude/skills/session-reflection-analysisВручную: положить файлы
.devin/skills/session-reflection-analysis/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add harperreed/dotfiles --skill session-reflection-analysis -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о session-reflection-analysis
Как установить session-reflection-analysis в Claude Code?
Выполните команду npx skills add harperreed/dotfiles --skill session-reflection-analysis -a claude-code. Конфигурация сохранится по пути ~/.claude/skills/session-reflection-analysis/SKILL.md.
Что делает скилл session-reflection-analysis?
Он обрабатывает сохранённые логи сессий через jq, выявляет неэффективные действия вроде повторного чтения файлов и создаёт отчёт с предложениями по оптимизации контекста.
Какие системные зависимости нужны для работы скилла?
Для фильтрации логов обязательно требуется CLI-утилита jq. Без неё скилл не сможет подготовить сжатую сводку сессии и остановит выполнение.
