token-budget-advisor

token-budget-advisor 스킬 개요

token-budget-advisor는 응답이 생성되기 전에 답변의 깊이를 고르는 라우팅 스킬입니다. 기본 크기의 답변을 그대로 받기보다, 길이·상세도·토큰 사용량을 직접 조절하고 싶은 사용자에게 가장 잘 맞습니다. 핵심 작업은 단순합니다. 다음 응답을 짧게, 균형 있게, 또는 완전하게 할지 일찍 결정해서 불필요한 출력을 줄이는 것입니다.

token-budget-advisor가 해결하는 문제

이 token-budget-advisor 스킬은 사용자가 “짧게”, “간단히”, “tldr”, “전체 설명해줘”라고 말하거나 토큰 사용량 자체를 관리하려고 할 때 특히 유용합니다. 모호한 길이 선호를 명시적인 깊이 선택으로 바꿔 주기 때문에 추측을 줄여 줍니다. 그래서 단순한 “간결하게 답해라” 지시보다 더 쓸모 있습니다. 먼저 크기 결정을 가로채고 정리하도록 설계되어 있기 때문입니다.

가장 잘 맞는 사용자와 워크플로

이 스킬은 답변 크기가 중요한 에이전트와 워크플로에 잘 맞습니다. 예를 들어 워크플로 자동화, 대화형 어시스턴트, 지원 티어링, 그리고 긴 답변이 비용이나 소음을 키울 수 있는 모든 환경이 그렇습니다. Workflow Automation용 token-budget-advisor는 특히 시스템이 일회성 프롬프트 스타일이 아니라 사용자 의도에 따라 답변 깊이를 일관되게 고르는 규칙이 필요할 때 유용합니다.

이 스킬을 설치해야 하는 이유

핵심 문제를 콘텐츠 품질이 아니라 응답 크기에서 느낀다면 token-budget-advisor를 설치할 가치가 큽니다. 콘텐츠 생성용 프롬프트보다 “모델이 얼마나 말해야 하는가?”를 안정적으로 결정하는 계층이 필요할 때 가장 유용합니다. 이미 대화에서 길이를 명시했다면, 이 스킬은 보통 개입하지 않는 편이 맞습니다.

token-budget-advisor 스킬 사용 방법

설치하고 소스 위치 찾기

리포지토리의 스킬 경로를 사용해 affaan-m/everything-claude-code 안의 skills/token-budget-advisor 폴더에서 token-budget-advisor를 설치하세요. 트리거 로직과 결정 흐름은 SKILL.md에 있으므로 여기서부터 시작하는 것이 좋습니다. 디렉터리를 기준 소스로 쓰는 경우에는 자동화에 연결하기 전에 정확한 설치 경로와 진입 파일을 먼저 확인하세요.

대략적인 요청을 실제로 쓸 수 있는 프롬프트로 바꾸기

좋은 token-budget-advisor 사용 프롬프트는 작업과 원하는 깊이 선택을 함께 말합니다. 예를 들어, “사용자가 제품 요약을 원한다. 옵션을 묻는다면 답하기 전에 short / medium / detailed를 제안하라”처럼 적을 수 있습니다. 더 나은 입력은 시간, 비용, 가독성, 인라인 표시 여부처럼 중요한 제약도 함께 담습니다. 그래야 스킬이 예산을 고를 현실적인 근거를 갖게 됩니다.

결정 규칙은 먼저 읽기

token-budget-advisor 설치를 판단할 때는 먼저 SKILL.md를 읽고, 언제 트리거할지, 언제 트리거하지 않을지, 그리고 깊이 선택이 어떻게 이뤄지는지 정의한 섹션에 집중하세요. 가장 중요한 정보는 트리거 문구, “do not trigger” 사례, 단계별 예산 산정 로직입니다. 이런 부분이 실제 운영 환경에서 스킬이 예측 가능하게 동작할지 결정합니다.

실무 워크플로에 적용하기

token-budget-advisor를 가장 잘 활용하는 패턴은 이렇습니다. 의도를 감지하고, 필요한 상세 수준을 추정한 뒤, 사용자가 이미 깊이를 정하지 않았다면 선택지를 제시하고, 그다음 선택된 수준으로 답합니다. 이 워크플로는 시스템 프롬프트나 에이전트 정책이 과한 설명 없이 사용자 통제권을 유지해야 할 때 특히 잘 맞습니다. 언제 선택을 물을지, 언제 바로 진행할지를 프롬프트에 명확히 적어 두세요.

token-budget-advisor 스킬 FAQ

token-budget-advisor는 그냥 프롬프트 스타일 도우미인가요?

아닙니다. token-budget-advisor 스킬은 생성이 시작된 뒤에 간결함을 요구하는 도구가 아니라, 응답 깊이를 사전에 결정하도록 돕는 역할입니다. 인터랙티브 시스템에서는 예산을 넘겨 버리는 일이 실제 문제이므로, 이 차이가 중요합니다.

언제 token-budget-advisor를 쓰지 말아야 하나요?

현재 세션에서 사용자가 이미 길이를 정했거나, 답이 한 줄로 끝나는 게 분명하거나, “token”이 인증·결제·세션 토큰을 뜻하는 것이 분명할 때는 쓰지 마세요. 이런 경우에는 token-budget-advisor가 가치를 더하기보다 오히려 마찰만 만듭니다.

초보자도 쓰기 쉬운가요?

네, 응답 길이만 관리하려는 목적이라면 그렇습니다. 범위가 좁기 때문에 전체 포맷팅이나 계획 시스템보다 도입이 쉽습니다. 다만 어떤 경우에 깊이 옵션을 제시하고, 어떤 경우에 바로 답할지 판단하는 감각은 익혀야 합니다.

일반적인 어시스턴트 워크플로에도 맞나요?

네, 특히 간결함과 완성도를 함께 맞춰야 할 때 잘 맞습니다. token-budget-advisor는 채팅 인터페이스, 자동화 계층, 반복 가능한 응답 크기 규칙이 필요한 에이전트에 적합합니다. 반대로 워크플로에서 사용자에게 길이 선택지를 아예 노출하지 않는다면 효용이 떨어집니다.

token-budget-advisor 스킬 개선 방법

깊이를 더 분명하게 알리기

token-budget-advisor 사용을 개선하는 가장 좋은 방법은 “충분하다”가 무엇인지 더 강하게 신호를 주는 것입니다. “이걸 설명해줘”라고만 하지 말고, “제품 관리자 대상로 5개 bullet로 설명해줘” 또는 “예시 1개를 포함한 간결한 답변으로 줘”처럼 적으세요. 대상, 형식, 길이 제약이 구체적일수록 깊이 선택이 더 쉽고 정확해집니다.

흔한 실패 모드 점검하기

가장 흔한 실패는 사용자가 다른 의미로 “token”을 말했는데도 무조건 트리거되는 경우입니다. 또 하나는 사용자가 이미 깊이를 정했는데도 다시 선택을 묻는 것으로, 불필요한 왕복을 만들게 됩니다. 세 번째는 답이 너무 단순한 요청까지 모두 예산 결정이 필요하다고 보는 것입니다.

첫 답변 후 반복 개선하기

첫 출력이 너무 짧거나 너무 길다면, 다음 지시를 측정 가능한 제약으로 조여 주세요. 예를 들어 bullet 개수, 대략적인 문단 수, 대상 독자를 지정하면 됩니다. 이런 피드백 루프는 “더 자세히”, “더 짧게” 같은 모호한 수정보다 훨씬 효과적입니다. token-budget-advisor는 문구를 고치는 것보다 예산 자체를 다음 턴에서 바로잡을 때 가장 잘 작동합니다.

자신의 스택에 맞게 적용하기

Workflow Automation용 token-budget-advisor라면, 생성 전에 에이전트 정책이나 라우터에 트리거 조건을 인코딩하세요. 결정 규칙은 핸드오프 지점 가까이에 두어 downstream 프롬프트가 명확한 깊이 목표를 받도록 하는 것이 좋습니다. 다른 리포지토리에 맞춰 스킬을 변형하는 경우에는 먼저 trigger/do-not-trigger 로직을 보존하고, 그다음에 표현과 예산 임계값만 조정하세요.