compact-guide

compact-guide is a skill for Claude Code from KirSsuRyu/venom. It costs 82 tokens per session (799 once invoked), scanned A, original, MIT.

A guide for deciding when to compress an AI coding session’s context and what to record first.

In plain words
What is it for?
Use it before context compression to check saved work, document decisions, review tests and version-control status, and prepare a clear restart point.
Why use it?
It helps preserve important decisions, lessons, unfinished tests, and next steps when a long session is shortened.

Skill for Claude Code

Written for Claude Code: installed under .claude/. Also seen: mentions Claude Code.

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add skills/kirssuryu/venom/compact-guide
Any agent
npx skills add KirSsuRyu/venom --skill compact-guide
Clone the repo
git clone --depth 1 https://github.com/KirSsuRyu/venom

Made for: Claude Code.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for compact-guide

README.md
[![agentmods](https://agentmods.dev/badge/skills/kirssuryu/venom/compact-guide.svg)](https://agentmods.dev/skills/kirssuryu/venom/compact-guide)
Your own site
<a href="https://agentmods.dev/skills/kirssuryu/venom/compact-guide"><img src="https://agentmods.dev/badge/skills/kirssuryu/venom/compact-guide.svg" alt="Measured on agentmods" height="20"></a>
Per session 82 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 799 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. Scan, not verified.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00082 $0.00799
Opus 5 $0.00041 $0.00400
Sonnet 5 $0.00016 $0.00160
Haiku 4.5 $0.00008 $0.00080

Measured 6d ago against content hash d85c6368fa67, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-06, from the pricing page.

Security

Grade A, and why

compact-guide scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 6d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

.claude/skills/compact-guide/SKILL.md · 65 lines

What it actually says

전략적 컴팩션 가이드

핵심 원칙: 컴팩션은 컨텍스트가 가득 차서 어쩔 수 없이 하는 게 아니라, 작업 단위가 완전히 끝났을 때 전략적으로 하는 것이다. 잘못된 타이밍의 컴팩션은 중요한 컨텍스트를 잃게 만든다.

지금 당장 압축해야 하는 신호 ✅

아래 조건 중 하나라도 해당하면 압축 좋은 타이밍이다:

신호 이유
큰 리서치/분석 블록이 완료됨 결과물은 파일로 저장됐고 과정은 필요 없음
기능/마일스톤 구현 완료 + 테스트 통과 깨끗한 상태에서 새 작업 시작
디버깅 루프 완전 종료 (원인 확정 + 수정) 진단 과정 컨텍스트는 불필요
대규모 리팩토링 완료 중간 단계 흔적이 노이즈가 됨
컨텍스트 사용량이 약 70~80% 여유 있을 때 압축이 더 좋은 요약 생성
작업 전환 (완전히 다른 도메인으로 이동) 이전 컨텍스트가 새 작업에 도움 안 됨

압축하면 안 되는 신호 ❌

신호 이유
진행 중인 디버깅 사이클 중간 가설/사실 수집 컨텍스트가 사라짐
복잡한 멀티파일 리팩토링 중간 변경 계획과 진행 상태가 사라짐
아직 커밋 안 된 중요 결정사항 존재 decisions.md에 먼저 기록 후 압축
오류 메시지 + 수정 시도 반복 중 Iron Law 컨텍스트가 필수

압축 전 체크리스트

압축 명령 실행 전 반드시 확인:

  • 현재 작업의 결과물이 파일로 저장됐는가?
  • 중요한 결정이 .claude/memory/decisions.md에 ADR로 기록됐는가?
  • 이번 작업에서 배운 함정이 lessons.md에 있는가?
  • 미완료 테스트가 없는가? (git status 확인)
  • 다음에 이어서 해야 할 작업이 명확히 정의됐는가?

압축 실행

/compact          # Claude Code 기본 컴팩션

또는 직접 요청:

"지금까지 작업을 요약하고 컨텍스트를 압축해줘"

압축 후 재시작 팁

압축 직후 첫 메시지에서:

  1. 방금 완료한 작업의 상태를 1~2줄로 재확인한다
  2. 다음에 할 작업을 명시한다
  3. session-start.sh가 메모리를 자동 주입하므로 과거 실수는 자동으로 복원됨

안티 패턴

  • 95% 도달할 때까지 기다리는 것 — 강제 압축은 요약 품질이 낮다.
  • 중간 디버깅 중에 압축하는 것 — 문맥을 잃고 처음부터 다시 진단.
  • 압축 전에 메모리 파일을 갱신 안 하는 것 — 교훈이 소멸된다.
Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 6d ago First seen · 65 lines · 82 tokens per session scan A d85c6368fa67

Subscribe to this mod's changes

compact-guide is a skill published in the GitHub repository KirSsuRyu/venom (5 stars, last pushed 4mo ago), licensed MIT. It adds 82 tokens to every session and 799 once invoked, about $0.0004 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.

Related

Other skills, from other repositories

media-ingest

Ingest video, audio, PDF, book, screenshot, and GitHub repo content into the brain. Multi-format handling with entity extraction and backlink propagation. Covers video-ingest, youtube-ingest, and book-ingest subtypes.

garrytan/gbrain · 52 tokens

mem0-oss-to-platform

Plan and then execute a migration of a project from the mem0 open-source / self-hosted SDK (the local Memory class) to the mem0 Platform / hosted / managed SDK (the MemoryClient class). Use this whenever a developer wants to move, switch, or migrate their mem0 usage off OSS/self-hosted to the hosted API — e.g.…

mem0ai/mem0 · 273 tokens

Cortex

Operate Cortex, the LifeOS memory system — the typed Knowledge Archive (People, Companies, Ideas, Research with typed related: links) plus recall of prior work sessions, ISAs, and conversations. Search, add, harvest, develop, ingest, distill, graph-navigate, recall. USE WHEN cortex, knowledge, knowledge base, search…

danielmiessler/LifeOS · 196 tokens

agent-memory

../../../engineering/agent-memory/skills/agent-memory/SKILL.md.

alirezarezvani/claude-skills · 0 tokens

memory

Use when the user asks to remember, recall, forget, update, search, or inspect durable OpenSquilla memory, including profile facts in USER.md and long-term notes in MEMORY.md or memory//.md.

opensquilla/opensquilla · 44 tokens

ha-data-stores

Map of Hope Agent's local data stores and safe read-only query workflow. Use when the user asks where Hope Agent stores data, wants to inspect sessions/messages/memory/logs/background jobs/knowledge indexes/settings, asks the model to query local app data, or debugging requires checking persisted state. Trigger…

shiwenwen/hope-agent · 115 tokens