Home / petar-djukic / coding-skills · .agents/skills/bd-issue-pop/SKILL.md · GitHub

bd-issue-pop skillA

bd-issue-pop is agent-read markdown (skill) from petar-djukic/coding-skills: Pop a bead (epic) into a worktree branch, decompose it into child beads, then.

Indexed from public GitHub and served as immutable, content-addressed versions. Install it pinned to an exact SHA-256 with the mdr CLI, and every file is verified against the hash recorded here before it reaches your agent. The deterministic audit below grades the latest version, and the same file always earns the same grade.

What the file says

# bd-issue-pop command

Apply this command workflow. Treat any text after its invocation as the command input.

Pop a bead (epic) into a worktree branch, decompose it into child beads, then
hand off to `/do-work`. Mirrors the gh flow: this command sets up, `/do-work`
does the work, and its last pass merges the PR and closes the epic.

Two stores, and keeping them separate matters. The epic's **code** lands on the
one `bd-<id>-<slug>` branch and merges via its single PR. The **bead tracker**
lives in the shared main-repo database — worktrees reach it through a
`.beads/redirect` — and persists with `bd sync`. Bead status never rides the
code branch.

## Input

$ARGUMENTS

A bead ID. Without one, run `bd list` and ask which.

## Phase 0-2 -- Sync, fetch, gather context

```bash
gh repo view --json nameWithOwner -q .nameWithOwner   # <owner>/<repo>, for Phase 5
git pull && bd sync
git branch --show-current                             # must be main, not a worktree
bd show <id>
```

Stop if you are not on `main` in the main checkout, or if the bead is already
done. Show the bead's title and description.

Read `docs/VISION.yaml`, `docs/ARCHITECTURE.yaml`, `docs/road-map.yaml`,
…

Read the whole file at its exact version.

How to install

Latest version
mdr add petar-djukic/coding-skills/bd-issue-pop@git:20260920.1216b82
Exact content
mdr add petar-djukic/coding-skills/bd-issue-pop@sha256:19b8ea3b93800f0b

Pin to a label to follow the author's releases, or to a sha256 to freeze the exact bytes forever. Either way the resolved hash is written to mdr.lock, and mdr install reproduces it on any machine.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_a47n7ubf7u5nxcuc.svg)](https://markdownregistry.com/a/art_a47n7ubf7u5nxcuc)

1 badge views in 30 days

Versions

versioncommittedcommitsizeaudit
git:20260920.1216b82 latest2026-09-20 1216b82 8,663 BA view · diff
git:20260920.545799f2026-09-20 545799f 8,646 BA view · diff
git:20260813.79bf4fd2026-08-13 79bf4fd 7,995 BA view · diff
git:20260726.8e7c9502026-07-26 8e7c950 7,341 BA view · diff
git:20260726.77793b62026-07-26 77793b6 10,548 BA view · diff
git:20260725.bb629892026-07-25 bb62989 10,541 BA view

Audit of the latest version

A  17 of 17 checks passed. Deterministic, no model, same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (8663 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

petar-djukic/coding-skills · 3 stars · license MIT · pushed 2026-09-21 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_a47n7ubf7u5nxcuc
GET https://markdownregistry.com/api/v1/resolve?ref=petar-djukic/coding-skills/bd-issue-pop
GET https://markdownregistry.com/api/v1/blob/19b8ea3b93800f0b51e51796f412ecd1a50cae210cf038980d73c32b750d34bc

Your agent does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

More from petar-djukic/coding-skills

align-specs skill
petar-djukic/coding-skills · .agents/skills/align-specs/SKILL.md · Read **docs/constitutions/design.yaml** first and hold it as the authority for the rest of this session.
git:20260726.6744425 · audit A · 3 stars
bd-issue-push skill
petar-djukic/coding-skills · .agents/skills/bd-issue-push/SKILL.md · Create a bead (task) in the current repository using beads (`bd`). Beads keeps its database in the main repo checkout…
git:20260725.d478789 · audit A · 3 stars
bd-issue-show skill
petar-djukic/coding-skills · .agents/skills/bd-issue-show/SKILL.md · List beads or show details of a specific bead in the current repository.
git:20260725.d478789 · audit A · 3 stars
bootstrap skill
petar-djukic/coding-skills · .agents/skills/bootstrap/SKILL.md · I'm starting a new project and need you to help me create the initial documentation.
git:20260726.8e7c950 · audit A · 3 stars
do-work skill
petar-djukic/coding-skills · .agents/skills/do-work/SKILL.md · Work the units of the epic you popped, one at a time, until none remain.
git:20260920.9ef207e · audit A · 3 stars
exp-start skill
petar-djukic/coding-skills · .agents/skills/exp-start/SKILL.md · Create or join an experiment branch. Experiments run on short-lived `exp/<slug>` branches in a dedicated worktree. They…
git:20260726.8e7c950 · audit A · 3 stars
exp-stop skill
petar-djukic/coding-skills · .agents/skills/exp-stop/SKILL.md · Conclude and delete an experiment branch. Shows pending work and a diffstat for a final review, then deletes the…
git:20260725.d478789 · audit A · 3 stars
gh-issue-pop skill
petar-djukic/coding-skills · .agents/skills/gh-issue-pop/SKILL.md · Pop a GitHub issue, decompose it into sub-issues on a worktree branch, and open
git:20260920.9ef207e · audit A · 3 stars
gh-issue-push skill
petar-djukic/coding-skills · .agents/skills/gh-issue-push/SKILL.md · Create a GitHub issue in the current repository.
git:20260726.8e7c950 · audit A · 3 stars
gh-issue-show skill
petar-djukic/coding-skills · .agents/skills/gh-issue-show/SKILL.md · List GitHub issues in the current repository, or show details of a specific issue. Use when the user wants to browse…
git:20260725.d478789 · audit A · 3 stars
gh-release-push skill
petar-djukic/coding-skills · .agents/skills/gh-release-push/SKILL.md · Tag and push a release from green `main`.
git:20260921.b7d3a55 · audit A · 3 stars
make-work skill
petar-djukic/coding-skills · .agents/skills/make-work/SKILL.md · Read `docs/VISION.yaml` (goals and boundaries), `docs/ARCHITECTURE.yaml`
git:20260811.921eed5 · audit A · 3 stars

Every file in petar-djukic/coding-skills

Browse by kind, by grade A, or by owner.