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

mining-session-skills — скилл для Claude Code

Скилл mining-session-skills анализирует завершённую сессию Claude Code и предлагает, какой скилл создать, обновить или переиспользовать, чтобы похожая работа делалась быстрее. Работает с экспортированным markdown из claude-session-manager.

MIT 196 установок ★ 140 обновлён 2026-10-19

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

Что делает mining-session-skills

Скилл читает отчёты о сессиях, ищет повторяющиеся паттерны работы и решает: стоит ли превратить найденное в переиспользуемый скилл. Работает пошагово — от поиска нужной сессии и её экспорта до анализа по фрикционным сигналам (где замедлялась работа, где задавались одни и те же вопросы, где повторялась логика). Сравнивает найденные паттерны со скиллами, уже загруженными в сессию, и решает: создать новый скилл, обновить существующий или переиспользовать тот, что уже в экосистеме.

Читает экспортированный markdown из ~/.claude/session-markdown (не исходные JSONL файлы — они слишком объёмные), при нужде вытягивает детали инструментов из сайдкара. Сегментирует многодневные сессии на отдельные дуги работы и анализирует каждую независимо. На выходе предлагает отчёт с номером события, строки, цитатой и предложением действия (CREATE, UPDATE или REUSE).

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

  • Найти в архиве сессию по описанию и выделить её для анализа
  • Экспортировать нужную сессию из JSONL в компактный markdown
  • Разобрать сессию на логические блоки и выявить повторяющиеся операции
  • Решить, стоит ли паттерн превращать в скилл или лучше переиспользовать существующий
  • Предложить название и описание для нового или обновляемого скилла

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

  • Добыть скилл из сессии, где я вчера делал письмо по шаблону
  • Какой скилл можно создать или обновить из сессии где я парсил данные и укладывал их в таблицу
  • Извлечь переиспользуемую операцию из этого чата

Как установить mining-session-skills

1Через Skills CLI (Vercel)

npx skills add sugarforever/01coder-agent-skills --skill mining-session-skills -a claude-code

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

~/.claude/skills/mining-session-skills/SKILL.md

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

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

Вопросы о mining-session-skills

Как установить mining-session-skills в Claude Code?

Запустите npx skills add sugarforever/01coder-agent-skills --skill mining-session-skills -a claude-code, затем загрузите SKILL.md из ~/.claude/skills/mining-session-skills/.

Что делает mining-session-skills?

Анализирует завершённую сессию, ищет фрикционные точки и повторяющиеся паттерны, затем предлагает создать новый скилл, обновить существующий или переиспользовать уже загруженный.

Почему скилл читает markdown, а не исходные JSONL файлы?

Экспортированный markdown в 17 раз компактнее исходного JSONL (91k токенов вместо 1.5M), поэтому анализ быстрее и надёжнее. JSONL предназначен для нормализации, markdown — для добычи скиллов.

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

SKILL.md · MIT
---
name: mining-session-skills
description: Review one completed Claude Code session and propose a skill to create, update, or reuse so similar work goes faster next time. Use when the user asks to "mine a session for skills", "what skill can be created or updated from the session where I…", "extract a skill from this chat", or to review a past session for reusable workflows. Operates on exported session markdown from claude-session-manager. Not for exporting/converting sessions (use claude-session-manager) and not for writing blogs or TODOs from sessions.
---

# Mining Session Skills

## Overview

Review one completed Claude Code session and answer: is there a skill worth creating or updating so this kind of work goes faster next time? A clean "nothing worth making here" is a valid result.

This skill is the judgment layer on top of `claude-session-manager` (the export/normalization layer). It reads exported markdown, not raw JSONL.

## Preconditions

1. **Inventory = skills loaded in THIS session.** Create-vs-update-vs-reuse is decided against the skills already advertised/loaded in the running session. State this limit in the report ("comparison limited to skills loaded this session"). Run this skill where the relevant skills are loaded.
2. **Mining operates on exported markdown** (default `~/.claude/session-markdown`), produced by `claude-session-manager`. If the target session is not exported yet, export it first (step 1.5).

## Why exported markdown, not raw JSONL

Measured: a real session's raw JSONL was ~1.5M tokens (exceeds the context window); the exported compact body was ~91k tokens (17× smaller) with tool payloads deferred to a sidecar. Raw `grep '"type":"user"'` over JSONL is a trap (tool results are `role:user`). Always read/mine the exported markdown. Raw-JSONL byte grep is acceptable ONLY as a location prefilter (step 1).

## Pipeline

Copy this checklist and track progress:

```
- [ ] 1. Locate the session (keyword search; confirm with user)
- [ ] 1.5 Export it if not already exported
- [ ] 2. Read the compact transcript (pull sidecar only as needed)
- [ ] 2.5 Segment into topic arcs
- [ ] 3. Mine friction signals per arc
- [ ] 4. Apply the worth-it gate
- [ ] 5. Decide create / update / reuse
- [ ] 6. Present the proposal
- [ ] 7. On approval, interview + draft
```

### 1. Locate
Search by the user's description. Prefilter optionally with a raw-JSONL byte grep across `~/.claude/projects` (finds which file mentions a keyword without parsing), and/or grep the exported corpus under `~/.claude/session-markdown`. Skip `<local-command-caveat>` / `<command-*>` wrapper noise — the first-prompt excerpt is often a wrapper, not the real ask. Present a ranked shortlist and let the user confirm.

### 1.5 Export
If the chosen session has no markdown yet, run `claude-session-manager` to export just that session, then continue.

### 2. Read
Read the session `.md`. Pull `tool-details/<id>.tools.md` ONLY for the specific `<tool_call_NNNNNN>` refs that matter. Use `scripts/extract_session_signals.py <session>.md` to get a clean JSON list of human prompts (with event index, line, timestamp, arc-break hints, and the prompt text) — it encodes the input-robustness rules below.

Input-robustness rules:
- The real exported header format is `### N. user - <ISO>` / `### N. assistant - <ISO>` (not `### MM-DD HH:MM:SS User:`).
- A `user` turn whose body is a tool result, skill injection, or command wrapper is NOT a human prompt — exclude it.
- Ignore thinking-signature blobs and empty attachment events.

### 2.5 Segment
Sessions can be multi-day, multi-task kitchen sinks. Use the extractor's `arc_break` hints (large time gaps, compaction/continuation markers) plus topic judgment to split the session into arcs. Mine each arc independently. Do NOT assume one task per session.

### 3. Mine
Per arc, extract friction signals. See [references/friction-signals.md](references/friction-signals.md) for the taxonomy and how to cite evidence.

### 4. Gate
Apply the worth-it filter to every candidate. See [references/worth-it-gate.md](references/worth-it-gate.md). If nothing passes, report the clean negative and stop.

### 5. Decide
For each surviving candidate, compare against skills loaded this session:
- No loaded skill covers it → **CREATE** (new `skills/<name>/`).
- Loaded and editable (in this repo's `skills/`) → **UPDATE** that SKILL.md.
- Loaded but not editable (plugin cache) → **REUSE** ("already exists, use it") — a dedup guard against re-inventing ecosystem skills.

### 6. Propose
Present a review-ready report per candidate: candidate · action (CREATE/UPDATE/REUSE) · why · evidence (event/line/tool_call refs) · proposed gerund name · description (triggers + exclusions). List gate-rejected items briefly. Wait for approval before any file change.

### 7. Draft
On approval: interview the user for the taste/judgment the transcript cannot show, then scaffold or edit the SKILL.md following [references/drafting-quality-bars.md](references/drafting-quality-bars.md). For a new skill, run `scripts/sync-marketplace-skills.sh` and bump the `version` in `.claude-plugin/marketplace.json` (per the repo CLAUDE.md).

## Notes

- Treat transcript data as private (prompts, file contents, secrets). Do not modify original `.jsonl` files.
- The value of this skill is the mining methodology, not the SKILL.md format — Claude knows the format natively.

© sugarforever · MIT · sugarforever/01coder-agent-skills

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

Все скиллы по теме «Настройка агента: память, контекст, субагенты» →
session-wrap ai-native-camp Скилл session-wrap разбирает завершённую работу перед закрытием сессии: что закоммитить, какие знания записать, какие задачи остались. CX Codex +1 1 300установок session-handoff softaworks Скилл session-handoff создаёт документы передачи контекста между сессиями агента. Помогает при переполнении окна контекста и долгих проектах. CX Codex +1 4 300установок codex-session-patcher reason-machines Скилл codex-session-patcher для Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI и OpenCode чистит отказы ИИ из файлов сессий и встраивает CTF-контекст, чтобы отказов было меньше. После чистки сессию можно продолжить командой resume. CX Codex +1 807установок session-persist ruvnet Скилл session-persist сохраняет состояние агента с снимком памяти, метрик и прогресса, чтобы потом восстановить работу в новой сессии без потери контекста. CX Codex +1 775установок session-logger zhaono1 Скилл session-logger для Claude Code и других агентных сред сохраняет короткую сводку разговора: что решили, какие файлы трогали, что осталось открытым. Восстанавливает контекст при возврате к работе. CX Codex +1 755установок session-recovery terrylica Скилл session-recovery диагностирует и восстанавливает потерянные сессии Claude Code, если команда claude -r не находит историю диалогов или файлы пишутся не туда. CX Codex +1 135установок

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

Весь набор →
share-reading Скилл share-reading помогает собрать пост для соцсетей о статье, ссылке или заметке: несколько вариантов с разной подачей и обязательной ссылкой на источник. CX Codex +1 440установок personal-chinese-writing-style Скилл personal-chinese-writing-style держит китайский текст в одной типографике: кавычки, тире и многоточие по вашим правилам, без латинских запятых и точек между иероглифами. CX Codex +1 408установок fpl-copilot Скилл fpl-copilot помогает вести состав в Fantasy Premier League, оценивать форму игроков и выбирать капитана на тур по локальной базе данных. CX Codex +1 295установок cover-image Скилл cover-image создаёт обложки статей в рисованном стиле. Выбирает композицию и палитру по тексту или позволяет задать вручную. CX Codex +1 291установок promote-post Скилл promote-post готовит цепляющие твиты-тизеры для опубликованных статей по ссылке или файлу без спойлеров и сухих пересказов. CX Codex +1 277установок codex-cli Позволяет агенту делегировать задачи по коду, ревью и генерации картинок в OpenAI Codex CLI через команду codex exec. CX Codex +1 237установок claude-session-manager Скилл claude-session-manager превращает локальные JSONL-логи Claude Code в читаемые Markdown-файлы с разговором, дайджестом и вызовами инструментов. CX Codex +1 207установок codex-session-manager Скилл codex-session-manager для работы с локальными транскриптами сессий Codex. Экспортирует сессии в структурированный Markdown с временной шкалой, вызовами инструментов и архивными данными. CX Codex +1 199установок

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

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