inbox-triage — Claude Code Skill

A Claude Code skill for intelligent inbox triage — scan, classify, scaffold, and move idea files in 4 automated phases. Turn a cluttered inbox/ folder into an organized workspace with AI-powered semantic classification.

inbox/
├── 2026-03-10-build-cli-tool.md   →  projects/build-cli-tool/
├── 2026-03-12-rust-learning.md    →  learning/rust-learning/
├── 2026-03-15-quick-script.md     →  sandbox/quick-script/
└── vague-idea.md                  →  archive/vague-idea/

---

Features

• Phase 1 — Scan: Lists all files in inbox/, excluding README.md
• Phase 2 — Classify: AI-powered semantic classification using intent analysis and filename parsing
• Phase 3 — Confirm & Scaffold: Interactive confirmation + optional project scaffold creation from template
• Phase 4 — Execute & Verify: File movement with metadata prepend, full verification report

---

Installation

1. Copy the skill file into your Claude Code skills directory:

   # Create the skill directory
   mkdir -p ~/.claude/skills/inbox-triage
   
   # Copy SKILL.md
   cp SKILL.md ~/.claude/skills/inbox-triage/SKILL.md

2. Restart Claude Code (or reload skills) — the skill will be auto-detected.

---

Usage

Trigger the skill in any Claude Code session with one of these phrases:

/inbox-triage
inbox-triage
查收inbox
inbox分拣
处理inbox

Claude will immediately start Phase 1 — scanning your inbox/ directory.

---

Workflow

Phase 1 — Scan

Lists all non-README files in inbox/ using the Glob tool. If inbox is empty, outputs ✅ Inbox 已清空，无需分拣。 and terminates.

Phase 2 — Classify

Each file is analyzed using the following intent matrix:

File Type	Classification Logic	Target Path
.md — clear project idea	Has background, goal, and deliverables	projects/{name}/
.md — learning content	Tutorial, research, reading notes	learning/{name}/
.md — quick experiment	Prototype, script validation	sandbox/{name}/
.md — vague / shelved	One-liner idea, unclear scope	archive/{name}/
Asset files (images, code, docs)	Filename semantics → match existing projects/ dir	projects/{project}/data/

The idea name is extracted from the filename by stripping date prefixes and extensions: 2026-03-17-build-cli-tool.md → build-cli-tool

The triage plan is displayed as a Markdown table before any files are moved.

Phase 3 — Confirm & Scaffold

1. Displays the triage plan and asks for confirmation or corrections.
2. For projects/ targets that don't exist: asks whether to scaffold from templates/project-scaffold/.
   • Yes → scaffold is created in Phase 4
   • No → target changed to archive/{name}/ with status 搁置
3. For asset files targeting non-existent projects: asks whether to scaffold or skip.

Phase 4 — Execute & Verify

For .md idea files:

1. Optionally copies templates/project-scaffold/ to the target directory
2. Prepends metadata block to the file:

   ---
   Status: {状态标签}
   Triaged: {YYYY-MM-DD}
   Destination: {target path}
   ---
   

3. Moves the file to {target}/{filename}

For asset files:

1. Ensures data/ subdirectory exists
2. Moves file directly

Verification report:

## 分拣完成 ✅

| 文件名 | 目标路径 | 状态 |
|--------|----------|------|
| file.md | projects/my-project/ | ✅ 已移动 |

Inbox 剩余文件数：0（仅 README.md）

---

Configuration

By default, all paths are relative to the workspace root:

D:\Dev_Env\Claude_Code_Workspace\

To adapt for a different workspace:

1. Open SKILL.md
2. Update the paths in the 注意事项 section at the bottom:

   - 所有路径均基于 workspace 根目录：D:\Your\Custom\Path\
   

3. Update the cp and mkdir commands in Phase 4 accordingly.

---

Requirements

• Claude Code — any recent version with skill support
• Workspace structure:

  workspace/
  ├── inbox/          # Drop files here
  ├── projects/       # Established project ideas
  ├── learning/       # Study material
  ├── sandbox/        # Quick experiments
  ├── archive/        # Shelved ideas
  └── templates/
      └── project-scaffold/   # Optional scaffold template
  

---

License

MIT — free to use, modify, and distribute.