yf-beads-extra
Advanced/gotcha layer for using the `bd` (beads) CLI directly at runtime, on top of the canonical `beads` skill. Covers
Advanced/gotcha layer for using the `bd` (beads) CLI directly at runtime, on top of the canonical `beads` skill. Covers issue-type semantics, dependency-edge mutation, gate semantics, defensive JSON parsing, transactional bulk intake (`bd batch`), and `bd mol pour` output shape.
At a glance
- Category:
beads - Invocation: auto (fires from its description conditions when relevant work appears)
- Requires tools:
bd - Depended on by:
yf-beads-authoring,yf-beads-hygiene,yf-beads-init,yf-beads-upstream,yf-incubator,yf-plan,yf-research - Source:
SKILL.md·README.md
When it fires
writing or debugging a script that calls `bd create`/`bd dep`/`bd update` directly, parsing `bd ... --json`, wiring gates or dependency graphs, or recovering from a malformed dependency graph.
When to skip it
routine `bd ready` / `bd show` / `bd update --claim` / `bd close` flows — those live in the canonical `beads` skill. For authoring beads-backed skills (formulas, coordinator loops), use `yf-beads-authoring`.
Prerequisites
| Tool | Version | Install |
|---|---|---|
bd |
1.0.5–1.1.0 | https://github.com/gastownhall/beads |
The gotchas are certified for bd 1.0.5–1.1.0 — re-verify against your installed bd version if it is newer. No init step: this skill ships no protocols/ rule and writes no config or state.
Usage
Not user-invocable. Triggers automatically when writing or debugging a script that calls bd create / bd dep / bd update directly, parsing bd ... --json, wiring gates or dependency graphs, or recovering from a malformed dependency graph. Skips routine bd loop flows (defer to beads).
Phase model
None. This is an instruction-only reference skill with no phases or state transitions.