gtd-assistant

Files (1)

• SKILL.md

SKILL.md (first lines)

# GTD Assistant

A unified productivity agent that doesn't just collect your open loops—it helps you make sense of them. By combining systematic data collection with embedded GTD analysis patterns, this assistant generates comprehensive reports with actionable recommendations tailored to personal productivity contexts.

## What Makes This Different?

Traditional GTD tools tell you what's unfinished. The GTD Assistant tells you:
- **What to tackle first** (context-aware priority suggestions)
- **What can be combined or eliminated** (pattern recognition across loose ends)
- **What needs clarification before action** (identifying vague items that need more thought)
- **How to convert ideas into actionable tasks** (turning dangling thoughts into concrete steps)

## Vault Configuration

| Setting          | Value                 |
| ------------------| -----------------------|
| **Vault path**   | `$HOME/main_vault`    |
| **Obsidian CLI** | Always use `obsidian` |

The vault layout follows the standard structure:
- `00-Tasks/` — all task files organized by domain
- Subfolders like `Work/`, `Privat/`, etc. for project-specific tasks

## When to Use

Activate when the user says:
- "Run a GTD sweep" / "Full GTD review"
- "Help me understand my backlog"
- "What's really unfinished in my vault?"
- "Open loops sweep"
- "Weekly review" / "Monthly review"
- "I feel overwhelmed — what do I have open?"
- "Deeper analysis" (after morning briefing)

## Relationship to Other Skills

### Captain's Log Integration (quest-system)

The GTD Assistant provides **strategic, comprehensive analysis** of all open loops in your vault. For daily tactical planning (what to focus on TODAY), use the `quest-system` skill (Captain's Log briefing — goal-first, with calendar and task collection):

```bash
# For deep dive: GTD assistant
gtd review / help me understand my backlog / open loops sweep

# For daily kickoff: quest-system Captain's Log
good morning / captain's log / what to focus on today?
```

When the `quest-system` briefing completes, it can offer:
- **"Deeper analysis?"** — call `gtd-assistant` for comprehensive view including dangling thoughts and stub notes
- **"Weekly review?"** — recommend full GTD sweep instead of daily briefing

## Workflow Overview

### Phase 1: Comprehensive Collection

Follow the three-pass workflow:

**Pass 1 — Open Tasks**
```bash
# Get total count
obsidian tasks todo total=true

# Get all open tasks grouped by file (JSON format for parsing)
obsidian tasks todo verbose=true format=json
```
Parse JSON output. Group tasks by domain:
- **Inbox / Urgent**: files in `00-Tasks/`
- **Work**: files in `Work/` or with `#work` tag
- **Music / Creative**: files in `03-denkfabrik/` or tagged `#music`
- **House / Personal**: `06 - Tasks - Haus`, `Privat/`, etc.
- **Projects**: everything else

Show top items per group (max 5–7 per group). Skip recurring tasks (`🔁`) in the main list — note them separately.

**Pass 2 — Dangling Thoughts **(keyword search)
```bash
obsidian search query="TODO" format=json limit=30
obsidian search query="idea" format=json limit=30
obsidian search query="later" format=json limit=20
obsidian search query="?" format=json limit=20
```
**Filter out**:
- Files already in `00-Tasks/` (covered in Pass 1)
- Files in `copilot-conversations/`, `ZZ-Archiv/`, `Evernote Import/`
- Lyrics files (`03-denkfabrik/Lyrics/`)

Present as a deduplicated list of notes with dangling content. For each, read a snippet to show *what* is dangling.

**Pass 3 — Stub Notes **(incomplete / abandoned)
```bash
# Run the stub collection script
bash skills/obsidian-open-loops-collector/scripts/collect_stubs.sh $HOME/main_vault
```
This returns lines like: `3\tSome Note.md` (line count, filename).

Group stubs by folder/domain. Highlight any stubs that look like project or idea notes (not just reference stubs). Read the content of interesting-looking ones.

### Phase 2: GTD Analysis Workflow

Apply the following analysis patterns directly to the collected data:

#### Priority Assessment
Given [X] open tasks, [Y] dangling thoughts, and [Z] stub notes across domains like work, music production, house maintenance, and personal projects:
- Identify 3–5 concrete next actions that would give the highest satisfaction return
- Consider context: time available, energy level, upcoming commitments
- Factor in urgency (deadlines visible in task descriptions)
- Balance quick wins with meaningful challenges based on user's stated goals

### Phase 3: Unified Report Generation

Present a structured output that combines both perspectives:

```
## 📊 GTD Assistant Report — [Date]

---

### 🎯 Quick Summary

From Kubementat/ai_agent_skills, MIT.

More from Kubementat/ai_agent_skills