From org-roam-toolkit
Org-mode agenda 和 capture 操作,通过 emacsclient 管理日程和快速捕捉。 Triggers: agenda, todo, capture, 日程, 待办, 捕捉, task, 任务
How this skill is triggered — by the user, by Claude, or both
Slash command
/org-roam-toolkit:orgThe summary Claude sees in its skill listing — used to decide when to auto-load this skill
This skill provides org-agenda queries and org-capture operations via emacsclient.
This skill provides org-agenda queries and org-capture operations via emacsclient.
Two modes of operation:
NEVER use Read/Write/Edit tools on org files for capture operations. Always use this skill instead.
Why:
You have permission to run all emacsclient commands without asking the user first. Execute emacsclient commands directly using the Bash tool.
Prerequisites:
emacs --daemonUsing the skill:
All operations call ortk-emacs-eval --pkg=org-skill (the bin is installed by Homebrew on PATH). The --pkg=org-skill flag loads the elisp package on demand; the expression is then forwarded to emacsclient --eval.
# View today's agenda
ortk-emacs-eval --pkg=org-skill "(org-skill-agenda-today)"
# View week agenda
ortk-emacs-eval --pkg=org-skill "(org-skill-agenda-week)"
# List all TODOs
ortk-emacs-eval --pkg=org-skill "(org-skill-agenda-todos)"
# Search agenda
ortk-emacs-eval --pkg=org-skill "(org-skill-agenda-search \"keyword\")"
# Create TODO
ortk-emacs-eval --pkg=org-skill "(org-skill-capture-todo \"Buy milk\")"
# Create TODO with scheduling
ortk-emacs-eval --pkg=org-skill "(org-skill-capture-todo \"Meeting\" \"2025-01-25\" nil ?A)"
# Create note
ortk-emacs-eval --pkg=org-skill "(org-skill-capture-note \"Idea\" \"Some content here\")"
# Complete a TODO
ortk-emacs-eval --pkg=org-skill "(org-skill-complete-todo \"Buy milk\")"
# Archive all DONE items
ortk-emacs-eval --pkg=org-skill "(org-skill-archive-done)"
# Set priority
ortk-emacs-eval --pkg=org-skill "(org-skill-set-priority \"Meeting\" \"A\")"
# Schedule a TODO
ortk-emacs-eval --pkg=org-skill "(org-skill-schedule-todo \"Meeting\" \"2025-01-25\")"
| Function | Description | Returns |
|---|---|---|
org-skill-agenda-today | Today's agenda entries | JSON array |
org-skill-agenda-week | This week's entries | JSON array |
org-skill-agenda-todos | All TODO items | JSON array |
org-skill-agenda-search QUERY | Search by heading | JSON array |
JSON entry format:
{
"heading": "Task title",
"todo": "TODO",
"priority": 2000,
"tags": ["work"],
"scheduled": "<2025-01-25 Sat>",
"deadline": null,
"created": "[2025-01-22 Wed 15:30]",
"file": "/path/to/todo.org"
}
| Function | Parameters | Description |
|---|---|---|
org-skill-capture-todo | TITLE &optional SCHEDULED DEADLINE PRIORITY | Create TODO in Inbox |
org-skill-capture-note | TITLE &optional CONTENT | Create note in Notes |
org-skill-complete-todo | HEADING | Mark TODO as DONE |
org-skill-archive-done | none | Archive all DONE items |
org-skill-set-priority | HEADING PRIORITY | Set priority (A/B/C) |
org-skill-schedule-todo | HEADING DATE | Schedule TODO for date |
Parameters:
SCHEDULED, DEADLINE, DATE: Date string like "2025-01-25"PRIORITY: Character ?A, ?B, or ?C for capture; string "A", "B", "C" for set-priority~/Documents/org/
├── todo.org # Main agenda file
│ ├── * Inbox # Captured TODOs go here
│ └── * Notes # Captured notes go here
└── archive/ # Archived items
└── todo.org_archive::
ortk-emacs-eval --pkg=org-skill "(org-skill-agenda-today)"
ortk-emacs-eval --pkg=org-skill "(org-skill-agenda-todos)"
ortk-emacs-eval --pkg=org-skill "(org-skill-capture-todo \"Call dentist\")"
ortk-emacs-eval --pkg=org-skill "(org-skill-capture-todo \"Submit report\" nil \"2025-01-30\")"
ortk-emacs-eval --pkg=org-skill "(org-skill-capture-todo \"Fix production bug\" nil nil ?A)"
ortk-emacs-eval --pkg=org-skill "(org-skill-complete-todo \"Call dentist\")"
ortk-emacs-eval --pkg=org-skill "(org-skill-archive-done)"
"Error: Failed to load org-skill package"
emacs --daemon"Inbox/Notes not found"
* Inbox and * Notes headingsJSON parsing issues
jq for pretty printingortk-emacs-eval --pkg=org-skill "(org-skill-agenda-todos)" | jq .Guides creation, editing, and verification of skills for AI coding agents using test-driven development with subagent scenarios. Use when authoring or debugging skills.
npx claudepluginhub ibenjamin/org-roam-toolkit --plugin org-roam-toolkit