context-budget

context-budget skill 개요

context-budget skill이 하는 일

context-budget skill은 agents, skills, rules, MCP servers가 Claude Code 세션 컨텍스트를 얼마나 소비하는지 점검합니다. 역할은 단순합니다. 토큰이 어디서 쓰이는지 찾아내고, 실제로 비싼 부분을 가늠한 뒤, 막연한 “프롬프트를 줄이세요”식 조언이 아니라 우선순위가 정리된 정리 작업으로 바꾸는 것입니다.

context-budget를 설치하면 좋은 사람

이 skill은 비단순한 Claude Code 구성을 관리하는 사람에게 가장 잘 맞습니다. 예를 들면 custom agents가 여러 개 있거나, skills/ 폴더가 점점 커지고 있거나, rule 파일이 여러 겹으로 쌓여 있거나, MCP 서버가 여러 개인 경우입니다. 세션이 느려진 것 같거나, 출력이 흔들리거나, 도구를 하나 더 붙였을 때 품질이 떨어질지 확신이 없다면 context-budget은 꽤 좋은 선택입니다. 반대로 파일이 몇 개 없는 단순한 구성에서는 효용이 크지 않습니다.

일반적인 프롬프트보다 이 skill을 고르는 이유

일반적인 점검 프롬프트는 모델에게 “군더더기를 찾아보라”고만 시킬 수 있지만, context-budget은 더 구조적인 작업 흐름을 제공합니다. 구성 요소를 목록화하고, 토큰 부하를 추정하고, 흔한 병목을 표시하고, 복사된 skill의 중복 계산을 피하고, 절감 효과가 큰 항목을 순위별로 제시합니다. 그래서 context-budget skill은 Skill Testing에 특히 유용합니다. 추측을 줄이고, 반복 가능한 검토 경로를 만들어 주기 때문입니다.

설치 전에 알아둘 핵심 한계

이 skill은 추정과 우선순위 정리에 초점을 둔 도구이지, 바이트 단위로 정확한 tokenizer도 아니고 자동 리팩터링 도구도 아닙니다. 큰 파일, 장황한 frontmatter, 겹치는 rules, tool 수가 많은 MCP servers처럼 실제 부담 신호를 중심으로 봅니다. 런타임 토큰을 정확히 계산해야 한다면, 여기서 나오는 수치는 방향성 지표로만 보고 수동 검토의 우선순위를 정하는 데 사용하세요.

context-budget skill 사용 방법

워크플로우에 context-budget 설치하기

이 repository는 이 skill만 따로 배포하는 별도 패키지를 노출하지 않습니다. 실제로는 parent repo에서 설치한 뒤 거기서 context-budget skill을 호출하는 방식으로 씁니다. 흔한 시작 명령은 다음과 같습니다.

npx skills add affaan-m/everything-claude-code --skill context-budget

설치 후에는 skill이 실제로 installed skills 아래에 들어갔는지 확인하고, 실행 전에 의도된 점검 흐름을 이해하고 싶다면 source repo의 skills/context-budget/SKILL.md를 열어보세요.

context-budget skill에 필요한 입력

context-budget skill은 실제 Claude Code workspace 구조를 지정해 줄 때 가장 잘 작동합니다. 유용한 입력은 다음과 같습니다.

• agents/*.md
• skills/*/SKILL.md
• rules/**/*.md
• .mcp.json 또는 활성 MCP 설정
• 평소 세션에서 실제로 무엇이 로드되는지에 대한 메모

“컨텍스트를 점검해줘”라고만 묻지 마세요. 더 좋은 요청은 이런 식입니다. “agents/, skills/, rules/, .mcp.json 전반의 토큰 오버헤드를 점검해줘. 무거운 파일, 중복된 skill, 겹치는 rule, MCP tool schema 비용을 추정하고, 영향 대비 노력 기준으로 상위 5개 절감 항목을 반환해줘.”

거친 목표를 강한 context-budget 프롬프트로 바꾸기

약한 프롬프트는 대개 막연한 요약만 요구합니다. 강한 context-budget 사용 프롬프트는 범위, 출력 형식, 판단 기준을 분명히 합니다. 예시는 다음과 같습니다.

“이 repo에 context-budget skill을 사용해줘. 모든 agents, skills, rules, MCP servers를 목록화하고, 가정을 분명히 적어 token consumption을 추정해줘. .agents/skills/ 아래에 미러링된 동일한 duplicated skills는 중복 계산하지 말고, 무거운 파일과 불필요하게 반복된 rule 내용을 표시해줘. immediate, medium, low 우선순위로 줄일 항목을 추천하고, 각 항목의 예상 절감량과 제거 시 위험도도 함께 제시해줘.”

이 프롬프트가 품질을 높이는 이유는 측정, 중복 제거, 우선순위 결정을 분리해서 시키기 때문입니다.

가장 좋은 워크플로우와 먼저 읽을 것

먼저 SKILL.md를 읽으세요. 전체 방법이 들어 있습니다. 특히 다음 항목에 집중하면 좋습니다.

1. When to Use
2. How It Works
3. Phase 1: Inventory
4. Phase 2 분류와 권장 사항

실사용에서는 다음 순서가 가장 좋습니다.

1. 넓게 한 번 점검합니다.
2. 가장 큰 병목을 수동으로 확인합니다.
3. 한 번에 한 범주씩 제거하거나 통합합니다.
4. 변경할 때마다 context-budget skill을 다시 실행합니다.

이 방식은 큰 정리를 하다가 유용한 동작까지 깨뜨리는 일을 막으면서도, 컨텍스트 여유는 빠르게 회복하게 해 줍니다.

context-budget skill FAQ

작은 설정에도 context-budget가 가치가 있나요?

대개는 아닙니다. skill이 몇 개 없고 MCP가 복잡하게 얽혀 있지 않다면, 일반적인 점검만으로도 충분한 경우가 많습니다. 환경에 구성 요소가 많아져서 보이지 않는 오버헤드가 품질에 영향을 주거나, 앞으로 기능을 더 붙이는 것이 위험해질 때 context-budget의 가치가 커집니다.

context-budget는 일반적인 repo review 프롬프트와 어떻게 다른가요?

일반 프롬프트는 보통 내용 품질을 봅니다. context-budget은 context cost를 봅니다. 중복 설치된 skill, 너무 긴 설명, 겹치는 rules, MCP tool schema의 부피처럼 놓치기 쉬운 오버헤드 원인에 맞춰져 있습니다. 이 더 좁은 초점 덕분에 “내 설정을 최적화해줘” 같은 넓은 요청보다 더 잘 맞을 수 있습니다.

초보자도 context-budget skill을 사용할 수 있나요?

네, Claude Code 설정 파일과 폴더를 구분할 수만 있다면 가능합니다. 깊은 tokenization 지식은 필요하지 않습니다. 초보자가 조심해야 할 점은 “large file” 경고만 보고 유용한 가이드를 과하게 지워버리는 것입니다. 먼저 skill로 후보를 순위화한 뒤, 영향이 큰 항목은 실제로 확인하고 삭제하세요.

언제는 context-budget를 쓰지 않는 게 좋나요?

문제가 컨텍스트 부하와 무관한 모델 동작일 때는 건너뛰세요. 예를 들면 작업 지시가 약하거나, 예시가 부적절하거나, 권한이 부족한 경우입니다. 또 정확한 tokenizer 계산이나 자동 편집이 필요할 때도 마찬가지입니다. context-budget guide는 진단과 우선순위 정리를 위한 것이지, 정확한 회계나 원클릭 수정용이 아닙니다.

context-budget skill 개선 방법

더 나은 repo 맥락과 활성 로드 가정을 제공하기

context-budget 결과를 가장 잘 개선하는 방법은 실제 세션에서 무엇이 로드되는지 정확히 알려주는 것입니다. 항상 켜져 있는 rules와 거의 쓰지 않는 rules를 구분하고, 활성 MCP servers와 설정만 되어 있으나 비활성인 서버를 구분하세요. 이 정보가 없으면 skill이 영향이 작은 요소를 과대평가하고, 진짜 병목을 과소평가할 수 있습니다.

단순한 개수보다 순위가 매겨진 tradeoff를 요구하기

토큰 추정치만으로는 부족합니다. context-budget skill에 영향, 노력, 위험도를 기준으로 결과를 점수화해 달라고 요청하세요. 예를 들어 이렇게 말할 수 있습니다. “고유한 기능을 잃지 않으면서 의미 있는 컨텍스트를 절약할 수 있는 권장 사항을 우선해줘.” 이렇게 하면 길지만 꼭 필요한 skill을 먼저 지우고, 중복된 rule 텍스트는 그대로 두는 식의 나쁜 조언을 피할 수 있습니다.

흔한 실패 모드를 조심하기

가장 큰 실패 모드는 미러링된 파일을 두 번 세는 것, 모든 도구를 똑같이 비싸다고 보는 것, 큰 파일이면 자동으로 낭비라고 가정하는 것입니다. skill에게 다음을 구분해서 보라고 지시하세요.

• duplicated content와 unique content
• static overhead와 자주 쓰는 context
• bloated frontmatter와 꼭 필요한 operational instructions

이렇게 해야 출력이 실제 의사결정에 바로 쓸 수 있는 수준이 됩니다.

각 정리 후 context-budget을 다시 실행하기

한꺼번에 많은 편집을 하고 잘 되길 바라는 방식은 피하세요. context-budget skill은 반복적으로 쓰는 것이 좋습니다. 점검하고, 한 묶음을 바꾸고, 다시 점검하고, 비교하세요. 그러면 정리가 실제로 쓸 수 있는 컨텍스트 여유를 만들었는지, 아니면 복잡성만 다른 곳으로 옮겼는지 알 수 있습니다. Skill Testing에서는 이런 반복 실행이 단발성 보고서보다 실제 워크플로우 개선 여부를 확인하는 가장 빠른 방법입니다.