Ready to supercharge your AI agents?

Install any skill in seconds. Free to start, no credit card required.

Things 3 CLI · understudy-ai | DecimalAI

productivityby understudy-ai

Things 3 CLI

understudy-ai/things-mac

Source understudy-ai/understudy ↗License MIT

Manage Things 3 via the `things` CLI on macOS (add/update projects+todos via URL scheme; read/search/list from the local Things database).

SkillScore95Maintained

Automatic

Personal Assistant pack

Last verified 8/19/2026

What it changes

Passed 21 of 22 test cases with the skill, and 5 of 22 without it.

Without skill23%

With skill95%

Checks it passed that the model alone missed

The command specifies --when today.
The output includes --list "Travel".
The command includes --list "Travel".

and 23 more in the full report

16 fixed5 passed either way1 still failing0 broke

Pass-rate lift: +73 pp
Tokens: -26%
Agent turns: 0%
Response time: -75%

Model gemini-3.6-flashMeasured 8/19/2026v121 of 22 cases passed with skill

Tokens, turns and time describe resource use, not a dollar price.

Use this skill

Save it into your project's skills folder. Claude Code picks it up in its next session.

curl -fsSL --create-dirs -o .claude/skills/understudy-ai-things-mac/SKILL.md https://app.decimal.ai/s/understudy-ai-things-mac/SKILL.md

Want it pinned and updatable? pip install "decimalai>=0.15", then decimalai skills add understudy-ai-things-mac, and start Claude Code with claude --plugin-dir "$(git rev-parse --show-toplevel)/.agents"

1 · One-time — install the CLI (docs ↗)

pip install "decimalai>=0.15"

2 · Get the skill — writes .agents/skills/understudy-ai-things-mac/ and pins it in .decimal/skills.lock

decimalai skills add understudy-ai-things-mac

No CLI? Get the same file — curl · raw file

curl -fsSL --create-dirs -o .claude/skills/understudy-ai-things-mac/SKILL.md https://app.decimal.ai/s/understudy-ai-things-mac/SKILL.md

Raw file: /s/understudy-ai-things-mac/SKILL.md ↗ · machine-readable summary at /s/understudy-ai-things-mac.json ↗

Safety checks: 3 of 3 passed

Code scan CleanIntent PassedContent Clean

See it in action

One of 16 test cases the skill fixed. Same model, same prompt, with and without the skill.

1 of 16

Prompt

I want to add a task titled 'Submit Report' scheduled for today with a deadline of 2026-01-02 using the command line. What is the full command?

What was checked, without and with the skill
Checked	Without skill	With skill
The command specifies --when today.	Missed	Passed
The command specifies --deadline 2026-01-02.	Missed	Passed

case-13 · gemini-3.6-flash · 8/19/2026 · answers are capped and redacted

What's inside

The instructions your model reads when the skill loads.

SKILL.md61 linessingle file

Things 3 CLI

Use things to read your local Things database (inbox/today/search/projects/areas/tags) and to add/update todos via the Things URL scheme.

Setup

Install (recommended, Apple Silicon): GOBIN=/opt/homebrew/bin go install github.com/ossianhempel/things3-cli/cmd/things@latest
If DB reads fail: grant Full Disk Access to the calling app (Terminal for manual runs; Understudy.app for gateway runs).
Optional: set THINGSDB (or pass --db) to point at your ThingsData-* folder.
Optional: set THINGS_AUTH_TOKEN to avoid passing --auth-token for update ops.

Read-only (DB)

things inbox --limit 50
things today
things upcoming
things search "query"
things projects / things areas / things tags

Write (URL scheme)

Prefer safe preview: things --dry-run add "Title"
Add: things add "Title" --notes "..." --when today --deadline 2026-01-02
Bring Things to front: things --foreground add "Title"

Examples: add a todo

Basic: things add "Buy milk"
With notes: things add "Buy milk" --notes "2% + bananas"
Into a project/area: things add "Book flights" --list "Travel"
Into a project heading: things add "Pack charger" --list "Travel" --heading "Before"
With tags: things add "Call dentist" --tags "health,phone"
Checklist: things add "Trip prep" --checklist-item "Passport" --checklist-item "Tickets"
From STDIN (multi-line => title + notes):
- cat <<'EOF' | things add -
- Title line
- Notes line 1
- Notes line 2
- EOF

Track record

Benchmark

21 / 22

test cases passed, vs 5 / 22 without

Adoption

Users: 0
Times used: 0

Safety and source details

SkillSafety

✓ 3 of 3 passed

Code scan15 of 15 checks clean

0 critical · 0 warning · 0 info — scanner v4 — 8/3/2026

View 15 scanner checks

live_secretremote_code_executionreverse_shelldata_exfiltrationssrf_metadataagent_snoopinganti_refusaldestructive_commandsobfuscated_unicodeunicode_homoglyphopaque_blobsuspicious_urltool_overreachtrigger_abuseprompt_injection_phrasing

IntentSafe

LLM judge · does the skill do what it claims

ContentClean

LLM judge · policy & harmful-content review

Source

Imported

understudy-ai / understudy

skills/things-mac/SKILL.md

View on GitHub ↗

License MITImported 8/3/2026Version v1

Other skills for the same job

Published skills whose descriptions closely match this one, with their headline benchmark lift.

More skills from the same source and nearby in the registry, with their headline benchmark lift.

Ready to supercharge your AI agents?

See it in action

What's inside

Things 3 CLI

Track record

Benchmark

Adoption

SkillSafety

Source

Other skills for the same job

Related skills