Agent skill

Things

by ossianhempel in ossianhempel/things3-cli

Things 3 CLI for reading the local Things database and creating/updating tasks/projects via the Things URL scheme.

No licenceAuto-check passed

Install Things

skills CLI
$ npx skills add ossianhempel/things3-cli --skill things -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install ossianhempel/things3-cli things --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/ossianhempel/things3-cli.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/things .claude/skills/things && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
things
GitHub stars
119
Token cost
~2.2k tokens
SKILL.md length
1,147 words
Files
1
Skills in repo
2
Repo updated
First seen
Licence
None found

At a glance

Things 3 CLI for reading the local Things database and creating/updating tasks/projects via the Things URL scheme.

  • Works in 6 steps: Read with things search, things tasks,… → Identify the intended row and capture… → Preview the exact write with --dry-run… → …
  • You need to list
  • Calls brew, make and go; needs THINGS_AUTH_TOKEN
  • Modify Things tasks

What it does

Things is an agent skill from ossianhempel/things3-cli. Things 3 CLI for reading the local Things database and creating/updating tasks/projects via the Things URL scheme. Use when you need to list, search, or modify Things tasks, projects, areas, or tags from the terminal (deletes use AppleScript).

Its SKILL.md is about 2.2k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

The repository describes itself as: CLI for Things 3, implemented in Go.

When your agent uses it

  • You need to list
  • Modify Things tasks
  • Tags from the terminal (deletes use AppleScript)

Example prompts

  • “Use the things skill to thing 3 CLI for reading the local Things database and creating/updating tasks/projects via the Things URL scheme”
  • “/things”

Requirements

  • A credential in THINGS_AUTH_TOKEN

Workflow steps

6 steps, taken from the first numbered list in SKILL.md.

  1. Read with things search, things tasks, or things templates.
  2. Identify the intended row and capture its UUID. If multiple items match, show the candidates and ask the human; never guess by title.
  3. Preview the exact write with --dry-run when the command supports it.
  4. Write using --id .
  5. Verify by re-reading that UUID; recurrence additionally requires inspecting the saved native Repeat settings.
  6. Report what was requested, what was verified, and any remaining uncertainty.

What it can do on your machine

Read from SKILL.md and the folder at commit 1a91642. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • brew
    • make
    • go

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Links to these hosts (documentation or services it may open):

    • culturedcode.com

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names these keys or tokens, usually read from environment variables:

    • THINGS_AUTH_TOKEN

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Things loads about 2.2k tokens when it runs. Until then it costs about 63 tokens; SKILL.md has 1,147 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~63
When it runs · the whole SKILL.md, loaded when a task matches
~2.2k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

Without a licence we can't republish the file, so here is its outline and opening line. It has 1,147 words (~2,240 tokens).

“Use things to read from the local Things 3 database and to create/update items via the Things URL scheme (areas use AppleScript).”

— opening of SKILL.md by ossianhempel
name
things

Read the full SKILL.md on GitHub

Files

Just SKILL.md in skills/things of ossianhempel/things3-cli.

Open the folder on GitHubat commit 1a91642

Compare with similar skills

Things next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Things compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Things this skillossianhempel/things3-cli119—~2.2kAutomated safety check: PassNone
Openclaw Updateopenclaw/openclaw392k—~1.5kAutomated safety check: PassMIT
Update Docsvercel/next.js143k—~1.9kAutomated safety check: PassMIT
Changelog Updatessickn33/agentic-awesome-skills47k1 repos~461Automated safety check: PassMIT
Dependency Updatecodewhale-hq/Codewhale41k—~142Automated safety check: PassMIT
UI Updatesickn33/agentic-awesome-skills47k1 repos~1.4kAutomated safety check: PassMIT

Similar skills

  • Openclaw Update

    openclaw/openclaw

    Route routine updates of an existing local or remote OpenClaw Gateway to its installation owner, with automatic session recovery.

    392k GitHub stars~1.5k tokensUpdated today
    DevOps & CloudAuto-check passed
  • Update Docs

    vercel/next.js

    Official

    This skill should be used when the user asks to "update documentation for my changes", "check docs for this PR", "what docs need updating", "sync docs with code", "scaffold docs for this feature"…

    143k GitHub stars~1.9k tokensUpdated today
    Documents & OfficeAuto-check passed
  • Changelog Updates

    sickn33/agentic-awesome-skills

    Create release notes and product updates that developers actually read and care about.

    47k GitHub starsUsed in 1 repo~461 tokens
    DevelopmentAuto-check passed
  • Dependency Update

    codewhale-hq/Codewhale

    Read release notes/changelogs, update a defined dependency scope, handle breaking changes, and verify.

    41k GitHub stars~142 tokensUpdated today
    DevelopmentAuto-check passed
  • UI Update

    sickn33/agentic-awesome-skills

    Update StyleSeed engine in your project — analyzes what's outdated and updates safely

    47k GitHub starsUsed in 1 repo~1.4k tokens
    Auto-check passed
  • Update Team Server

    openclaw/openclaw

    Update the operator-configured Team server through its canonical owner; trust native validation and acceptance without duplicate checks or schedulers.

    392k GitHub stars~3.8k tokensUpdated today
    DevOps & CloudAuto-check passed

More from ossianhempel/things3-cli

  • Release Flow

    ossianhempel/things3-cli

    Maintainer release workflow for things3-cli. An agent skill from ossianhempel/things3-cli.

    119 GitHub stars~543 tokensUpdated 4 days ago
    Auto-check passed

Questions about Things

What does Things do?

Things 3 CLI for reading the local Things database and creating/updating tasks/projects via the Things URL scheme. Things is an agent skill from ossianhempel/things3-cli. Things 3 CLI for reading the local Things database and creating/updating tasks/projects via the Things URL scheme.

When should I use Things?

Things fits situations like: you need to list; modify Things tasks; tags from the terminal (deletes use AppleScript).

How do I install Things in Claude Code?

Run `npx skills add ossianhempel/things3-cli --skill things -a claude-code`. Or copy the skill folder (skills/things in ossianhempel/things3-cli) into .claude/skills/things in your project. Claude Code loads it when a task matches its description.

How do I install Things in Codex?

Run `npx skills add ossianhempel/things3-cli --skill things -a codex`. Or copy the skill folder (skills/things in ossianhempel/things3-cli) into .agents/skills/things in your project. Codex loads it when a task matches its description.

Can I use Things in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add ossianhempel/things3-cli --skill things -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/things, .gemini/skills/things, .github/skills/things and .opencode/skills/things in your project.

What does Things need to run?

Going by SKILL.md and its folder, Things needs the command-line tools its instructions call (brew, make and go) and credentials named THINGS_AUTH_TOKEN. Our summary lists: A credential in THINGS_AUTH_TOKEN.

Does Things access the network?

SKILL.md names 1 domain. As links in the text: culturedcode.com. This is read from the text; nothing was executed.

Is Things safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Things use?

No licence was found for Things or its repository. Without one, default copyright applies: ask the author before reusing or redistributing it.

How many tokens does Things use?

About 2.2k tokens (SKILL.md is roughly 9k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Things?

Skills that share tags, products or a category with Things: Openclaw Update (openclaw/openclaw, 392k stars), Update Docs (vercel/next.js, 143k stars), Changelog Updates (sickn33/agentic-awesome-skills, 47k stars) and Dependency Update (codewhale-hq/Codewhale, 41k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Things?

ossianhempel (a GitHub user) maintains it in ossianhempel/things3-cli, which has 119 GitHub stars. The repository holds 2 skills in this directory. The repository was last updated on October 4, 2026.

Source: ossianhempel/things3-cli on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.