Borrowing it
Nothing to install: this file belongs to jlevy/supply-chain-hardening. Take a copy, put it at the same path in your own repository, and replace the rules that are about this project with yours.
curl -O https://raw.githubusercontent.com/jlevy/supply-chain-hardening/main/.agents/skills/tbd/SKILL.mdgit clone --depth 1 https://github.com/jlevy/supply-chain-hardeningWrote this? Show the measurements
A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.
[](https://agentmods.dev/skills/jlevy/supply-chain-hardening/tbd)<a href="https://agentmods.dev/skills/jlevy/supply-chain-hardening/tbd"><img src="https://agentmods.dev/badge/skills/jlevy/supply-chain-hardening/tbd/github.svg" alt="Measured on agentmods" height="20"></a>Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.
<a href="https://agentmods.dev/skills/jlevy/supply-chain-hardening/tbd"><img src="https://agentmods.dev/badge/skills/jlevy/supply-chain-hardening/tbd.svg" alt="Reviewed on agentmods" width="80" height="20"></a>What it costs to keep this loaded
Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.
| Model | Per session | Once invoked |
|---|---|---|
| Fable 5.1 | $0.00223 | $0.04986 |
| Opus 5 | $0.00112 | $0.02493 |
| Sonnet 5 | $0.00045 | $0.00997 |
| Haiku 4.5 | $0.00022 | $0.00499 |
Grade A, and why
tbd scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 10d ago.
A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.
Nothing flagged
None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.
How it starts
The opening of the file, as written. The whole thing — 330 lines — stays where its author put it; the contents beside it link to each section on GitHub.
tbd helps humans and agents ship code with greater speed, quality, and discipline.
- Beads: Git-native issue tracking (tasks, bugs, features).
Never lose work across sessions.
Drop-in replacement for
bd. - Spec-Driven Workflows: Plan features → break into beads → implement systematically.
- Knowledge Injection: 25+ engineering guidelines (TypeScript, Python, TDD, testing, Convex, monorepos) available on demand.
- Shortcuts: Reusable instruction templates for common workflows (code review, commits, PRs, cleanup, handoffs).
Installation
npm install -g get-tbd@latest # Install or upgrade the CLI (same command for both)
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 — also the upgrade step (applies any format migration; commit the diff it reports)
tbd setup --from-beads # Migration from .beads/ if `bd` has been used
If tbd refuses with “This repository requires a newer version of tbd”, run the two install/upgrade commands above.
Routine Commands
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
CRITICAL: You Operate tbd, the User Doesn’t
You are the tbd operator: Users talk naturally; you translate their requests to tbd actions. DO NOT tell users to run tbd commands. That’s your job.
-
WRONG: “Run
tbd createto track this bug” -
RIGHT: (you run
tbd createyourself and tell the user it’s tracked)
Welcoming a user: When users ask “what is tbd?”
or want help → run tbd shortcut welcome-user
User Request → Agent Action
| User Says | You (the Agent) Run |
|---|---|
| Issues/Beads | |
| “There’s a bug where …” | tbd create "..." --type=bug |
| “Create a task/feature for …” | tbd create "..." --type=task or --type=feature |
| “Let’s work on issues/beads” | tbd ready |
| “Show me issue X” (or several) | tbd show <id1> [<id2> …] (one call, never a loop; --max-lines <n> caps output per issue) |
| “Where do things stand on spec X?” | tbd list --spec <path-or-filename> (all specs at once: tbd list --specs) |
| “Close this issue” | tbd close <id> (several: tbd close <id1> <id2> … — one call, never a loop) |
| “Search issues for X” | tbd search "X" (matches content and issue IDs, so partial IDs work) |
| “Add label X to issue” | tbd label add <id> <label> (several beads: tbd update <id1> <id2> … --add-label <label>) |
| “What issues are stale?” | tbd stale |
| Planning & Specs | |
| “Plan a new feature” / “Create a spec” | tbd shortcut new-plan-spec |
| “Break spec into beads” | tbd shortcut plan-implementation-with-beads |
| “Implement these beads” | tbd shortcut implement-beads |
| Code Review & Commits | |
| “Review this code” / “Code review” | tbd shortcut review-code |
| “Review this PR” | tbd shortcut review-github-pr |
| “Commit this” / “Use the commit shortcut” | tbd shortcut code-review-and-commit |
| “Create a PR” / “File a PR” | tbd shortcut create-or-update-pr-simple |
| “Merge main into my branch” | tbd shortcut merge-upstream |
| Guidelines & Knowledge | |
| (any engineering work) | Load the General engineering group first (see below) |
| “Use TypeScript best practices” | tbd guidelines typescript-rules typescript-lint-format-rules |
| “Use Python best practices” | tbd guidelines python-rules |
| “Set up TS/JS lint, format, or hooks” | tbd guidelines typescript-lint-format-rules |
| “Build a TypeScript CLI” | tbd guidelines typescript-cli-tool-rules |
| “Improve monorepo setup” | tbd guidelines pnpm-monorepo-patterns or bun-monorepo-patterns |
| “Add golden/e2e testing” | tbd guidelines golden-testing-guidelines |
| “Use TDD” / “Test-driven development” | tbd guidelines general-tdd-guidelines |
| “Convex best practices” | tbd guidelines convex-rules |
| Documentation | |
| “Research this topic” | tbd shortcut new-research-brief |
| “Document architecture” | tbd shortcut new-architecture-doc |
| “What guidelines/docs are there?” | tbd docs list |
| “Make the guidelines visible / customize doc X” | tbd docs fork --category=general --category=<lang> (recommended: general + the repo’s languages), or tbd docs fork <name> / --all; then edit in docs/tbd/ |
| “Update the guidelines to the latest” | tbd docs update; on conflicts ask the user, then --merge or --keep-ours |
| “I deleted a forked doc file” | tbd docs status shows it missing; restore with tbd docs fork <name> --force or finalize with tbd docs unfork <name> |
| Cleanup & Maintenance | |
| “Clean up this code” / “Remove dead code” | tbd shortcut code-cleanup-all |
| “Fix repository problems” | tbd doctor --fix |
| Sessions & Handoffs | |
| “Hand off to another agent” | tbd shortcut agent-handoff |
| “Check out this library’s source” | tbd shortcut checkout-third-party-repo |
| (your choice whenever appropriate) | tbd list, tbd dep add, tbd close, tbd sync, etc. |
What this file has done since we first saw it
Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.
- 10d ago First seen · 330 lines · 223 tokens per session scan A 249639098011
tbd is a skill published in the GitHub repository jlevy/supply-chain-hardening (5 stars, last pushed 1mo ago), licensed MIT. It adds 223 tokens to every session and 4,986 once invoked, about $0.0011 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.
Other skills, from other repositories
tech-debt-tracker
Agents should invoke this skill when identifying, categorizing, prioritizing, or planning technical debt work, debt sprints, cleanup backlogs, TODO consolidation, or long-term maintainability risks. Tracks debt with severity/effort.
detecting-dependency-confusion
Detect and prevent public-over-private name resolution in npm, PyPI, and Maven.
huly-cli
Operate Huly through the @firfi/huly-cli executable. Use when a coding agent needs to authenticate, switch Huly workspaces or projects, discover commands, query structured Huly data, or perform confirmed Huly mutations from a shell or automation workflow.
agent-extension-supply-chain-auditor
Audit supplied evidence for AI coding-agent extensions, Codex plugins, Claude Code extensions, and MCP servers using concrete supply-chain security indicators.
usap-program-manager
Security program manager and passive lifecycle orchestrator (cs-security-program-manager). Use for security roadmap planning, program health scanning, debt tracking, facilitated reviews, or when the user says "security roadmap", "program planning", "security debt", "proactive scan", or "program review".
research
Comprehensive research, analysis, and content extraction system. Multi-source parallel research using available researcher agents. Deep content analysis with extended thinking. Intelligent retrieval for difficult sites. Fabric pattern selection for 242+ specialized prompts. USE WHEN user says 'do research', 'extract…