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

reflect · rsmdt — скилл для Claude Code: анализ логов сессий

Скилл reflect читает логи сессий Claude Code за выбранный период, находит слабые места в настройках проекта и предлагает конкретные правки — новые скиллы, хуки, правила или изменения в CLAUDE.md.

MIT ★ 587 обновлён 2026-10-26

Установить в Claude Code · Через маркетплейс плагинов Все способы и платформы ↓
/plugin marketplace add rsmdt/the-startup
/plugin install start@the-startup
Открыть на GitHub

Что делает reflect

reflect сканирует логи сессий по шести линзам: ошибки инструментов и циклы повторов (friction), неэффективные диалоги (conversation), перерасход токенов на выбор модели (router), ручную работу без автоматизации (capability), опасные операции без защиты (guardrail) и мёртвые инструкции в CLAUDE.md (instruction). Скилл группирует находки в улучшения, проверяет каждое утверждение через валидацию и выдаёт отчёт с предложениями — отредактировать существующий артефакт или создать новый.

Запускается командой вида /start:reflect last 3 days или /start:reflect 2026-07-10..2026-07-16; без аргументов анализирует вчерашний день. Скилл требует Node.js, доступ к каталогу логов проекта и утверждения плана перед запуском. Ничего не правит сам: все изменения применяет человек.

Отчёт включает оценку по шести измерениям (обоснованность, точность доказательств, полнота охвата, новизна, применимость, баланс), но скилл не пересматривает отчёт при низкой оценке — проваленные измерения остаются видны.

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

  • найти в логах сессий паттерны ошибок и неэффективности
  • предложить новые скиллы и хуки для автоматизации ручной работы
  • выявить мёртвые или игнорируемые правила в CLAUDE.md
  • проверить, что каждое предложение подкреплено цитатой из логов

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

  • /start:reflect last 3 days
  • /start:reflect 2026-07-10..2026-07-16
  • Проанализируй логи за вчера и покажи, где можно добавить защиту

Как установить reflect

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

/plugin marketplace add rsmdt/the-startup
/plugin install start@the-startup

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

2Через Skills CLI (Vercel)

npx skills add rsmdt/the-startup --skill reflect -a claude-code

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

~/.claude/skills/reflect/SKILL.md

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

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

Вопросы о reflect

Как установить reflect в Claude Code?

Выполни /plugin marketplace add rsmdt/the-startup, затем /plugin install start@the-startup. Файл скилла окажется в ~/.claude/skills/reflect/SKILL.md.

Что делает reflect?

Скилл читает логи сессий Claude Code за указанный период, ищет проблемы через шесть линз анализа и предлагает конкретные правки проекта — новые скиллы, хуки, правила или изменения CLAUDE.md. Сам ничего не правит.

Какие линзы анализа использует reflect?

Шесть линз: friction (ошибки, повторы), conversation (неэффективные диалоги), router (перерасход токенов на модели), capability (ручная работа без автоматизации), guardrail (опасные операции), instruction (мёртвые правила в CLAUDE.md).

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

SKILL.md · MIT
---
name: reflect
description: Self-improvement from this project's Claude Code session logs. Mines a date range (default "yesterday") through parallel signal lenses, clusters what it finds into improvement opportunities, drafts a concrete change per opportunity, adversarially validates the cited evidence, and reports improve/create proposals across the project harness — skills, subagents, output styles, the CLAUDE.md/AGENTS.md instruction, and guardrails (permission rules, hooks). Advisory — it never edits an artifact; you decide what to apply.
user-invocable: true
argument-hint: "date range (default: yesterday), e.g. 'last 3 days' or '2026-07-10..2026-07-16'"
---

## Persona

Act as the self-improvement orchestrator. You turn a date range into a **reflect plan** (purpose,
date range, signal lenses), get the user to approve it, then author and run **one dynamic workflow**
(the Workflow tool with an inline script you write) that mines, clusters, proposes, validates, and
reports. You do **not** mine logs, draft changes, or write the report yourself.

**Date range**: $ARGUMENTS

**Advisory is the identity.** reflect never edits or creates an artifact. It reports proposals, each
labelled **improve** (edit an existing artifact) or **create** (a new skill, subagent, hook, or
permission rule), with a concrete change and cited session-log evidence. A human applies them.

**In scope** — the project harness, all git-tracked: skills, subagents, and output styles under
`plugins/`; the project `CLAUDE.md` / `AGENTS.md`; guardrails in the project `.claude/settings.json`
(permission rules, hooks) and `CLAUDE.md` rules. **Out of scope:** the user's global `~/.claude/` files
and other projects' logs.

## Constraints

**Always:**
- Resolve the date range to absolute ISO `since` / `until` before launching; default to yesterday.
- Resolve `logRoot` to this project's session-log directory (the Claude home `projects/<slugified-cwd>/`) and confirm it has sessions in range; if none, say so and stop.
- Show the full plan in the chat and get approval before launching.
- Require citations: every proposal traces to a session-log record, and to a `file:line` where it points at code.
- Prefer **improve** over **create**; create only where no existing artifact fits.
- Writing under `.start/reflect/` is pre-authorized.

**Never:**
- Mine, draft, validate, or write the report outside the workflow.
- Apply a proposal unless the user asks — then on a branch, one proposal at a time.

## Reference Materials

- [Workflow Contract](reference/workflow.md) — stages, agent return schemas, decision rules, result shape
- [Surfaces](reference/surfaces.md) — each harness surface: what it is, where its fix lives, what to read first
- [Mine Agent](reference/mine-agent.md) — shared mining block plus the six lens prompts
- [Cluster Agent](reference/cluster-agent.md) · [Propose Agent](reference/propose-agent.md) · [Validate Agent](reference/validate-agent.md) · [Synthesize Agent](reference/synthesize-agent.md) · [Grade Agent](reference/grade-agent.md)
- [Plan Template](template.md) — the reflect plan document

## Workflow

### 1. Frame the Plan

Derive from `$ARGUMENTS` the date range (`since`, `until`, `label`), a slug `name` (e.g. `2026-07-16`),
and a terse purpose. Choose the signal lenses — default all six:

- `friction` — tool errors, user interrupts and rejections, retry loops, expensive turns
- `conversation` — inefficient dialogue that leaves no structured trace (samples sessions)
- `router` — over- or under-provisioned models per role
- `capability` — recurring manual multi-step work no skill or subagent owns (→ create)
- `guardrail` — recurring mistakes and unguarded dangerous operations (→ permission rule, hook, rule)
- `instruction` — dead, ignored, bloated, or ambiguous CLAUDE.md / AGENTS.md rules

Create `.start/reflect/[name]/` with a `.tracker/` directory and write `reflect.md` from template.md
with `status: draft`.

### 2. Approve or Refine

Display in the chat: the purpose, the resolved date range with ISO dates, the lenses, the target scope,
and that the run is advisory. Ask the user to *Approve* or *Refine*. On refine, update `reflect.md`,
re-display, and ask again. On approve, set `status: approved`.

### 3. Seed the Tracker

For each lens create a mine task and record its id:

`node ${CLAUDE_PLUGIN_ROOT}/scripts/task.js create --home .start/reflect/[name] --type mine --name "{lens}"`

### 4. Run the Dynamic Workflow

These instructions are the opt-in: call the Workflow tool directly with an inline script. Do not load the workflow-authoring reference or assemble the script through shell commands first — runs that detour through either stall before launching. Read reference/workflow.md,
reference/surfaces.md, and the agent references. Author one workflow script that implements the
contract exactly, each agent's prompt taken from its reference with placeholders filled. Launch it with
the Workflow tool, passing the resolved values as `args`. Set `status: in-progress`.

Choose `model` and `effort` per stage from what the stage does. Structured mining — scanning records for
errors, interrupts, and token counts — can run on a smaller, faster model. Reading dialogue for
inefficiency, spotting capability gaps, auditing instructions, clustering, validating, and grading need
the strongest model. A validating or grading stage never runs on a weaker model than the stage it
judges. When unsure, omit `model` so the stage inherits the session model.

Present a one-line dispatch summary, e.g.
`Reflecting on "{name}": {n} lenses over {label} → dynamic workflow (advisory)`.

### 5. Report

When the workflow returns (shape in reference/workflow.md):

1. Present the report: the per-surface ranking and the validated proposals grouped by surface, each with
   its change, label, evidence, and tier. Say how many were dropped in validation. Show the grade
   (`overall` and each dimension) and name every failing dimension — the report is not revised to clear
   it. If no proposal survived, say the run found nothing supportable and show no grade.
2. Set `reflect.md` `status: review`.
3. Ask the user to choose: *Apply a proposal (on a branch)* | *Deepen a lens* | *Persist report to
   docs/research/* | *Done*. When applying, run the target's `evals/evals.json` where one exists and
   surface the result before the next proposal.

© Rudolf S. · MIT · rsmdt/the-startup

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

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

Сначала — reflect от других авторов.

reflect backnotprop Скилл reflect для Claude Code читает транскрипт текущей сессии и превращает замечания пользователя в правки уже существующих скиллов. Запускается по слову reflect. CX Codex +1 10 400установок reflect Alireza Rezvani Скилл reflect для Claude Code останавливает текущую задачу и пересматривает направление разговора. Запускается по просьбе отойти от деталей или проверить, туда ли движется работа. CX Codex +1 320установок reflect NeoLabHQ Скилл reflect заставляет агента перечитать собственный ответ и найти в нём слабые места до того, как вы примете работу. CX Codex +1 1 400установок reflect haowjy Скилл reflect проверяет результат работы перед финальным отчётом и направляет сохранённые знания в файлы проекта. Пригодится, чтобы сверить ожидания и зафиксировать важные детали сессии. CX Codex +1 438установок reflect pwguler Скилл reflect собирает уроки из завершённой сессии ИИ-агента и переносит их в проектные файлы, тесты или инструкции для будущих запусков. Запускается в конце сессии, где были ошибки, исправления или неожиданное поведение. CX Codex +1 904установок create-pr OrchestKit Скилл create-pr создаёт pull request в GitHub после прогона тестов, линтера, типов и проверки безопасности. Срабатывает по явному вызову, обычная команда gh pr create остаётся командой. CX Codex +1 209установок audit-library-health MoizIbnYousaf Скилл audit-library-health для комплексной диагностики библиотеки скиллов: валидация структуры, поиск устаревших элементов, проверка синхронизации документации. Запускайте перед публикацией или обновлением. CX Codex +1 170установок langgraph-human-in-the-loop langchain-ai Скилл langgraph-human-in-the-loop для Claude Code и других платформ: строит графы LangGraph с паузами, ждущими человеческого ввода, одобрения или валидации. CX Codex +1 18 300установок skill-authoring-workflow deanpeters Скилл skill-authoring-workflow для Claude Code. Проводит черновые заметки до готового SKILL.md, проходящего проверки репозитория Product-Manager-Skills. CX Codex +1 2 200установок coordination transilienceai Скилл coordination для координации агентов при проведении тестов безопасности. Управляет выполнением и валидацией, хранит состояние engagement в одном контексте и не делегирует мышление подагентам. CX Codex +1 198установок skill-update transilienceai Скилл skill-update генерирует структуру скилла, проверяет её по лучшим практикам Anthropic и блокирует файлы, превышающие лимиты строк. Используй при создании или обновлении скилла. CX Codex +1 174установок

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

Весь набор →
monitor-production Субагент monitor-production настраивает метрики, логи, трассировки, оповещения и дашборды для продакшена. Пригодится при запуске мониторинга, настройке SLO и разборе сбоев. CX Codex ★ 587звёзд репо review-compatibility Субагент review-compatibility для Claude Code, который проверяет код на breaking changes в API, базах данных и конфигах. CX Codex ★ 587звёзд репо specify-requirements Скилл specify-requirements создаёт и проверяет продуктовые требования (PRD) в файлах spec.md. Пригодится при описании пользовательских историй и критериев приёмки. CX Codex +1 ★ 587звёзд репо build-feature Субагент build-feature для Claude Code реализует функции в интерфейсе, API, сервисах и других слоях проекта. Подключается к запросам на создание или изменение кода. CX Codex ★ 587звёзд репо validate Скилл validate запускает проверку спецификаций, кода, расхождений с реализацией и правил конституции проекта через специализированных субагентов. CX Codex +1 ★ 587звёзд репо the-chief Субагент the-chief, который оценивает, насколько сложна задача, и распределяет работу между параллельными процессами. Помогает когда требования неясны, нужна координация между системами или есть возможность работать параллельно. CX Codex ★ 587звёзд репо design-system Субагент design-system для Claude Code проектирует архитектуру сервиса: выбирает паттерн, хранилища и путь масштабирования, отдаёт диаграммы и ADR. Помогает решить, дробить ли монолит. CX Codex ★ 587звёзд репо optimize-performance Субагент optimize-performance для профилирования и ускорения фронтенда, бэкенда и баз данных в Claude Code. Помогает при росте задержек API, утечках памяти и тяжёлых бандлах. CX Codex ★ 587звёзд репо

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

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