โ† All skills
Tencent SkillHub ยท Developer Tools

OmniFocus

Manage OmniFocus tasks via JavaScript for Automation (JXA) scripts. Use when the user asks Clawdbot to interact with OmniFocus, including - (1) Adding tasks to inbox, (2) Listing or searching tasks (inbox, available, flagged, overdue, due soon), (3) Completing tasks, (4) Updating task properties (notes, due dates, flags), (5) Getting OmniFocus statistics, (6) Reporting on task status, or (7) Acting on tasks in OmniFocus based on user queries.

skill openclawclawhub Free
0 Downloads
0 Stars
0 Installs
0 Score
High Signal

Manage OmniFocus tasks via JavaScript for Automation (JXA) scripts. Use when the user asks Clawdbot to interact with OmniFocus, including - (1) Adding tasks to inbox, (2) Listing or searching tasks (inbox, available, flagged, overdue, due soon), (3) Completing tasks, (4) Updating task properties (notes, due dates, flags), (5) Getting OmniFocus statistics, (6) Reporting on task status, or (7) Acting on tasks in OmniFocus based on user queries.

โฌ‡ 0 downloads โ˜… 0 stars Unverified but indexed

Install for OpenClaw

Quick setup
  1. Download the package from Yavira.
  2. Extract the archive and review SKILL.md first.
  3. Import or place the package into your OpenClaw setup.

Requirements

Target platform
OpenClaw
Install method
Manual import
Extraction
Extract archive
Prerequisites
OpenClaw
Primary doc
SKILL.md

Package facts

Download mode
Yavira redirect
Package format
ZIP package
Source platform
Tencent SkillHub
What's included
SKILL.md, references/automation-guide.md, references/jxa-api.md, scripts/add_task.js, scripts/complete_task.js, scripts/get_stats.js

Validation

  • Use the Yavira download entry.
  • Review SKILL.md after the package is downloaded.
  • Confirm the extracted package contains the expected setup assets.

Install with your agent

Agent handoff

Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.

  1. Download the package from Yavira.
  2. Extract it into a folder your agent can access.
  3. Paste one of the prompts below and point your agent at the extracted folder.
New install

I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete.

Upgrade existing

I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run.

Trust & source

Release facts

Source
Tencent SkillHub
Verification
Indexed source record
Version
1.0.0

Documentation

ClawHub primary doc Primary doc: SKILL.md 16 sections Open source page

OmniFocus Task Management

Automate OmniFocus task management via JavaScript for Automation (JXA) scripts.

Quick Start

All scripts are located in the scripts/ directory and use JXA. Run with: osascript -l JavaScript scripts/<script-name>.js [args] Key Scripts: add_task.js - Add task to inbox list_tasks.js - List tasks with filters search_tasks.js - Search tasks by keyword complete_task.js - Complete a task by name update_task.js - Update task properties get_stats.js - Get OmniFocus statistics

Adding Tasks

osascript -l JavaScript scripts/add_task.js "Task name" ["Note"] ["YYYY-MM-DD"] Examples: osascript -l JavaScript scripts/add_task.js "Buy groceries" osascript -l JavaScript scripts/add_task.js "Review doc" "Check sections 1-3" osascript -l JavaScript scripts/add_task.js "Submit report" "Q1" "2026-01-31" Returns: Task ID

Listing Tasks

osascript -l JavaScript scripts/list_tasks.js [filter] [limit] Filters: inbox - Inbox tasks available - Available (unblocked) tasks (default) flagged - Flagged tasks due-soon - Due within 3 days overdue - Past due all - All incomplete tasks Returns: JSON array with task details (name, id, note, dueDate, flagged, project, tags)

Searching Tasks

osascript -l JavaScript scripts/search_tasks.js "keyword" [limit] Searches task names and notes. Case-insensitive. Returns: JSON array of matching tasks

Completing Tasks

osascript -l JavaScript scripts/complete_task.js "Task name" Searches inbox first, then all tasks. Completes first match.

Updating Tasks

osascript -l JavaScript scripts/update_task.js "Task name" [--note "text"] [--due "YYYY-MM-DD"] [--flag true/false] Examples: osascript -l JavaScript scripts/update_task.js "Review" --note "Added notes" osascript -l JavaScript scripts/update_task.js "Submit" --due "2026-02-01" osascript -l JavaScript scripts/update_task.js "Important" --flag true

Getting Statistics

osascript -l JavaScript scripts/get_stats.js Returns: JSON with counts: total, incomplete, inbox flagged, overdue, dueSoon available, blocked

When Responding to User Queries

List tasks before acting on them to confirm targets Parse JSON output for structured processing Present results in user-friendly format (not raw JSON) Confirm operations before completing or modifying tasks Handle errors gracefully (task not found, etc.)

Common Patterns

Daily Review: # Statistics overview osascript -l JavaScript scripts/get_stats.js # What needs attention osascript -l JavaScript scripts/list_tasks.js overdue osascript -l JavaScript scripts/list_tasks.js due-soon Task Queries: # "What's in my inbox?" osascript -l JavaScript scripts/list_tasks.js inbox # "What are my next actions?" osascript -l JavaScript scripts/list_tasks.js available 10 # "Show my flagged tasks" osascript -l JavaScript scripts/list_tasks.js flagged Task Management: # "Add a task to call John" osascript -l JavaScript scripts/add_task.js "Call John" # "Find tasks about the project" osascript -l JavaScript scripts/search_tasks.js "project" # "Mark 'Buy milk' as complete" osascript -l JavaScript scripts/complete_task.js "Buy milk" # "Flag the review task" osascript -l JavaScript scripts/update_task.js "Review" --flag true

Output Handling

Scripts return JSON for structured data. When presenting to users: Parse the JSON Format results clearly Summarize counts and key information Highlight urgent items (overdue, due soon) Example response format: Found 3 overdue tasks: โ€ข Submit Q1 report (due Jan 20) โ€ข Review contract (due Jan 23) โ€ข Call vendor (due Jan 24) And 5 tasks due in the next 3 days: โ€ข [list tasks] Would you like me to flag or update any of these?

Error Handling

Common errors: Task not found - Double-check name or search first No tasks - Empty result, report clearly Invalid date - Use YYYY-MM-DD format OmniFocus not running - Scripts require OmniFocus

Multi-Step Operations

Find then act: # 1. Search for task RESULTS=$(osascript -l JavaScript scripts/search_tasks.js "meeting") # 2. Parse and identify target task name # 3. Complete the task osascript -l JavaScript scripts/complete_task.js "Team meeting notes"

Technical Reference

For detailed API information and advanced usage, see: JXA API Reference: references/jxa-api.md - Object model and methods Automation Guide: references/automation-guide.md - Detailed script documentation and workflows Read these files when: Building complex queries Understanding OmniFocus data model Implementing custom workflows Debugging scripts

Requirements

macOS OmniFocus installed and running Scripts have execute permissions (chmod +x)

Notes

Scripts use JXA (JavaScript for Automation), not AppleScript Task matching is case-sensitive for exact names, case-insensitive for searches Date format: YYYY-MM-DD (ISO 8601) All operations are performed on the default OmniFocus document Scripts are read-only safe except for add, complete, and update operations

Category context

Code helpers, APIs, CLIs, browser automation, testing, and developer operations.

Source: Tencent SkillHub

Largest current source with strong distribution and engagement signals.

Package contents

Included in package
3 Docs3 Scripts
  • SKILL.md Primary doc
  • references/automation-guide.md Docs
  • references/jxa-api.md Docs
  • scripts/add_task.js Scripts
  • scripts/complete_task.js Scripts
  • scripts/get_stats.js Scripts