Agent Skill

The Taskbean Agent Skill teaches coding agents when to create, start, block, and complete tasks. Its source lives at .agents/skills/taskbean/SKILL.md.

Detect installed agents

bean install --agent auto

Taskbean checks your PATH for the copilot, claude, codex, and opencode CLIs and installs the skill for each one it finds. If none are on PATH, the command reports an error and installs nothing. Use --agent all instead if you want to install for every supported agent without detecting its CLI. Add --global to install in your home directory instead of the current directory.

Install by agent

bean install --agent copilot
bean install --agent claude
bean install --agent codex
bean install --agent opencode
bean install --agent all

Add --global to install in your home directory instead of the current directory.

Agent	Install location	Verification
GitHub Copilot CLI	`.agents/skills/taskbean/` and `.github/skills/taskbean/`	Full end-to-end
Claude Code	`.claude/skills/taskbean/`	Full end-to-end
OpenAI Codex	`.agents/skills/taskbean/`	Full end-to-end
OpenCode	`.agents/skills/taskbean/`	Full end-to-end

Cursor, Windsurf, Cline, and Roo Code have known skill directories in Taskbean’s cleanup logic, but Taskbean does not claim full end-to-end verification for them.

Configure the Codex sandbox

If Codex cannot write to ~/.taskbean, run:

bean install --agent codex --codex-sandbox

This adds ~/.taskbean to the sandbox_workspace_write writable roots in ~/.codex/config.toml.

Detect drift

Check installed copies without changing them:

bean update-skill --json

Apply the bundled skill:

bean update-skill --apply

Getting started

Concepts

CLI

Desktop app

Chronicle

Reference

Detect installed agents

Install by agent

Configure the Codex sandbox

Detect drift

​Detect installed agents

​Install by agent

​Configure the Codex sandbox

​Detect drift

Detect installed agents

Install by agent

Configure the Codex sandbox

Detect drift