inbox-triage
작성자 alirezarezvaniinbox-triage는 inbox-setup 지식 베이스를 바탕으로 반복 실행하거나 필요할 때 실행하는 이메일 triage를 수행합니다. 최근 메일을 분류하고, 발신자를 조사하며, 추천 작업을 제안하고, 전송하지 않는 답장 초안을 작성합니다. 또한 결과를 기록하고, KB 검증·검색 기간 계산·초안 안전성 확인을 위한 helper scripts를 사용해 `${WORKSPACE}/Email/`을 업데이트합니다.
이 skill은 84/100점으로, 반복 실행 또는 필요 시 실행하는 이메일 triage workflow를 원하는 디렉터리 사용자에게 탄탄한 등록 후보입니다. repository 근거상 트리거 안내, workflow 세부 사항, 안전 원칙, 지원 스크립트가 충분해 일반 프롬프트보다 에이전트가 덜 추측하며 실행할 수 있습니다. 다만 함께 쓰는 `inbox-setup` 지식 베이스에 의존하고, 로컬 설치 안내가 없다는 점은 사용자가 이해해야 합니다.
- 트리거하기 쉽습니다. frontmatter에 “triage my inbox”, “check my email”, “process my inbox”처럼 자연스러운 호출 문구가 다수 제시되어 있고, 반복 실행 및 필요 시 실행하는 사용 사례도 명확히 설명합니다.
- 운영 내용이 충실합니다. KB 계약, fail-fast 동작, 최근 이메일 검색 기간 로직, 분류, 발신자 조사, 추천 작업, 초안 생성, 보고, KB 업데이트까지 workflow가 구체적으로 정의되어 있습니다.
- 안전성과 자동화 지원이 좋습니다. “drafts only — never send” 원칙을 강조하며, `draft_safety_validator.py`, `kb_reader.py`, `search_window_calculator.py`가 결정적인 검사와 유틸리티를 제공합니다.
- 작동하려면 먼저 함께 쓰는 `inbox-setup` skill과 정확한 7개 파일로 구성된 `${WORKSPACE}/Email/` 지식 베이스가 필요합니다. 독립형 inbox workflow가 아니라 실제 의존성이 있는 구성입니다.
- skill 디렉터리에 설치 명령이나 README가 없어, 디렉터리 사용자는 이 폴더 밖의 repository 수준 설치 정보를 추가로 확인해야 할 수 있습니다.
inbox-triage skill 개요
inbox-triage가 하는 일
inbox-triage는 기존 개인 이메일 지식 베이스를 바탕으로 구조화된 받은편지함 검토를 실행하는 이메일 워크플로 자동화 skill입니다. 최근 메일을 검색하고, 사용자의 분류 체계에 따라 메시지를 분류하며, 새 발신자를 식별하고, 다음 조치를 추천하고, 답장을 초안으로 작성한 뒤, triage 과정에서 얻은 학습 내용을 ${WORKSPACE}/Email/에 다시 기록합니다.
도입 시 가장 중요한 점은 inbox-setup과 함께 사용해야 한다는 것입니다. inbox-triage skill은 setup이 생성하는 7개 파일 기반 지식 베이스를 전제로 합니다. 여기에는 email-taxonomy.md, email-patterns.md, blocklist.md, tracker.md, 선택적 decision 파일, 그리고 triage-log/ 디렉터리가 포함됩니다.
잘 맞는 사용자와 워크플로
이 skill은 하루 1~3회 반복적으로 이메일을 정리하고 싶거나, 매번 선호사항을 다시 설명하지 않아도 안정적으로 “받은편지함 확인”을 실행하고 싶은 사용자에게 잘 맞습니다. 기회 제안, 진행 중인 스레드, 뉴스레터, 콜드 아웃리치, 후속 연락이 섞여 들어오는 창업자, 컨설턴트, 크리에이터, 운영 담당자, 바쁜 전문직에게 특히 유용합니다.
단순 요약이 아니라 의사결정 지원이 목적일 때 inbox-triage를 Workflow Automation에 사용하세요. 즉, 분류하고, 추천하고, 초안을 만들고, 기록하고, 기억을 업데이트하는 작업에 적합합니다.
핵심 차별점
실질적인 차별점은 안전을 우선하는 자동화 모델입니다. 이 skill은 초안만 생성하며, 이메일을 직접 보내지 않는다는 규칙을 명확히 둡니다. repository에는 references/drafts_only_safety.md와 scripts/draft_safety_validator.py가 포함되어 있으며, 후자는 action log에서 발송 형태의 tool call이 있는지 확인합니다.
또한 결정론적으로 동작하는 보조 도구도 포함되어 있습니다. kb_reader.py는 triage 전에 필수 지식 베이스가 유효한지 검증하고, search_window_calculator.py는 실행 주기에 따라 되돌아볼 검색 범위를 계산합니다.
이 skill이 적합하지 않은 경우
inbox-setup을 실행하지 않았거나 예상되는 ${WORKSPACE}/Email/ 파일을 만들지 않았다면 inbox-triage를 단독 prompt처럼 설치하지 마세요. 완전 자율 발송을 원하거나, 가벼운 1회성 이메일 요약만 필요하거나, 사용자별 분류 체계와 답장 스타일을 무시하는 시스템을 기대하는 경우에도 적합하지 않습니다.
inbox-triage skill 사용 방법
inbox-triage 설치 맥락
GitHub skill repository에서 다음 명령으로 skill을 설치합니다.
npx skills add alirezarezvani/claude-skills --skill inbox-triage
그다음 agent가 다음 skill path에 접근할 수 있는지 확인합니다.
productivity/email/skills/inbox-triage
첫 실행 전에는 SKILL.md를 확인한 뒤, references/kb_file_contract.md, references/drafts_only_safety.md, references/triage_decision_framework.md를 읽어보세요. 검증 동작을 이해하려면 scripts/kb_reader.py, scripts/search_window_calculator.py, scripts/draft_safety_validator.py를 함께 살펴보는 것이 좋습니다.
사용 전 필요한 입력
이 skill은 ${WORKSPACE}/Email/이 포함된 workspace가 필요합니다. 최소 필수 파일은 email-taxonomy.md, email-patterns.md, blocklist.md, tracker.md이며, triage-log/는 디렉터리로 존재해야 합니다. evaluation-framework.md와 rate-card.md가 있으면 기회, 가격, VIP, pass/take 신호에 대한 판단 품질이 좋아집니다.
KB가 없거나 형식이 잘못되어 있으면, 의도된 동작은 실행을 중단하고 사용자에게 먼저 /cs:inbox-setup을 실행하라고 안내하는 것입니다. 이 fail-fast 동작은 agent가 triage 규칙을 임의로 지어내는 것을 막아줍니다.
skill을 잘 호출하는 강한 prompt
약한 prompt의 예는 다음과 같습니다. “Check my email.”
더 나은 inbox-triage 사용 prompt는 다음과 같습니다. “Run inbox-triage for my normal 2x-daily cadence. Use my existing ${WORKSPACE}/Email/ knowledge base, search only the current window, classify new messages, draft replies but do not send anything, update tracker.md and blocklist.md where appropriate, and give me the report in my preferred format.”
필요할 때만 실행하는 경우에는 override를 포함하세요. “Run inbox-triage for the last 24 hours because I missed the morning pass. Do not skip opportunity emails. Draft replies only.”
첫 실행을 위한 실전 워크플로
처음에는 감독하에 dry run처럼 시작하세요. agent에게 KB를 검증하고, 검색 범위를 계산하고, 사용할 예정인 카테고리를 나열하고, 발송 action을 사용하지 않을 것임을 확인하게 합니다. 그런 다음 메시지를 처리하고, 초안을 만들고, triage report를 생성하도록 진행합니다.
리포트를 받은 뒤에는 세 가지를 검토하세요. 잘못 분류된 이메일, 내 말투와 다르게 느껴지는 초안, 그리고 tracker.md 또는 blocklist.md에 기록된 업데이트입니다. 이후 실행이 지식 베이스에 의존하기 때문에, 이 수정 작업은 효과가 매우 큽니다.
inbox-triage skill FAQ
inbox-triage가 이메일을 보내나요?
아니요. 핵심 안전 규칙은 초안만 작성하는 것입니다. 이 skill은 사용자가 검토할 답장 초안을 만들도록 설계되어 있으며, 이메일을 전송하지 않습니다. 포함된 validator는 triage action log에서 Gmail 또는 Outlook send call 같은 발송 유사 작업을 스캔할 수 있고, 그런 작업이 나타나면 실행을 실패 처리할 수 있습니다.
일반 이메일 prompt보다 나은 점은 무엇인가요?
일반 prompt도 이메일을 요약할 수는 있지만, 안정적인 기억, 발신자별 규칙, 주기 기반 검색 범위, 초안 안전 원칙, 반복 가능한 추천 프레임워크가 부족한 경우가 많습니다. inbox-triage skill은 정의된 KB contract를 읽고, taxonomy를 사용하며, TAKE IT / WORTH CONSIDERING / PASS / FLAG FOR REVIEW 결정을 적용하고, 결과를 기록합니다.
inbox-triage는 초보자에게도 쉬운가요?
설정이 끝난 뒤에는 초보자에게도 비교적 쉽습니다. skill installer를 실행하고 agent가 이메일 도구와 workspace 파일에 접근하도록 허용하는 데 익숙하다면, 일상적인 호출은 간단합니다. 초기 장벽은 inbox-setup에 대한 의존성과 정확한 ${WORKSPACE}/Email/ 파일 구조입니다.
어떤 이메일 환경을 지원할 수 있나요?
이 skill은 특정 제공업체 하나가 아니라 이메일 도구의 동작을 중심으로 작성되어 있습니다. safety reference에는 Gmail과 Outlook/Microsoft Graph의 draft-style operation이 언급되어 있습니다. 실제 성공 여부는 agent 환경에 발송 권한 없이 이메일 검색, 읽기, 초안 생성 권한이 있는지에 달려 있습니다.
inbox-triage skill 개선 방법
더 나은 KB 파일로 inbox-triage 결과 개선하기
inbox-triage를 가장 빠르게 개선하는 방법은 email-taxonomy.md와 email-patterns.md를 더 구체적으로 만드는 것입니다. 건너뛸 뉴스레터, 우선 표시할 VIP, 검토할 기회, 당일 답장이 필요한 스레드의 예시를 추가하세요. “짧고 따뜻하게, 느낌표는 쓰지 않기” 또는 “요청받았을 때만 가격 포함” 같은 목소리 규칙도 넣어두면 좋습니다.
기회 triage가 중요하다면 evaluation-framework.md와 rate-card.md를 꾸준히 관리하세요. 이 파일들은 애매한 “maybe” 추천을 줄이고, 초안에 구체적인 다음 단계, 가격 입장, 확인 질문이 포함되도록 돕습니다.
흔한 실패 패턴 고치기
skill이 초안을 너무 많이 만든다면 PASS 신호와 blocklist 규칙을 더 엄격하게 조정하세요. 중요한 스레드를 놓친다면 active conversation 신호와 VIP 항목을 확장하세요. 초안이 너무 일반적이라면 email-patterns.md에 수락한 답장과 거절한 답장의 실제 예시를 추가하세요.
검색 범위가 잘못되었다면 search_window_calculator.py가 사용하는 cadence 값을 확인하세요. 하루 1회 실행은 더 넓은 overlap을 사용하고, 하루 2회와 3회 실행은 더 짧은 window를 사용합니다. 평소와 다른 catch-up 세션이라면 명시적으로 시간 override를 제공하세요.
첫 리포트 이후 반복 개선하기
각 실행 후에는 어떤 추천이 맞았는지, 어떤 초안을 편집한 뒤 보냈는지, 어떤 메시지는 건너뛰었어야 했는지를 표시하세요. 그 피드백을 일회성 chat context로만 두지 말고, agent에게 KB 업데이트로 변환하라고 요청하세요.
유용한 후속 prompt 예시는 다음과 같습니다. “Review the last inbox-triage report. Update my taxonomy so emails like X are classified as PASS, add sender Y to VIP, and adjust my draft style to be shorter for cold outreach. Do not change send safety rules.”
안전과 로깅을 강제 가능하게 유지하기
예약 실행에 사용할 경우, prompt와 log에서 drafts-only 규칙이 항상 보이도록 유지하세요. 환경에서 action log를 지원한다면 draft_safety_validator.py를 실행하거나 점검하세요. triage-log/는 검색한 내용, 초안 작성, 건너뛴 항목, 학습된 내용을 추적하는 감사 기록이므로 정리된 상태로 유지하는 것이 좋습니다.