# Capture

> Quick capture to GTD inbox from CLI or natural language Use when this capability is needed.

- Skill: `tomevault-io/capture` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add tomevault-io/capture`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/capture/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: tomevault-io (https://skillmd.com/u/tomevault-io)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/tomevault-io/capture

---


# GTD Capture

Fast append to inbox. No priority, no routing — just capture.

## Instructions

1. Take `$ARGUMENTS` as item text
2. Read `/home/mat/dev/gtd-pcm/01-inbox.md`
3. Find `### New` section
4. Insert `- <item> [created:: YYYY-MM-DD]` after section header (newest first), using today's actual date
5. Report: "Captured: <item>"

## Implementation

**Step 1**: Read `/home/mat/dev/gtd-pcm/01-inbox.md`

**Step 2**: Find `### New` section in the file

**Step 3**: Get today's date (use Bash: `date +%Y-%m-%d`)

**Step 4**: Use Edit tool to insert new item:
- old_string: `### New` (exactly as it appears in file)
- new_string: `### New\n- <item text from $ARGUMENTS> [created:: YYYY-MM-DD]` (substitute real date)

**Insert position**: After `### New` header, before any existing items (newest first).

**Example**:
```
Before:
### New
### Prio 1

After capture "buy milk":
### New
- buy milk [created:: 2026-02-23]
### Prio 1
```

## Triggers

**Direct invocation**:
- `/gtd:capture buy milk`
- `/gtd:capture call John about project`

**Natural language** (auto-invoked):
- "add buy milk to inbox"
- "capture: need to call John"
- "inbox: review quarterly goals"

## Notes

- No flags, no parsing — append as-is
- No priority sorting (that's triage)
- Empty New section is OK
- Preserve all other sections unchanged

## Error Handling

**File not found**: If inbox doesn't exist, report error and suggest checking vault path.

**Section not found**: If `### New` section missing, report error and suggest running setup.

**Edit conflict**: If Edit tool fails (e.g., concurrent modification), report error and ask user to retry.

---
> Converted and distributed by [TomeVault](https://tomevault.io/claim/digital-stoic-org) — claim your Tome and manage your conversions.
<!-- tomevault:4.0:skill_md:2026-04-13 -->