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

retrospective · glebis — скилл для Claude Code: что делает и как установить

Скилл retrospective проводит ретроспективу сессии, находит ошибки и правки пользователя, а затем сохраняет выводы в файлы памяти, правила CLAUDE.md или текст скиллов.

MIT 135 установок ★ 414 обновлён 2026-10-23

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add glebis/claude-skills --skill retrospective -a claude-code
Открыть на GitHub

Что делает retrospective

Скилл разбирает историю диалога или сканирует JSONL-файлы сессий за день в каталоге ~/.claude/projects. В коротких беседах он задаёт один вопрос о том, что запомнить, а в длинных переходит в полный режим: выявляет упавшие скиллы, повторяющиеся ошибки и прямые исправления от пользователя.

Кандидаты на сохранение скилл ранжирует по важности и сверяет с существующими записями, чтобы избежать дублей. После одного интерактивного опроса утверждённые правки автоматически вносятся в MEMORY.md, инструкции в ~/.claude/skills/ или CLAUDE.md.

Для создания задач в Linear потребуется заранее настроенный CLI-скрипт в ~/.claude/skills/linear/scripts/linear — без него скилл просто пропустит этот тип действий.

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

  • сохранить исправления и правила в память проекта
  • обновить инструкции скиллов после сбоев
  • выгрузить задачи по итогам сессий в Linear
  • разобрать ошибки за день по всем проектам

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

  • /retrospective
  • /retrospective today
  • Давай проведём ретро по итогам сессии

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

1Через Skills CLI (Vercel)

npx skills add glebis/claude-skills --skill retrospective -a claude-code

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

~/.claude/skills/retrospective/SKILL.md

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

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

Вопросы о retrospective

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

Выполните команду npx skills add glebis/claude-skills --skill retrospective -a claude-code.

Что делает скилл retrospective?

Он анализирует текущий диалог или JSONL-логи сессий за день, находит правки пользователя и обновляет файлы памяти или инструкции скиллов.

Как retrospective создаёт задачи в Linear?

Скилл проверяет наличие скрипта ~/.claude/skills/linear/scripts/linear. Если файл существует, он вызывает linear issue create, а при его отсутствии пропускает создание задач.

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

SKILL.md · MIT
---
name: retrospective
description: Interactive post-session retrospective that captures learnings, updates skills, and saves memories. Use when the user says "/retrospective", "let's do a retro", "what did we learn", "session review", "retro", or "wrap up". Also use at the end of long productive sessions when significant patterns or corrections emerged. Supports multi-session mode — by default processes all of today's sessions across projects.
---

# Retrospective

Interactive post-session retro. Scans sessions, asks focused questions, proposes concrete actions the user approves in one step.

## Modes

### Single-session mode (default when inside a substantial conversation)
Scans the current conversation only. This is the original behavior.

### Multi-session mode (default when invoked with no args, or with "today", or with a date)
Scans all sessions from a given day (default: today) across all projects. Extracts user corrections, skill failures, and patterns from JSONL transcripts.

**Trigger:** `/retrospective` at the start of a fresh session, or `/retrospective today`, or `/retrospective 2026-05-24`.

## Multi-Session Discovery

### Step 0 — Discover sessions

```bash
# Find today's sessions (default)
find ~/.claude/projects -maxdepth 2 -name "*.jsonl" -not -path "*/subagents/*" -mtime 0

# Or for a specific date, filter by file modification date
find ~/.claude/projects -maxdepth 2 -name "*.jsonl" -not -path "*/subagents/*" -newermt "YYYY-MM-DD" ! -newermt "YYYY-MM-DD + 1 day"
```

For each JSONL file found, extract a summary:
1. Parse the project name from the path (the directory name after `projects/`, decoded from the path-encoding)
2. Extract `user` and `assistant` messages (type `user` and `assistant`)
3. For user messages: `message.content` (may be string or array of `{type: "text", text: "..."}`)
4. For assistant messages: collect text blocks from `message.content` array where `type == "text"`
5. Build a condensed transcript: first 10 user messages + last 5 user messages (to capture corrections at the end)
6. Skip sessions with fewer than 3 user messages (too short to have learnings)

### Step 0b — Present session list

Show the user what was found:

```
Found N sessions today:
- project-name-1 (session-id[:8]) — "first user message preview..."
- project-name-2 (session-id[:8]) — "first user message preview..."
```

Then continue to Step 1a with the combined findings from all sessions. Each candidate action should note which session it came from (project name + short ID).

## Single-Session Process

### Step 0 — Gate Check (silent)

Scan the conversation and estimate session depth. Look for tool calls (Read, Edit, Write, Bash, Skill invocations), errors encountered, and back-and-forth exchanges. Don't try to count exactly — judge by feel:

- **Short session** (a quick question and answer, ~1-2 tasks) → **Fast mode** (Step 1b)
- **Substantial session** (multiple tasks, skill usage, errors, corrections) → **Full mode** (Step 1a)

### Step 1a — Full Mode

Silently scan the conversation and collect:

1. **Skills invoked** — which succeeded, which failed, workarounds applied
2. **User corrections** — explicit "no, do it this way" moments (highest signal)
3. **Repeated patterns** — same error hit multiple times, same workaround applied
4. **Cross-skill workflows** — 3+ skills chained in sequence

Then read existing state:
- Find the current project's memory directory: `glob ~/.claude/projects/*/memory/MEMORY.md` and read it plus relevant memory files
- Read skill files for any skills that were invoked (`~/.claude/skills/{name}/skill.md`)
- Check if Linear CLI exists: `test -f ~/.claude/skills/linear/scripts/linear && echo "configured" || echo "not configured"`

Generate up to **5 candidate actions**, ranked by signal strength:
1. User corrections (highest priority)
2. Failed/workarounded skills
3. Repeated patterns
4. Error patterns
5. Workflow patterns (lowest)

**Dedup rules:**
- If a candidate's content overlaps with an existing memory file → drop it
- If a skill update candidate overlaps with existing skill file content → drop it
- If Linear is not configured → omit any Linear task candidates

Present everything in a **single AskUserQuestion call** (up to 4 questions):

| # | Question | Type |
|---|----------|------|
| 1 | "Quick session check?" | Single select: `Productive / Mixed / Rough / Skip retro` |
| 2 | "What felt slow or broken?" | Free text via Other (optional) |
| 3 | "Anything to carry forward as a rule?" | Free text via Other (optional) |
| 4 | "Which of these should I save?" | Multi-select: generated candidates with descriptions. Always include a "Nothing / skip all" option. |

If Q1 = "Skip retro" → exit immediately.

If Q1 = "Rough" and Q2/Q3 are empty → exit with "Nothing to save — session closed." Don't add another question after the user already signaled they're done.

### Step 1b — Fast Mode

Single AskUserQuestion call with one question:
- "Anything worth remembering from this session?" with options:
  - "Nothing, we're done" (default)
  - Other (free text)

If "Nothing" → exit. If free text → save as memory, exit.

### Step 2 — Execute (silent, no re-confirmation)

For each approved item from Q4 (plus any insights from Q2/Q3 free text):

1. **Read the target file** before writing
2. **Check for conflicts/duplicates** against current content
3. **Write the change** if clean
4. **Skip with warning** if conflict detected

Action types and their targets:

| Type | Target | Tool |
|------|--------|------|
| Skill update | `~/.claude/skills/{name}/skill.md` | Edit |
| Memory (feedback) | Current project's `memory/feedback_*.md` + MEMORY.md | Write |
| Memory (project) | Current project's `memory/project_*.md` + MEMORY.md | Write |
| CLAUDE.md rule | `~/.claude/CLAUDE.md` or project CLAUDE.md | Edit |
| Linear task | `~/.claude/skills/linear/scripts/linear issue create --title "..." --description "..."` | Bash |

### Step 3 — Summary (brief)

One-line per action taken:
```
Updated telegram skill — added chat type mismatch note
Saved memory — Qwen /api/chat not /api/generate
Skipped: pdf-generation update (already documented)
```

Done. No trailing commentary.

## JSONL Transcript Format

Session transcripts are stored as JSONL files at `~/.claude/projects/{project-path}/{session-id}.jsonl`.

Each line is a JSON object with a `type` field. Relevant types:
- `user` — user message. Content at `message.content` (string or array of `{type: "text", text: "..."}`)
- `assistant` — Claude's response. Content at `message.content` (array of content blocks; extract where `type == "text"`)
- `ai-title` — auto-generated session title

To extract a readable transcript from a JSONL file, use a Python one-liner or read the file and filter for `user`/`assistant` types.

**Project name decoding:** The directory name uses the absolute path with slashes replaced by dashes, e.g., `-Users-glebkalinin-ai-projects-foo` → `~/ai_projects/foo`.

## Mode Selection Logic

When `/retrospective` is invoked:
1. If the current conversation has 10+ user messages → **single-session mode** (retro this conversation)
2. If the current conversation is short (just the `/retrospective` invocation) → **multi-session mode** (scan today's sessions)
3. If args contain a date (e.g., "today", "yesterday", "2026-05-24") → **multi-session mode** for that date
4. If args contain "all" → **multi-session mode** for today

## Candidate Description Format

Each candidate in Q4 must have a description showing the **exact proposed content**, not just a title. The user judges candidates by reading descriptions, not by opening files.

Good: `"Add to telegram skill: get_chat_type() misclassifies private chats as channels — use Telethon client.send_message() directly for DMs"`

Bad: `"Update telegram skill with DM fix"`

## What This Skill Does NOT Do

This skill only captures session learnings. It does not review code quality, analyze PRs, create documentation, or run tests. For those, use the appropriate dedicated skills.

## Rules

- Never write learnings into this skill file itself — distribute to relevant skills or memory
- Cap candidates at 5 even if more findings exist
- User corrections always rank above tool failures
- The multi-select in Step 1a IS the approval — do not ask again per action
- If the session used no skills, only offer memory and CLAUDE.md candidates
- Keep the entire interaction to 2 moments: one question call, then silent execution

## Tools

- AskUserQuestion: Interactive questions (1-4 per call, single/multi select)
- Read: Check existing memory and skill files before proposing changes
- Edit: Update existing skill files and CLAUDE.md
- Write: Create new memory files
- Bash: Linear task creation, skill directory listing
- Glob: Find skill and memory files

## Testing

Engine logic is tested in `retro_engine.py` with 9 scenario fixtures and 30 pytest tests.
Run: `cd ~/.claude/skills/retrospective && python3 -m pytest test_retro_engine.py -v`

© glebis · MIT · glebis/claude-skills

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

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

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

retrospective Donchitos Скилл retrospective для Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI и OpenCode — проводит ретроспективу спринта или вехи по истории коммитов, планам и статусам задач. Формирует список конкретных действий на следующую итерацию. CX Codex +1 659установок retrospective haabe Скилл retrospective для Claude Code, который проводит ретроспективу после каждого завершённого цикла поставки. Записывает результаты в cycle-history.yml, фиксирует калибровку оценок и накапливает данные для непрерывного улучшения. CX Codex +1 ★ 54звёзд репо retrospective-analyzer davila7 Команда retrospective-analyzer анализирует спринты разработчиков по коммитам Git и задачам из Linear. Помогает разобрать итоги и сформировать список задач. CX Codex +1 196установок groove-utilities-memory-retrospective andreadellacorte Скилл groove-utilities-memory-retrospective для Claude Code собирает по .groove/memory/ ретроспективу: оценивает динамику сессий, находит повторяющиеся сбои и выводит сводку в чат. Для недельных разборов. CX Codex +1 517установок run-learning-retrospective cursor Скилл run-learning-retrospective для Claude Code проводит ретроспективу обучения: сверяет сделанное с целями, находит повторяющиеся блокеры и правит план. Запускается после закрытия очередного этапа. CX Codex +1 937установок iterate-retrospective product-on-purpose Скилл iterate-retrospective помогает провести командную ретроспективу, разобрать успехи и сбои спринта, а затем зафиксировать задачи с дедлайнами и ответственными. CX Codex +1 832установок sprint-retrospective akillness Скилл sprint-retrospective помогает провести ретроспективу спринта или майлстоуна и превратить её в пару действий с владельцами и сроками. CX Codex +1 365установок project-retrospective jamditis Скилл project-retrospective генерирует LESSONS.md файлы, которые фиксируют знания и ошибки проекта. Пригодится при закрытии проекта или расследования, чтобы не потерять выводы и не повторить ошибки. CX Codex +1 189установок

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

Весь набор →
sorted Автоматизирует getSorted.de через браузер для выставления счетов, учёта расходов и подачи налоговых отчётов в Германии. CX Codex +1 151установок rag-eval Скилл rag-eval запускает сетку тестов для RAG-пайплайна с ограничением бюджета и ранжирует варианты. CX Codex +1 150установок wow-digest Скилл wow-digest для Claude Code собирает письма из рассылок и посты Telegram, отбирает неожиданные материалы и добавляет их в ежедневную заметку для утреннего обзора чтения. CX Codex +1 145установок tg-responder Скилл tg-responder для Claude Code помогает проверять черновики ответов в Telegram, одобрять отправку и отслеживать сообщения без ответа, чтобы держать inbox под контролем и не забывать о важных переписках. CX Codex +1 145установок present Скилл present генерирует интерактивные HTML-презентации с синхронной озвучкой ElevenLabs, переключением между режимом слайдов и статьи и иллюстрациями. CX Codex +1 117установок site-diagnosis Скилл site-diagnosis для Claude Code проводит анкету перед аудитом сайта, созданного с ИИ, и формирует бриф для консультации. Вопросы помогают описать проблемы с дизайном, кодом или поддержкой. CX Codex +1 116установок ecosystem Скилл ecosystem проводит аудит среды Claude Code: проверяет свежесть скиллов, активность в проектах, актуальность CLAUDE.md и сервисы на Mac Mini. CX Codex +1 115установок learning-vault Скилл learning-vault разворачивает в Markdown структурированную базу знаний для подготовки к экзаменам или курсам. Помогает разложить тему по доменам, концепциям и задачам на повторение. CX Codex +1 108установок

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

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