name: org description: Org-mode file manipulation tools. USE WHEN user needs programmatic org-mode operations OR the TODOs skill requires org-manager tool.

Org-Mode Operations

Purpose

Provides programmatic org-mode file manipulation via Emacs batch mode. This skill is primarily used by the TODOs skill for reliable TODO operations.

Context Detection

This skill activates when:

User needs programmatic org-mode file operations
TODOs skill requires org-manager for TODO manipulation
Working with org-mode files (.org) programmatically

Core Tools

org-manager

Location: ~/.config/claude/skills/Org/tools/org-manager

Batch-mode Emacs wrapper for org-mode operations. Returns JSON output for easy parsing.

Output format: {"success": true, "data": [...]}

TODO Operations

# List TODOs with filters
org-manager list ~/desktop/org/todos.org --state=NEXT
org-manager list ~/desktop/org/todos.org --priority=1,2
org-manager list ~/desktop/org/todos.org --tags=work,urgent

# Get scheduled items
org-manager scheduled ~/desktop/org/todos.org
org-manager scheduled ~/desktop/org/todos.org --date=2025-12-10

# Count by state
org-manager count ~/desktop/org/todos.org

# Search (basic mode - metadata only)
org-manager search ~/desktop/org/todos.org "keyword"

# Search with full content
org-manager search ~/desktop/org/todos.org "keyword" --with-content

# Get sections
org-manager sections ~/desktop/org/todos.org

# Get children of heading
org-manager children ~/desktop/org/todos.org "Parent heading"

# Get full TODO content
org-manager get ~/desktop/org/todos.org "Task heading"

# Get overdue tasks
org-manager overdue ~/desktop/org/todos.org

# Get upcoming tasks
org-manager upcoming ~/desktop/org/todos.org --days=7

Write Operations

# Add new TODO
org-manager add ~/desktop/org/todos.org "Task description" \
  --section=Work --priority=2 --scheduled=2025-12-10

# Append content to TODO
org-manager append-content ~/desktop/org/todos.org "Task heading" /tmp/content.org

# Update state
org-manager update-state ~/desktop/org/todos.org "Task heading" DONE

# Schedule task
org-manager schedule ~/desktop/org/todos.org "Task heading" 2025-12-10

# Set deadline
org-manager deadline ~/desktop/org/todos.org "Task heading" 2025-12-15

# Set priority
org-manager priority ~/desktop/org/todos.org "Task heading" 2

# Archive completed items
org-manager archive ~/desktop/org/todos.org

Tag Management

# Add tags
org-manager add-tags ~/desktop/org/todos.org "Task heading" "work,urgent"

# Remove tags
org-manager remove-tags ~/desktop/org/todos.org "Task heading" "urgent"

# Replace all tags
org-manager replace-tags ~/desktop/org/todos.org "Task heading" "new,tags"

# List all tags in file
org-manager list-tags ~/desktop/org/todos.org

Property Operations

# Get property value
org-manager get-property ~/desktop/org/todos.org "Task heading" "CATEGORY"

# Set property
org-manager set-property ~/desktop/org/todos.org "Task heading" "CATEGORY" "work"

# List all properties
org-manager list-properties ~/desktop/org/todos.org "Task heading"

Bulk Operations

# Update state for all matching tasks
org-manager bulk-update-state ~/desktop/org/todos.org TODO DONE

# Add tags to all matching tasks
org-manager bulk-add-tags ~/desktop/org/todos.org NEXT "urgent,review"

# Set priority for all matching tasks
org-manager bulk-set-priority ~/desktop/org/todos.org TODO 1

Time Tracking

# Clock in
org-manager clock-in ~/desktop/org/todos.org "Task heading"

# Clock out
org-manager clock-out ~/desktop/org/todos.org

# Get active clock
org-manager get-active-clock ~/desktop/org/todos.org

# Get clocked time
org-manager get-clocked-time ~/desktop/org/todos.org "Task heading"

Statistics

# Get comprehensive statistics
org-manager get-statistics ~/desktop/org/todos.org

# Get priority distribution
org-manager get-priority-distribution ~/desktop/org/todos.org

# Get tag statistics
org-manager get-tag-statistics ~/desktop/org/todos.org

Export

# Export to CSV
org-manager export-csv ~/desktop/org/todos.org /tmp/todos.csv

# Export to JSON
org-manager export-json ~/desktop/org/todos.org /tmp/todos.json

File Locations

TODOs: ~/desktop/org/todos.org - Task management
Inbox: ~/desktop/org/inbox.org - Quick capture

Requirements

Emacs with org-mode
org-batch-functions.el in ~/.config/emacs/site-lisp/

Examples

Example 1: Manage org headings

User: "Add a new section to my notes"
→ Uses org-manager to manipulate org file structure
→ Adds heading with proper level and content

TODOs - Uses org-manager for TODO operations