compact-note — скилл для Claude Code: сжатие заметок
Скилл compact-note для Claude Code сокращает разросшиеся заметки и журналы, сохраняя причины решений. Запускается по просьбе сжать заметку, лог или память.
MIT ★ 26 обновлён 2026-11-16
npx skills add wrg32786/aigent-os --skill compact-note -a claude-codeЧто делает compact-note
Скилл читает заметку целиком и разделяет записи на повторяющиеся правила, важные для решений, завершённые и устаревшие. Правило добавляется, только если паттерн повторялся не менее 3 раз; записи с объяснением причин решений сохраняются.
Затем скилл сворачивает журнал в архивную сводку, оставляет активные темы и обновляет метаданные заметки: отметку о сжатии, дату и соотношение объёма до и после. В конце добавляет журнал изменений с сохранёнными и заменёнными записями и спорными случаями. Частичного чтения недостаточно: перед сжатием нужно прочитать всю заметку.
Какие задачи решает
- сжать разросшийся журнал сессий
- выделить повторяющиеся правила из заметок
- сохранить причины принятых решений
- убрать из заметки завершённые и устаревшие записи
Примеры запросов агенту
- Сожми эту заметку, сохранив причины решений.
- Сократи журнал и выдели повторяющиеся правила.
- Разбери заметку целиком и уплотни её без потери важных записей.
Как установить compact-note
1Через Skills CLI (Vercel)
npx skills add wrg32786/aigent-os --skill compact-note -a claude-code2Вручную: положить файлы
~/.claude/skills/compact-note/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/compact-note/
1Через Skills CLI (Vercel)
npx skills add wrg32786/aigent-os --skill compact-note -a codex2Вручную: положить файлы
.agents/skills/compact-note/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add wrg32786/aigent-os --skill compact-note -a cursor2Вручную: положить файлы
.cursor/skills/compact-note/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install wrg32786/aigent-os skills/compact-note2Вручную: положить файлы
.github/skills/compact-note/SKILL.md1Через Skills CLI (Vercel)
npx skills add wrg32786/aigent-os --skill compact-note -a gemini-cli2Командой платформы
gemini skills install https://github.com/wrg32786/aigent-os --path skills/compact-noteВручную: положить файлы
.devin/skills/compact-note/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add wrg32786/aigent-os --skill compact-note -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о compact-note
Как установить compact-note в Claude Code?
Запусти npx skills add wrg32786/aigent-os --skill compact-note -a claude-code. Файл скилла находится по пути ~/.claude/skills/compact-note/SKILL.md.
Что делает compact-note?
Он уплотняет длинную заметку: выделяет повторяющиеся правила, сохраняет важные причины решений и сворачивает журнал в краткую сводку. Также скилл добавляет журнал изменений.
Как compact-note решает, какие правила выделить?
Правило должно опираться на паттерн, повторившийся не менее 3 раз. Записи с причинами решений сохраняются, а спорные случаи отмечаются в журнале изменений.
Исходный текст
SKILL.md · MIT
--- name: compact-note agent: mnemosyne description: "Compact vault notes into standing rules and a shortened log. Use when a note is bloated, a log needs trimming, or memory needs distilling." allowed-tools: Read, Write, Edit, Grep, Glob user-invocable: true triggers: - compact this note - compact note - this note is too long - compress the log - distill this note - trim the vault note - note is getting bloated - needs compact - compact the memory --- # Compact Note You are Mnemosyne compacting a bloated vault note. Distill signal into standing rules. Truncate raw log. Never compact so aggressively that rationale is lost. ## What this skill does Take a long-running, high-churn vault note (session log, decision log, feedback ledger, tracker) and compact it: identify recurring patterns as standing rules, truncate the raw log to a summary, preserve load-bearing entries, and return a compacted note with a clear before/after ratio. ## Protocol ### Step 1: Read the full note Read the entire note. Do not compact from partial context. Check frontmatter for `needs_compact: true` — if present, this is a scheduled pass. ### Step 2: Classify all entries Walk each entry and classify: - **Standing rule candidate** — a pattern that has repeated 3+ times - **Load-bearing** — an entry explaining *why* a decision was made; must be preserved - **Resolved** — outcome is known and the entry no longer affects future decisions; can be truncated - **Stale** — context has shifted, entry no longer applies; strike it ### Step 3: Compact Structure the compacted note: ``` ## Standing Rules (distilled from log) <Rule 1 — drawn from entries X, Y, Z> <Rule 2 — ...> ## Active Threads (load-bearing, not yet resolved) <Thread A — last updated YYYY-MM-DD> ## Archive (truncated log — full history in git) <Summarized in 1-2 bullets per month or sprint> YYYYMM: <N entries> — <one-line summary of what happened> ``` Update frontmatter: - Set `needs_compact: false` - Add `last_compacted: YYYY-MM-DD` - Add `compaction_ratio: X:1` (original lines / compacted lines) ### Step 4: Return honesty ledger ``` ## Honesty Ledger **Notes touched:** <list> **Entries superseded:** <count> **Entries preserved:** <count — with reason for each load-bearing entry> **Compaction ratio:** X:1 (original N lines → compacted N lines) **Residual uncertainty:** <entries that were ambiguous to classify> ``` ## Constraints - Read the full note before compacting. No partial-context edits. - Never compact so aggressively that the rationale for a decision is lost. - Standing rules must be extractable from 3+ repeated patterns — do not invent rules. - Load-bearing entries (the "why" behind decisions) survive compaction. - If in doubt about an entry's load-bearing status, preserve it and flag it.
© wrg32786 · MIT · wrg32786/aigent-os