tbd

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.

Ir a la instalación

Repositorio: jlevy/sidematter-format
Última actividad en el origen: 28 de febrero de 2026 a las 21:33
Idioma detectado de SKILL.md: inglés
Estrellas: 5
Forks: 2

Opciones de instalación

De forma predeterminada está seleccionado el prompt que primero revisa el origen. Puedes cambiar a un comando directo o descargar una copia local.

Instalar con Codex o Claude Copia este prompt, pégalo en Codex, Claude u otro asistente, y deja que revise la página de la skill y la instale por ti.

Un comando directo omite el prompt de revisión. Revisa el origen antes de ejecutarlo.

npx skills add https://github.com/jlevy/sidematter-format --skill tbd

El comando permanece en una sola línea. Desplázate horizontalmente para revisarlo antes de copiarlo.

¿Prefieres una copia local? Descarga los archivos que SkillsMP tiene disponibles ahora.

Revisa los archivos de origen

Lee SKILL.md y los archivos complementarios que muestra SkillsMP antes de decidir si quieres instalarlo.

SKILL.md

Instrucciones de origen · Vista previa de solo lectura

Volver a la búsqueda Volver a la instalación

Name

Description

agent-handoff

Generate a concise handoff prompt for another coding agent to continue work

checkout-third-party-repo

Get source code for libraries and third-party repos using git. Essential for reliable source code review. Prefer this to web searches or fetching of web pages from github.com as it is far more effective (github.com blocks web scraping from main website).

code-cleanup-all

Full cleanup cycle including duplicate removal, dead code, and code quality improvements

code-cleanup-docstrings

Review and add concise docstrings to major functions and types

code-cleanup-tests

Review and remove tests that do not add meaningful coverage

code-review-and-commit

Run pre-commit checks, review changes, and commit code

coding-spike

Prototype to validate a spec through hands-on implementation

create-or-update-pr-simple

Create or update a pull request with a concise summary

create-or-update-pr-with-validation-plan

Create or update a pull request with a detailed test/validation plan

implement-beads

Implement beads from a spec, following TDD and project rules

merge-upstream

Merge origin/main into current branch with conflict resolution

new-architecture-doc

Create an architecture document for a system or component design

new-guideline

Create a new coding guideline document for tbd

new-plan-spec

Create a new feature planning specification document

new-qa-playbook

Create a QA test playbook for manual validation workflows

new-research-brief

Create a research document for investigating a topic or technology

new-shortcut

Create a new shortcut (reusable instruction template) for tbd

new-validation-plan

Create a validation/test plan showing what's tested and what remains

plan-implementation-with-beads

Create implementation beads from a feature planning spec

precommit-process

Full pre-commit checklist including spec sync, code review, and testing

review-code

Comprehensive code review for uncommitted changes, branch work, or GitHub PRs

review-code-python

Python-focused code review (language-specific rules only)

review-code-typescript

TypeScript-focused code review (language-specific rules only)

review-github-pr

Review a GitHub pull request with follow-up actions (comment, fix, CI check)

revise-all-architecture-docs

Comprehensive revision of all current architecture documents

revise-architecture-doc

Update an architecture document to reflect current codebase state

setup-github-cli

Ensure GitHub CLI (gh) is installed and working

sync-failure-recovery

Handle tbd sync failures by saving to workspace and recovering later

update-specs-status

Review active specs and sync their status with tbd issues

welcome-user

Welcome message for users after tbd installation or setup

Name

Description

backward-compatibility-rules

Guidelines for maintaining backward compatibility across code, APIs, file formats, and database schemas

bun-monorepo-patterns

Modern patterns for Bun-based TypeScript monorepo architecture

cli-agent-skill-patterns

Best practices for building TypeScript CLIs that function as agent skills in Claude Code and other AI coding agents

commit-conventions

Conventional Commits format with extensions for agentic workflows

convex-limits-best-practices

Comprehensive reference for Convex platform limits, workarounds, and performance best practices

convex-rules

Guidelines and best practices for building Convex projects, including database schema design, queries, mutations, and real-world examples

electron-app-development-patterns

Guidelines for Electron development ecosystems including npm, pnpm, and Bun, with security baselines and framework comparisons

error-handling-rules

Rules for handling errors, failures, and exceptional conditions

general-coding-rules

Rules for constants, magic numbers, and general coding practices

general-comment-rules

Language-agnostic rules for writing clean, maintainable comments

general-eng-assistant-rules

Rules for AI assistants acting as senior engineers, including objectivity and communication guidelines

general-style-rules

Style guidelines for auto-formatting, emoji usage, and output formatting

general-tdd-guidelines

Test-Driven Development methodology and best practices

general-testing-rules

Rules for writing minimal, effective tests with maximum coverage

golden-testing-guidelines

Guidelines for implementing golden/snapshot testing for complex systems

pnpm-monorepo-patterns

Modern patterns for pnpm-based TypeScript monorepo architecture

python-cli-patterns

Modern patterns for Python CLI application architecture

python-modern-guidelines

Guidelines for modern Python projects using uv, with a few more opinionated practices

python-rules

General Python coding rules and best practices

release-notes-guidelines

Guidelines for writing clear, accurate release notes

tbd-sync-troubleshooting

Common issues and solutions for tbd sync and workspace operations

typescript-cli-tool-rules

Rules for building CLI tools with Commander.js, picocolors, and TypeScript

typescript-code-coverage

Best practices for code coverage in TypeScript with Vitest and v8 provider

typescript-rules

TypeScript coding rules and best practices

typescript-sorting-patterns

Deterministic sorting patterns and comparison chains for TypeScript

typescript-yaml-handling-rules

Best practices for parsing and serializing YAML in TypeScript

writing-style-guidelines

Guidelines for clear, concise, and reader-friendly writing in documentation and code

allowed-tools	Bash(tbd:*), Read, Write
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.
name	tbd

allowed-tools	Bash(tbd:*), Read, Write
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.
name	tbd

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"	`tbd show <id>`
"Close this issue"	`tbd close <id>`
"Search issues for X"	`tbd search "X"`
"Add label X to issue"	`tbd label add <id> <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
"Use TypeScript best practices"	`tbd guidelines typescript-rules`
"Use Python best practices"	`tbd guidelines python-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`
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.

Command	Purpose
`tbd ready`	Beads ready to work (no blockers)
`tbd list --status open`	All open beads
`tbd list --status in_progress`	Your active work
`tbd show <id>`	Bead details with dependencies

Command	Purpose
`tbd create "title" --type task\|bug\|feature --priority=P2`	New bead (P0-P4, not "high/medium/low")
`tbd update <id> --status in_progress`	Claim work
`tbd close <id> [--reason "..."]`	Mark complete

tbd

Opciones de instalación

Revisa los archivos de origen

title: tbd Workflow description: Full tbd workflow guide for agents

title: tbd Workflow description: Full tbd workflow guide for agents

Installation

Routine Commands

CRITICAL: You Operate tbd — The User Doesn’t

User Request → Agent Action

CRITICAL: Session Closing Protocol

Bead Tracking Rules

Commands

Finding Work

Creating & Updating

Dependencies & Sync

Labels & Search

Documentation

Quick Reference

Available Shortcuts

Available Guidelines

Command	Purpose
`tbd dep add <bead> <depends-on>`	Add dependency
`tbd blocked`	Show blocked beads
`tbd sync`	Sync with git remote (run at session end)
`tbd stats`	Project statistics
`tbd doctor`	Check for problems
`tbd doctor --fix`	Auto-fix repository problems

Command	Purpose
`tbd search <query>`	Search issues by text
`tbd label add <id> <label>`	Add label to issue
`tbd label remove <id> <label>`	Remove label from issue
`tbd label list`	List all labels in use
`tbd stale`	List issues not updated recently

Command	Purpose
`tbd shortcut <name>`	Run a shortcut
`tbd shortcut --list`	List shortcuts
`tbd guidelines <name>`	Load coding guidelines
`tbd guidelines --list`	List guidelines
`tbd template <name>`	Output a template

tbd

Datos de origen

Opciones de instalación

Revisa los archivos de origen

title: tbd Workflow description: Full tbd workflow guide for agents

title: tbd Workflow description: Full tbd workflow guide for agents

Installation

Routine Commands

CRITICAL: You Operate tbd — The User Doesn’t

User Request → Agent Action

CRITICAL: Session Closing Protocol

Bead Tracking Rules

Commands

Finding Work

Creating & Updating

Dependencies & Sync

Labels & Search

Documentation

Quick Reference

Available Shortcuts

Available Guidelines