Agent skill

Prd To Issues

by bestofjs in bestofjs/bestofjs

Break a PRD into independently-grabbable GitHub issues using tracer-bullet vertical slices.

MITAuto-check passedProduct & Project Management

Install Prd To Issues

skills CLI
$ npx skills add bestofjs/bestofjs --skill prd-to-issues -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install bestofjs/bestofjs prd-to-issues --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/bestofjs/bestofjs.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/prd-to-issues .claude/skills/prd-to-issues && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
prd-to-issues
GitHub stars
3.1k
Token cost
~703 tokens
SKILL.md length
384 words
Files
1
Skills in repo
13
Repo updated
First seen
Licence
MIT

At a glance

Break a PRD into independently-grabbable GitHub issues using tracer-bullet vertical slices.

  • Works in 5 steps: Locate the PRD → Explore the codebase (optional) → Draft vertical slices → …
  • User wants to convert a PRD to issues
  • SKILL.md covers Process, Parent PRD, What to build and Acceptance criteria, plus 2 more sections
  • Calls gh

What it does

Prd To Issues is an agent skill from bestofjs/bestofjs. Break a PRD into independently-grabbable GitHub issues using tracer-bullet vertical slices. Use when user wants to convert a PRD to issues, create implementation tickets, or break down a PRD into work items.

Its SKILL.md is about 700 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Product & Project Management, covering PRD writing. It works with GitHub. The repository describes itself as: :star: A place to find the best components to build amazing web applications. The best of JavaScript! The licence is MIT.

When your agent uses it

  • User wants to convert a PRD to issues
  • Create implementation tickets
  • Break down a PRD into work items

Example prompts

  • “/prd-to-issues”

Workflow steps

5 steps, taken from the step headings in SKILL.md.

  1. Locate the PRD
  2. Explore the codebase (optional)
  3. Draft vertical slices
  4. Quiz the user
  5. Create the GitHub issues

What it can do on your machine

Read from SKILL.md and the folder at commit 5d82633. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • gh

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md. Its commands use gh, which can reach the network depending on how they are called.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Prd To Issues loads about 703 tokens when it runs. Until then it costs about 55 tokens; SKILL.md has 384 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~55
When it runs · the whole SKILL.md, loaded when a task matches
~703

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from bestofjs/bestofjs at commit 5d82633, republished under its MIT licence (© bestofjs). 384 words, ~703 tokens.

Download SKILL.mdSave it as .claude/skills/prd-to-issues/SKILL.md (or your agent's skills folder).
name
prd-to-issues
description
Break a PRD into independently-grabbable GitHub issues using tracer-bullet vertical slices. Use when user wants to convert a PRD to issues, create implementation tickets, or break down a PRD into work items.

PRD to Issues

Break a PRD into independently-grabbable GitHub issues using vertical slices (tracer bullets).

Process

1. Locate the PRD

Ask the user for the PRD GitHub issue number (or URL).

If the PRD is not already in your context window, fetch it with gh issue view <number> (with comments).

2. Explore the codebase (optional)

If you have not already explored the codebase, do so to understand the current state of the code.

3. Draft vertical slices

Break the PRD into tracer bullet issues. Each issue is a thin vertical slice that cuts through ALL integration layers end-to-end, NOT a horizontal slice of one layer.

Slices may be 'HITL' or 'AFK'. HITL slices require human interaction, such as an architectural decision or a design review. AFK slices can be implemented and merged without human interaction. Prefer AFK over HITL where possible.

<vertical-slice-rules>
- Each slice delivers a narrow but COMPLETE path through every layer (schema, API, UI, tests)
- A completed slice is demoable or verifiable on its own
- Prefer many thin slices over few thick ones
</vertical-slice-rules>
4. Quiz the user

Present the proposed breakdown as a numbered list. For each slice, show:

  • Title: short descriptive name
  • Type: HITL / AFK
  • Blocked by: which other slices (if any) must complete first
  • User stories covered: which user stories from the PRD this addresses

Ask the user:

  • Does the granularity feel right? (too coarse / too fine)
  • Are the dependency relationships correct?
  • Should any slices be merged or split further?
  • Are the correct slices marked as HITL and AFK?

Iterate until the user approves the breakdown.

Show full SKILL.md (123 more words)Show less
5. Create the GitHub issues

For each approved slice, create a GitHub issue using gh issue create. Use the issue body template below.

Create issues in dependency order (blockers first) so you can reference real issue numbers in the "Blocked by" field.

<issue-template>
## Parent PRD

#<prd-issue-number>

What to build

A concise description of this vertical slice. Describe the end-to-end behavior, not layer-by-layer implementation. Reference specific sections of the parent PRD rather than duplicating content.

Acceptance criteria

  • Criterion 1
  • Criterion 2
  • Criterion 3

Blocked by

  • Blocked by #<issue-number> (if any)

Or "None - can start immediately" if no blockers.

User stories addressed

Reference by number from the parent PRD:

  • User story 3
  • User story 7
</issue-template>

Do NOT close or modify the parent PRD issue.

© bestofjs, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in .agents/skills/prd-to-issues of bestofjs/bestofjs.

Open the folder on GitHubat commit 5d82633

Compare with similar skills

Prd To Issues next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Prd To Issues compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Prd To Issues this skillbestofjs/bestofjs3.1k—~703Automated safety check: PassMIT
CCPM Project Managementautomazeio/ccpm8.4k—~1.1kAutomated safety check: PassMIT
Ouroboros PM InterviewQ00/ouroboros6.2k—~5.7kAutomated safety check: PassMIT
To Issuessmallnest/pigo476—~1.9kAutomated safety check: PassMIT
Write Update Tidb Docspingcap/docs615—~2.3kAutomated safety check: PassCustom licence
Write Product Specbholmesdev/hubble.md1.5k—~966Automated safety check: PassMIT

Similar skills

  • Runs a spec-driven workflow from PRD to epic to GitHub issues to parallel agents, with status, standup and blocked-work reports from bundled scripts.

    8.4k GitHub stars~1.1k tokensUpdated 6 mo ago
    Product & Project ManagementAuto-check passed
  • Runs a guided product-manager interview that classifies each question automatically and produces a Product Requirements Document.

    6.2k GitHub stars~5.7k tokensUpdated yesterday
    Product & Project ManagementAuto-check passed
  • To Issues

    smallnest/pigo

    Decompose a PRD and/or SPEC into implementable Issues and create them in your chosen platform (GitHub, Local, or Baidu iCafe).

    476 GitHub stars~1.9k tokensUpdated 26 days ago
    Product & Project ManagementAuto-check passed
  • Write new TiDB documentation or update existing TiDB documentation from code changes, PRs, issues, design docs, product specs, rough drafts, existing docs, or short feature descriptions.

    615 GitHub stars~2.3k tokensUpdated today
    Product & Project ManagementAuto-check passed
  • Write Product Spec

    bholmesdev/hubble.md

    Write a PRODUCT.md spec for a significant Hubble user-facing feature, focused only on user experience and observable behavior.

    1.5k GitHub stars~966 tokensUpdated 7 days ago
    Product & Project ManagementAuto-check passed
  • Foreman To Issues

    VisionForge-OU/foreman

    Break an approved PRD into small, dependency-ordered, vertically-sliced implementation issues written as local files in the Foreman feature directory.

    443 GitHub stars~1.2k tokensUpdated 3 mo ago
    Product & Project ManagementAuto-check passed

More from bestofjs/bestofjs

All 13 skills in this repo
  • Impeccable

    bestofjs/bestofjs

    A skill your agent uses when the user wants to design, redesign, shape, critique, audit, polish, clarify, distill, harden, optimize, adapt, animate, colorize, extract, or otherwise improve a…

    3.1k GitHub starsUsed in 27 repos~2.6k tokens
    Auto-check passed
  • Wayfinder

    bestofjs/bestofjs

    Plan a huge chunk of work — more than one agent session can hold — as a shared map of decision tickets on your issue tracker, and resolve them one at a time until the way to the destination is clear.

    3.1k GitHub starsUsed in 21 repos~2.9k tokens
    Auto-check passed
  • Setup Matt Pocock Skills

    bestofjs/bestofjs

    Configure this repo for the engineering skills — set up its issue tracker, triage label vocabulary, and domain doc layout.

    3.1k GitHub starsUsed in 20 repos~1.7k tokens
    Auto-check passed
  • Writing For Agents

    bestofjs/bestofjs

    Writing documents for agents. An agent skill from bestofjs/bestofjs.

    3.1k GitHub starsUsed in 18 repos~2.7k tokens
    Auto-check passed
  • Wizard

    bestofjs/bestofjs

    Generate an interactive bash wizard that walks a human through steps only they can perform.

    3.1k GitHub starsUsed in 12 repos~1k tokens
    Auto-check: notes
  • To Spec

    bestofjs/bestofjs

    Turn the current conversation into a spec and publish it to the project issue tracker — no interview, just synthesis of what you've already discussed.

    3.1k GitHub starsUsed in 21 repos~757 tokens
    Auto-check passed

Works with

Questions about Prd To Issues

What does Prd To Issues do?

Break a PRD into independently-grabbable GitHub issues using tracer-bullet vertical slices. Prd To Issues is an agent skill from bestofjs/bestofjs. Break a PRD into independently-grabbable GitHub issues using tracer-bullet vertical slices.

When should I use Prd To Issues?

Prd To Issues fits situations like: user wants to convert a PRD to issues; create implementation tickets; break down a PRD into work items.

How do I install Prd To Issues in Claude Code?

Run `npx skills add bestofjs/bestofjs --skill prd-to-issues -a claude-code`. Or copy the skill folder (.agents/skills/prd-to-issues in bestofjs/bestofjs) into .claude/skills/prd-to-issues in your project. Claude Code loads it when a task matches its description.

How do I install Prd To Issues in Codex?

Run `npx skills add bestofjs/bestofjs --skill prd-to-issues -a codex`. Or copy the skill folder (.agents/skills/prd-to-issues in bestofjs/bestofjs) into .agents/skills/prd-to-issues in your project. Codex loads it when a task matches its description.

Can I use Prd To Issues in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add bestofjs/bestofjs --skill prd-to-issues -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/prd-to-issues, .gemini/skills/prd-to-issues, .github/skills/prd-to-issues and .opencode/skills/prd-to-issues in your project.

What does Prd To Issues need to run?

Going by SKILL.md and its folder, Prd To Issues needs the command-line tools its instructions call (gh).

Does Prd To Issues access the network?

SKILL.md contains no URLs. Its commands use gh, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Prd To Issues safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Prd To Issues use?

Prd To Issues is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Prd To Issues use?

About 703 tokens (SKILL.md is roughly 2.8k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Prd To Issues?

Skills that share tags, products or a category with Prd To Issues: CCPM Project Management (automazeio/ccpm, 8.4k stars), Ouroboros PM Interview (Q00/ouroboros, 6.2k stars), To Issues (smallnest/pigo, 476 stars) and Write Update Tidb Docs (pingcap/docs, 615 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Prd To Issues?

bestofjs (a GitHub organization) maintains it in bestofjs/bestofjs, which has 3,136 GitHub stars. The repository holds 13 skills in this directory. The repository was last updated on October 4, 2026.

Source: bestofjs/bestofjs on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.