<!-- Line count target: keep SKILL.md body under 400 lines (hard limit: 500). --> <!-- Run: wc -l SKILL.md to check. Move overflow sections to references/ with links below. -->

Productivity OS

GTD productivity system stored in ~/productivity/ as markdown files. Five workflows: capture, process inbox, daily review, evening reflection, weekly review. All data lives in ~/productivity/ (not in the skill directory). File format specs in references/file-formats.md; streak algorithm in references/streak-algorithm.md; review output templates in references/review-templates.md.

First Use

On any productivity action, check if ~/productivity/ exists. If not:

• Create ~/productivity/inbox.md with content: "# Inbox\n"
• Create ~/productivity/tasks.md with content: "# Tasks\n\n## Today\n\n## This Week\n\n## Someday\n"
• Create ~/productivity/goals.md with content: "# Goals\n"
• Create ~/productivity/habits.md with content: "# Habits\n\n## Daily\n\n## Weekly\n"
• Create directory ~/productivity/daily/
• Confirm: "Created ~/productivity/ with empty files. Ready to use."

Capture (Quick Inbox Add)

Triggers: "add to inbox", "capture", "add task", "add goal". Steps:

1. Check ~/productivity/ exists (create if missing — see First Use)
2. Append item to ~/productivity/inbox.md: - [ ] [item text with any @context #tags due:date the user provided]
3. Do NOT ask follow-up questions. Capture exactly what the user said, preserving their words.
4. Count items remaining in inbox.md
5. Confirm: "Added to inbox. [N] items in inbox."

For "add task" (not capture): if user specifies urgency (today/this week), go to inbox then note it belongs in tasks.md Today or This Week when processed. Still go to inbox first — process step classifies.

Process Inbox

Triggers: "process inbox", "review inbox", "what's in my inbox", and during daily review morning triage. Steps:

1. Read ~/productivity/inbox.md and list all items
2. For each item, PROPOSE a classification — do not move without confirmation:
   • Action required + can do in ~2 min → "Move to tasks.md Today?"
   • Action required + this week → "Move to tasks.md This Week?"
   • Action required + long-horizon / multi-step → "Create as goal in goals.md?"
   • Recurring behavior to build → "Add to habits.md?"
   • Reference info → "This looks like reference material — belongs in recall, not productivity. Delete from inbox?"
   • Not actionable / no longer relevant → "Delete?"
3. Move or delete ONLY after explicit user confirmation per item
4. After all items: report how many moved to each destination

Daily Review (Morning)

Triggers: "daily review", "plan my day", "morning planning", "what should I do today", "what's on my plate". Steps:

1. Read ~/productivity/tasks.md — extract items in ## Today section + any past-due items from ## This Week (due date < today)
2. Read ~/productivity/habits.md — identify all ## Daily habits, plus any ## Weekly habits due today (e.g., if habit has "(target: Monday)" and today is Monday)
3. For each habit, calculate current streak from daily log files in ~/productivity/daily/ (see references/streak-algorithm.md for full algorithm)
4. Read ~/productivity/goals.md — for each goal with Status: Active, count open tasks and compute days until next incomplete milestone
5. Check inbox.md — report count if > 0
6. Surface calendar context ONLY if user mentioned a meeting/appointment in this conversation session. Do NOT attempt filesystem or API calendar reads.
7. Present morning briefing (see references/review-templates.md for exact format). Keep it concise — tasks, habits with streaks, goal pulse, inbox count.
8. Offer: "Process your inbox?" if inbox has items.

Evening Reflection

Triggers: "evening reflection", "end of day", "what did I do today", "daily reflection". Steps:

1. Ask (or accept inline answers to) three questions:
   • What got done today?
   • What moved or got blocked?
   • What's tomorrow's top priority?
2. Create or append to ~/productivity/daily/[YYYY-MM-DD].md:
   • Section: ## Evening Reflection with Generated: [datetime]
   • Subsections: ### What got done?, ### What moved or got blocked?, ### What's tomorrow's top priority?
   • User's answers verbatim (or paraphrased if user spoke in natural language)
3. Section: ## Habits Completed Today
   • List habits the user says they completed as - [x] Habit name
   • Ask: "Which habits did you complete today?" if user hasn't mentioned
4. Confirm: "Evening reflection saved to daily/[date].md"

NOTE on habit checkboxes: habits.md uses - [ ] as a PRESENCE MARKER, not a completion tracker. Never update habits.md checkboxes to mark daily completion. Completion lives ONLY in daily/YYYY-MM-DD.md under ## Habits Completed Today.

Weekly Review

Triggers: "weekly review". Steps:

1. TASK AUDIT — read tasks.md:
   • List items in ## Today and ## This Week
   • For each item: propose "still relevant? → keep / reschedule / delete"
   • After audit: move any reschedules, delete closed items (mark - [x] then remove — user confirmed no archive)
2. GOAL PROGRESS — read goals.md:
   • For each Active goal: report milestone progress, open task count, days until deadline
   • Ask if any goals should be moved to Someday or Done
3. HABIT STREAKS — calculate weekly rates:
   • For each habit in habits.md, count how many of the last 7 daily log files show - [x] [habit] in ## Habits Completed Today
   • Report as percentage: "Morning walk: 5/7 days (71%)"
4. STALE INBOX ITEMS — approximate detection:
   • Find most recent weekly review log in ~/productivity/daily/ (file named *-weekly.md or containing "## Weekly Review")
   • Items present in inbox before that review date are flagged as stale (approximation — capture dates not stored)
   • Present stale items: "These may be 7+ days old. Act, defer, or delete?"
5. NEXT WEEK PLAN — ask user to set top 3 priorities for the coming week and add them to tasks.md ## This Week
6. Save review log to ~/productivity/daily/[YYYY-MM-DD]-weekly.md (separate file from daily log)

Habit Tracking

Triggers: "habit streak", "track habit", "mark habit done", "habits today".

• To add a habit: append to habits.md under ## Daily or ## Weekly section
• To mark done: append - [x] [habit name] under ## Habits Completed Today in today's daily log
• To check streak: calculate using daily log files (see references/streak-algorithm.md)
• Streak display: 0 days = "no current streak"; 1-29 days = "streak: N days"; 30+ days = "streak: N days"

References

• See references/file-formats.md for exact markdown spec for each data file
• See references/review-templates.md for morning briefing and review output formats
• See references/streak-algorithm.md for habit streak calculation algorithm and edge cases