braid

Reference for braid, this project's issue tracker (the "skein" of "strands"). Use whenever you need braid command syntax — finding ready work, creating/updating/closing strands, dependencies, ready/blocked queries — or when a user mentions braid, a strand, or a bd- issue id and you need the authoritative, version-matched usage. The body defers to `braid agents-info` for the full guide.

Jump to install

Repository: quarto-dev/q2
Last source activity: June 8, 2026 at 17:30
Detected SKILL.md language: English
Stars: 239
Forks: 14

Install options

The review-first prompt is selected by default. You can switch to a direct command or download a local copy.

Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.

A direct command skips the review prompt. Inspect the source before running it.

npx skills add https://github.com/quarto-dev/q2 --skill braid

The command stays on one line. Scroll horizontally to inspect it before copying.

Prefer a local copy? Download the files currently available to SkillsMP.

Review the source files

Read SKILL.md and any companion files shown by SkillsMP before deciding whether to install.

SKILL.md

Source instructions · Read-only preview

Back to search Back to installation

investigate-beads

Investigate a braid strand (bd-XXXX issue) in the current checkout, gather context from its dependency graph, and produce a plan-skeleton + triage verdict (ready / needs-info / blocked). Use when the user provides a strand ID (bd-XXXX) and asks to investigate, scope, or understand the work needed.

2026-06-17

preview-render-parity

Diagnose and fix DOM / style differences between `q2 preview` and `q2 render` so the two pipelines produce visually-equivalent output. Use when the user reports that the preview's appearance, spacing, classes, or DOM structure doesn't match the rendered site — phrases like "preview vs render differs", "preview shows X differently", "spacing/margin/padding off", "DOM doesn't match", "missing class in preview", or shows a specific computed-style mismatch (e.g. "17px in preview, 34px in render"). Also invoked explicitly via `/preview-parity`.

2026-06-17

triage

Set up an isolated worktree and triage a GitHub issue into a durable on-branch record. Use when the user says "triage issue

2026-06-08

View all from this repository

name	braid
description	Reference for braid, this project's issue tracker (the "skein" of "strands"). Use whenever you need braid command syntax — finding ready work, creating/updating/closing strands, dependencies, ready/blocked queries — or when a user mentions braid, a strand, or a bd- issue id and you need the authoritative, version-matched usage. The body defers to `braid agents-info` for the full guide.

braid issue tracking

This project tracks issues ("strands") with braid. For the authoritative, version-matched usage guide — every command, flag, and convention — run:

braid agents-info

Core loop: braid ready finds workable strands; claim one with braid update <id> --status in_progress --assignee <you>; leave a trail with braid comment <id> "..."; finish with braid close <id> --reason "...". File discovered work as you go in one shot:

braid create "<title>" --type <task|bug|...> --deps discovered-from:<current-id>

Attribute your changes with BRAID_AUTHOR=<you>.

braid

Source facts

Install options

Review the source files

More from this repository

braid issue tracking

More from this repository

braid issue tracking