Agent skill

Tasks

Work on or manage records in BB Tasks, including task keys such as ABC-12.

MITAuto-check passed

Install Tasks

skills CLI

$ npx skills add get-bb/bb --skill tasks -a claude-code

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

GitHub CLI

$ gh skill install get-bb/bb tasks --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/get-bb/bb.git skills-src && mkdir -p .claude/skills && cp -r skills-src/plugins/tasks/skills/tasks .claude/skills/tasks && 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/

Paste into Claude Code

Install the "tasks" agent skill from https://github.com/get-bb/bb/tree/main/plugins/tasks/skills/tasks into .claude/skills/tasks/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "tasks", then confirm the skill loads.

Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

$skill-installer

$skill-installer install https://github.com/get-bb/bb/tree/main/plugins/tasks/skills/tasks

Type this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.

skills CLI

$ npx skills add get-bb/bb --skill tasks -a codex

Project install goes to .agents/skills/; add -g for ~/.codex/skills/.

GitHub CLI

$ gh skill install get-bb/bb tasks --agent codex

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/get-bb/bb.git skills-src && mkdir -p .agents/skills && cp -r skills-src/plugins/tasks/skills/tasks .agents/skills/tasks && rm -rf skills-src

Use ~/.agents/skills/ instead of .agents/skills for a personal install.

Codex skills documentation · loads skills from .agents/skills/

Paste into Codex

Install the "tasks" agent skill from https://github.com/get-bb/bb/tree/main/plugins/tasks/skills/tasks into .agents/skills/tasks/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "tasks", then confirm the skill loads.

Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add get-bb/bb --skill tasks -a cursor

Project install goes to .agents/skills/; add -g for ~/.cursor/skills/.

GitHub CLI

$ gh skill install get-bb/bb tasks --agent cursor

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/get-bb/bb.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/plugins/tasks/skills/tasks .cursor/skills/tasks && rm -rf skills-src

Use ~/.cursor/skills/ instead of .cursor/skills for a personal install.

Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/

Paste into Cursor

Install the "tasks" agent skill from https://github.com/get-bb/bb/tree/main/plugins/tasks/skills/tasks into .cursor/skills/tasks/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "tasks", then confirm the skill loads.

Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

gemini skills install

$ gemini skills install https://github.com/get-bb/bb.git --path plugins/tasks/skills/tasks

--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.

skills CLI

$ npx skills add get-bb/bb --skill tasks -a gemini-cli

Project install goes to .agents/skills/; add -g for ~/.gemini/skills/.

GitHub CLI

$ gh skill install get-bb/bb tasks --agent gemini-cli

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/get-bb/bb.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/plugins/tasks/skills/tasks .gemini/skills/tasks && rm -rf skills-src

Use ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.

Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/

Paste into Gemini CLI

Install the "tasks" agent skill from https://github.com/get-bb/bb/tree/main/plugins/tasks/skills/tasks into .gemini/skills/tasks/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "tasks", then confirm the skill loads.

Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

GitHub CLI

$ gh skill install get-bb/bb tasks

Installs for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).

skills CLI

$ npx skills add get-bb/bb --skill tasks -a github-copilot

Project install goes to .agents/skills/; add -g for ~/.copilot/skills/.

Manual copy

$ git clone --depth 1 https://github.com/get-bb/bb.git skills-src && mkdir -p .github/skills && cp -r skills-src/plugins/tasks/skills/tasks .github/skills/tasks && rm -rf skills-src

Use ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.

GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/

Paste into GitHub Copilot

Install the "tasks" agent skill from https://github.com/get-bb/bb/tree/main/plugins/tasks/skills/tasks into .github/skills/tasks/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "tasks", then confirm the skill loads.

GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add get-bb/bb --skill tasks -a opencode

OpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.

GitHub CLI

$ gh skill install get-bb/bb tasks --agent opencode

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/get-bb/bb.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/plugins/tasks/skills/tasks .opencode/skills/tasks && rm -rf skills-src

Use ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.

OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/

Paste into OpenCode

Install the "tasks" agent skill from https://github.com/get-bb/bb/tree/main/plugins/tasks/skills/tasks into .opencode/skills/tasks/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "tasks", then confirm the skill loads.

OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

Facts

Skill name: tasks
GitHub stars: 4.2k
Token cost: ~1.4k tokens
SKILL.md length: 751 words
Files: 3 (incl. references)
Skills in repo: 33
Repo updated: Oct 7, 2026
First seen: Oct 7, 2026
Licence: MIT

At a glance

Work on or manage records in BB Tasks, including task keys such as ABC-12.

Works in 6 steps: Find and read the task before acting → Fetch every relevant attachment before… → Do the work. Post one substantive… → …
SKILL.md covers Work a task, Link tasks in responses, CLI conventions and Invariants
Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Tasks is an agent skill from get-bb/bb. Work on or manage records in BB Tasks, including task keys such as ABC-12.

Its SKILL.md is about 1.4k tokens, which your agent loads only when the skill is triggered. The skill folder holds 3 other files, including reference files (for example `references/attachments.md` and `references/delegation.md`).

The repository describes itself as: The agent IDE that builds itself. The licence is MIT.

Example prompts

“/tasks”

Workflow steps

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

Find and read the task before acting
Fetch every relevant attachment before making assumptions about it
Do the work. Post one substantive comment at each meaningful milestone,
Attach result artifacts that belong with the task, such as reports,
Set the status to match the completion criteria. Use done when they are
Delegated threads are attached automatically. If this thread was not

What it can do on your machine

Read from SKILL.md and the folder at commit 68a1e8b. 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
No scripts in the folder and no shell commands in SKILL.md (its code samples are bash and markdown).
From the folder's file list and the shell code blocks in SKILL.md.
Network
No URLs in SKILL.md.
From URLs in SKILL.md, links to its own repository left out.
Credentials
Names no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Tasks loads about 1.4k tokens when it runs, and up to ~1.9k if it reads all its reference files. Until then it costs about 20 tokens; SKILL.md has 751 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it: ~20
When it runs · the whole SKILL.md, loaded when a task matches: ~1.4k
With references · SKILL.md plus every file in references/, read only if the agent opens them: ~1.9k

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

Download SKILL.mdSave it as .claude/skills/tasks/SKILL.md (or your agent's skills folder). This skill also uses 2 other files; get the full folder from GitHub.

name: tasks
description: Work on or manage records in BB Tasks, including task keys such as ABC-12.

Tasks

Use the bb tasks CLI to understand the assigned task, keep its record useful, and report the outcome where the work is tracked.

For task dispatch and execution presets, read references/delegation.md.

Work a task

Find and read the task before acting:
sh
```
bb tasks show ABC-12
```
The detail includes the description, status, priority, labels, subtasks, comments, attachments, attached worker threads, and the GitHub pull requests those threads produced (from environment metadata, with state open/draft/merged/closed). Use bb tasks show ABC-12 --json when the result will drive commands or code.

For project-wide discovery, bb tasks list returns at most 100 rows by default. Pass --limit 1-500; in JSON, continue with nextCursor via the same filters/sort and --cursor <value>. A task-list mutation makes an old cursor stale, so restart without it.
Fetch every relevant attachment before making assumptions about it:
sh
```
bb tasks attachment get <attachment-id> --out <path>
```
Do the work. Post one substantive comment at each meaningful milestone, such as a completed investigation, an implementation ready for validation, or a concrete blocker:
sh
```
bb tasks comment ABC-12 --body "Implemented the change; focused validation now passes."
```
Add --notify only when the new comment should be delivered to the thread that authored the task's most recent agent reply. This resumes an idle recipient; with no prior agent reply, the comment is recorded without targeting an unrelated thread. In agent context, the new comment keeps the current thread identity and an explicit --author, while delivery still targets the prior latest responder rather than the new comment itself.
Attach result artifacts that belong with the task, such as reports, screenshots, patches, or generated files:
sh
```
bb tasks attachment add ABC-12 --file ./report.md
bb tasks attachment add ABC-12 --file ./screenshot.png
```
Read references/attachments.md for comment attachments, initial files, removal rules, and machine selection.
Set the status to match the completion criteria. Use done when they are met, or in_review when required review remains:
sh
```
bb tasks update ABC-12 --status in_review
```
Change task hierarchy with bb tasks update ABC-12 --parent ABC-10, using either a task key or ID for the parent. Promote a subtask to the top level with bb tasks update ABC-12 --no-parent; the two parent flags cannot be combined.

Move a task and its sub-tasks to another tracker project with bb tasks move ABC-12 --project XYZ. The task gets a new key in that project; the old key keeps resolving, so use the new key from then on.

If the work cannot proceed, leave the status accurate and comment with the specific blocker, what you tried, and what would unblock it. Do not mark a blocked task complete.
Delegated threads are attached automatically. If this thread was not delegated from Tasks, attach it yourself so the task shows the active work:
sh
```
bb tasks attach ABC-12
```
When a thread is done with a task (hand-off, respawned replacement, or a predecessor that died), detach it so bb tasks threads ABC-12 stays accurate. Omit --thread to detach the current thread:
sh
```
bb tasks detach ABC-12 --thread thr_dead_predecessor
```

Show full SKILL.md (306 more words)Show less

Link tasks in responses

When your answer refers the user to a task — including a task you just created — emit this leaf directive on its own line instead of writing the key as plain text:

::task{key="ABC-12"}

key is required. Optionally add title="…" as a display fallback shown while the card loads and when the key no longer resolves. The rendered card shows the live status, title, and priority, opens the task in the thread side panel, and links to the full Tasks app. Emit one directive per line; each renders its own card.

CLI conventions

bb tasks --help lists every command, and bb tasks <command> --help prints that command's arguments, accepted values, and limits. Both exit 0.
--project takes a tracker project prefix or id such as ABC, never a bb project id (proj_...). bb tasks project list shows both columns.
bb tasks status reports the plugin's name and version. A task's workflow status is bb tasks list --status <status> and bb tasks update ABC-12 --status <status>.
Repeatable options (--label, --status, --priority, --add-label, --remove-label) accept a repeated flag or one comma-separated list.
Unknown options and stray arguments are errors, never ignored, and every missing required value is reported in one error. A failing command run with --json prints {"ok":false,"error":{"code","message","hint"?}} on stdout.

Invariants

Valid task statuses are backlog, todo, in_progress, in_review, done, and canceled.
Use in_review when implementation is complete but still needs human or agent review. Use done only when the task's completion criteria are met.
Write one comment per meaningful milestone. Combine related facts into a useful update; never spam progress pings, command-by-command narration, or repeated status messages.
Comments should say what changed or was learned, what validation ran, and any remaining risk or blocker.
Prefer stable task keys such as ABC-12 for task commands. Use --json for machine-readable output and human output for quick inspection.

Files

SKILL.md and 2 other files (references) in plugins/tasks/skills/tasks of get-bb/bb.

SKILL.md
references/attachments.md
references/delegation.md

Open the folder on GitHubat commit 68a1e8b

Compare with similar skills

Tasks 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.

Tasks compared with similar skills
Skill	Stars	Used in	Tokens	Auto-check	Licence	Repo updated
Tasks this skillget-bb/bb	4.2k	—	~1.4k	Automated safety check: Pass	MIT	today
Recordingcodewhale-hq/Codewhale	41k	—	~540	Automated safety check: Pass	MIT	today
Architecture Decision Recordsaffaan-m/ECC	274k	4 repos	~1.8k	Automated safety check: Pass	MIT	2 days ago
Architecture Decision Recordsaffaan-m/ECC	274k	1 repos	~863	Automated safety check: Pass	MIT	2 days ago
Architecture Decision Recordsaffaan-m/ECC	274k	—	~1.1k	Automated safety check: Pass	MIT	2 days ago
Browser Recordruvnet/ruflo	74k	—	~735	Automated safety check: Notes	MIT	today

Similar skills

Recording
codewhale-hq/Codewhale
Capture screenshots on registered computers, record on macOS or HarmonyOS, and manage saved captures.
41k GitHub stars~540 tokensUpdated today
Productivity & AutomationAuto-check passed
Architecture Decision Records
affaan-m/ECC
Capture architectural decisions as numbered ADR markdown files in docs/adr/ with context, alternatives considered, consequences, and an index README.
274k GitHub starsUsed in 4 repos~1.8k tokens
DevelopmentAuto-check passed
Architecture Decision Records
affaan-m/ECC
在Claude Code会话期间，将做出的架构决策捕获为结构化的架构决策记录（ADR）。自动检测决策时刻，记录上下文、考虑的替代方案和理由。维护一个ADR日志，以便未来的开发人员理解代码库为何以当前方式构建。
274k GitHub starsUsed in 1 repo~863 tokens
DevelopmentAuto-check passed
Architecture Decision Records
affaan-m/ECC
コーディングセッション中にアーキテクチャ決定を構造化ADRとして記録し、自動的に決定の瞬間を検出し、コンテキスト、検討された代替案、根拠を記録します。今後の開発者がコードベースの形成理由を理解するためのADRログを維持します。
274k GitHub stars~1.1k tokensUpdated 2 days ago
DevelopmentAuto-check passed
Browser Record
ruvnet/ruflo
Open a named, traced browser session into an RVF cognitive container with a ruvector trajectory recording every action
74k GitHub stars~735 tokensUpdated today
Agent WorkflowsAuto-check: notes
Grill And Record
asgeirtj/system_prompts_leaks
Run an explicitly requested decision interview and record each settled decision in durable project documentation.
69k GitHub stars~912 tokensUpdated yesterday
Auto-check passed

Questions about Tasks

What does Tasks do?

Work on or manage records in BB Tasks, including task keys such as ABC-12. Tasks is an agent skill from get-bb/bb. Work on or manage records in BB Tasks, including task keys such as ABC-12.

How do I install Tasks in Claude Code?

Run `npx skills add get-bb/bb --skill tasks -a claude-code`. Or copy the skill folder (plugins/tasks/skills/tasks in get-bb/bb) into .claude/skills/tasks in your project. Claude Code loads it when a task matches its description.

How do I install Tasks in Codex?

Run `npx skills add get-bb/bb --skill tasks -a codex`. Or copy the skill folder (plugins/tasks/skills/tasks in get-bb/bb) into .agents/skills/tasks in your project. Codex loads it when a task matches its description.

Can I use Tasks 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 get-bb/bb --skill tasks -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/tasks, .gemini/skills/tasks, .github/skills/tasks and .opencode/skills/tasks in your project.

What does Tasks need to run?

SKILL.md names no scripts, command-line tools or credentials: Tasks is instructions for the agent only.

Does Tasks access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Tasks 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 Tasks use?

Tasks is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Tasks use?

About 1.4k tokens (SKILL.md is roughly 5.7k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 510 tokens, read only when the agent opens those files.

What are the alternatives to Tasks?

Skills that share tags, products or a category with Tasks: Recording (codewhale-hq/Codewhale, 41k stars), Architecture Decision Records (affaan-m/ECC, 274k stars), Architecture Decision Records (affaan-m/ECC, 274k stars) and Architecture Decision Records (affaan-m/ECC, 274k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Tasks?

get-bb (a GitHub organization) maintains it in get-bb/bb, which has 4,155 GitHub stars. The repository holds 33 skills in this directory. The repository was last updated on October 7, 2026.

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

Tasks

Install Tasks

Facts

At a glance

What it does

Example prompts

Workflow steps

What it can do on your machine

Tool permissions

Runs code

Network

Credentials

Context cost

Safety

SKILL.md

Tasks

Work a task

Link tasks in responses

CLI conventions

Invariants

Files

Compare with similar skills

Similar skills

Recording

Architecture Decision Records

Architecture Decision Records

Architecture Decision Records

Browser Record

Grill And Record

More from get-bb/bb

Bb CLI

Skill Creator

Submit A Plugin

Workflows

Verify Bb

Bb Theme Authoring

Questions about Tasks