venom: Skill for Claude Code

.claude/skills/compact-guide/SKILL.md

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.

This is KirSsuRyu/venom's own configuration. It tells Claude Code how to work on venom itself, so it is not a mod to install elsewhere. Copy it as a starting point and replace the rules that are about this project. Everything venom configures →

Reuse

Borrowing it

Nothing to install: this file belongs to KirSsuRyu/venom. Take a copy, put it at the same path in your own repository, and replace the rules that are about this project with yours.

Copy the file
curl -O https://raw.githubusercontent.com/KirSsuRyu/venom/main/.claude/skills/compact-guide/SKILL.md
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/github.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/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for compact-guide

Your own site · 80×15
<a href="https://agentmods.dev/skills/kirssuryu/venom/compact-guide"><img src="https://agentmods.dev/badge/skills/kirssuryu/venom/compact-guide.svg" alt="Reviewed on agentmods" width="80" 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. A grade says what 26 rules found in the file — not that it is safe.
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.5 $0.00033 $0.00320
Sonnet 5.5 $0.00016 $0.00160
Haiku 4.5 $0.00008 $0.00080

Measured 1mo ago against content hash d85c6368fa67, method: parsed. Prices are Anthropic first-party input rates as of 2026-10-07, 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 1mo 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. 1mo 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 6mo ago), licensed MIT. It adds 82 tokens to every session and 799 once invoked, about $0.0003 per session on Opus 5.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

knowledge-ingest

Ingest documents, articles, conversations, or supplied text into Knowledge with retained originals, sourced claims, entity updates, timelines, and cross-links; also learn durable lessons from a set of conversations, transcripts, or past sessions (/learn), including the Learn from conversations and Learn from Memory…

openclaw/openclaw · 79 tokens

forget

Remove a personal fact, preference, relationship detail, topic, or prior event from Muse's active memory and stop existing copies or automations from bringing it back. Use for explicit requests such as 'forget that', 'don't remember this about me', or 'remove that from your memory'. Do not use when 'forget it' merely…

asgeirtj/system_prompts_leaks · 74 tokens

mem0-oss-to-platform

Plan, then execute, a migration of a project from the mem0 open-source / self-hosted SDK (local Memory class) to the mem0 Platform / hosted SDK (MemoryClient). TRIGGER when: the developer wants to move, switch, or migrate mem0 off OSS/self-hosted to the hosted API, e.g. "migrate my mem0 setup to the platform", "switch…

mem0ai/mem0 · 217 tokens

Cortex

LifeOS memory, prior-session recall, and learning capture. USE WHEN capture this learning, document this learning, what did we learn recently, recent learnings, cortex, knowledge, knowledge base, search knowledge, what do we know about, archive, harvest, knowledge status, develop note, add to knowledge, add a people…

danielmiessler/LifeOS · 184 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