Tbd

What it does

When your agent uses it

• : tracking issues/beads with dependencies
• Creating bugs/features/tasks
• Implementing features from specs
• Committing code

Example prompts

• “/tbd”

Requirements

• Python 3
• Node.js
• Pre-approved tools (allowed-tools): Bash(tbd:*), Read, Write

Workflow steps

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

1. 1Beads: Git-native issue tracking (tasks, bugs, features).
2. 2Spec-Driven Workflows: Plan features → break into beads → implement
3. 3Knowledge Injection: 17+ engineering guidelines (TypeScript, Python, TDD,
4. 4Shortcuts: Reusable instruction templates for common workflows (code review,

What it can do on your machine

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

• Tool permissions

  Pre-approves these tools, so the agent can use them without asking each time:

  • Bash(tbd:*)
  • Read
  • Write

  From allowed-tools in the SKILL.md frontmatter.

• Runs code

  Shell commands in SKILL.md call:

  • npm

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

• Network

  No URLs in SKILL.md. Its commands use npm, which can reach the network depending on how they are called.

  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

Tbd loads about 3.5k tokens when it runs. Until then it costs about 256 tokens; SKILL.md has 1,349 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it

~256

When it runs · the whole SKILL.md, loaded when a task matches

~3.5k

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

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

The full file from jlevy/strif at commit f66ba7e, republished under its MIT licence (© jlevy). 1,349 words, ~3,470 tokens.

name

tbd

description

Git-native issue tracking (beads), coding guidelines, knowledge injection, and spec-driven planning for AI agents. Drop-in replacement for bd/Beads with simpler architecture. Use for: tracking issues/beads with dependencies, creating bugs/features/tasks, planning specs, implementing features from specs, code reviews, committing code, creating PRs, loading coding guidelines (TypeScript, Python, TDD, golden testing, Convex, monorepo patterns), code cleanup, research briefs, architecture docs, agent handoffs, and checking out third-party library source code. Invoke when user mentions: tbd, beads, bd, shortcuts, issues, bugs, tasks, features, epics, todo, tracking, specs, planning, implementation, validation, guidelines, templates, commit, PR, pull request, code review, testing, TDD, test-driven, golden testing, snapshot testing, TypeScript, Python, Convex, monorepo, cleanup, dead code, refactor, handoff, research, architecture, labels, search, checkout library, source code review, or any workflow shortcut.

allowed-tools

Bash(tbd:*), Read, Write

<!-- DO NOT EDIT: Generated by tbd setup.
Run 'tbd setup' to update.
-->

npm install -g get-tbd@latest
tbd setup --auto --prefix=<name>   # Fresh project (--prefix is REQUIRED: 2-8 alphabetic chars recommended. ALWAYS ASK THE USER FOR THE PREFIX; do not guess it)
tbd setup --auto                   # Existing tbd project (prefix already set)
tbd setup --from-beads             # Migration from .beads/ if `bd` has been used

tbd --help    # Command reference
tbd status    # Status
tbd doctor    # If there are problems

tbd setup --auto   # Run any time to refresh setup
tbd prime      # Restore full context on tbd after compaction

[ ] 1. git add + git commit
[ ] 2. git push
[ ] 3. gh pr checks <PR> --watch 2>&1 (IMPORTANT: WAIT for final summary, do NOT tell user it is done until you confirm it passes CI!)
[ ] 4. tbd close/update <id> for all beads worked on
[ ] 5. tbd sync
[ ] 6. CONFIRM CI passed (if failed: fix, run tests, re-push, restart from step 3)

<!-- BEGIN SHORTCUT DIRECTORY -->

<!-- END SHORTCUT DIRECTORY -->

© jlevy, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in .claude/skills/tbd of jlevy/strif.

Open the folder on GitHubat commit f66ba7e

Used in 1 other repository

We found 2 copies of this SKILL.md (exact, near-identical or edited) in other folders. This page covers the copy in jlevy/strif, which our catalogue first saw on October 7, 2026.

• jlevy/simple-modern-uv.agents/skills/tbd.claude/skills/tbd