Agent skill

Bootstrap Prd

by joshukraine in joshukraine/dotfiles

Set up PRD-driven development infrastructure for a new project, including directory structure, templates, and roadmap.

MITAuto-check passedProduct & Project Management

Install Bootstrap Prd

skills CLI
$ npx skills add joshukraine/dotfiles --skill bootstrap-prd -a claude-code

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

GitHub CLI
$ gh skill install joshukraine/dotfiles bootstrap-prd --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/joshukraine/dotfiles.git skills-src && mkdir -p .claude/skills && cp -r skills-src/claude/.claude/skills/bootstrap-prd .claude/skills/bootstrap-prd && 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
bootstrap-prd
GitHub stars
429
Token cost
~1.8k tokens
SKILL.md length
909 words
Files
1
Skills in repo
24
Repo updated
First seen
Licence
MIT

At a glance

Set up PRD-driven development infrastructure for a new project, including directory structure, templates, and roadmap.

  • Works in 7 steps: Detect existing PRD files → Gather project information… → Read templates → …
  • Tasks that involve PRD writing
  • SKILL.md covers Your task and Important
  • Calls npm, git and rails

What it does

Bootstrap Prd is an agent skill from joshukraine/dotfiles. Set up PRD-driven development infrastructure for a new project, including directory structure, templates, and roadmap.

Its SKILL.md is about 1.8k 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 npm. The repository describes itself as: :roundpushpin: My dotfiles for macOS using Neovim, Zsh, and Ghostty + Tmux. The licence is MIT.

When your agent uses it

  • Tasks that involve PRD writing

Example prompts

  • “/bootstrap-prd”

Workflow steps

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

  1. Detect existing PRD files
  2. Gather project information (scaffold-first mode only)
  3. Read templates
  4. Check for existing files and determine what needs to be created
  5. Present the plan
  6. Create files
  7. Report

What it can do on your machine

Read from SKILL.md and the folder at commit b59ad5b. 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:

    • npm
    • git
    • rails
    • gh

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

  • Network

    No URLs in SKILL.md. Its commands use npm, git and 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

Bootstrap Prd loads about 1.8k tokens when it runs. Until then it costs about 33 tokens; SKILL.md has 909 words of instructions outside code blocks.

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

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 joshukraine/dotfiles at commit b59ad5b, republished under its MIT licence (© joshukraine). 909 words, ~1,822 tokens.

Download SKILL.mdSave it as .claude/skills/bootstrap-prd/SKILL.md (or your agent's skills folder).
name
bootstrap-prd
description
Set up PRD-driven development infrastructure for a new project, including directory structure, templates, and roadmap.
disable-model-invocation
true

Bootstrap PRD

Set up PRD-driven development infrastructure for a new project. This skill handles two workflows: PRD-first (PRD files already exist, scaffold the project around them) and scaffold-first (no PRD yet, create template files to be filled in). The skill detects which situation applies and adapts.

Your task

Work through the steps below in order. Each step has a hard stop — do not proceed past a CHECKPOINT without explicit user approval.


Step 1: Detect existing PRD files

Check whether docs/prd/ exists and contains any .md files.

If PRD files exist → enter PRD-first mode:

  • Read all .md files in docs/prd/ to understand the project
  • Extract: project name, description, tech stack, personas, and any quick-start commands mentioned
  • Skip to Step 3 (no need to gather information the PRD already contains)

If no PRD files exist → enter scaffold-first mode:

  • Proceed to Step 2 to gather project information

Step 2: Gather project information (scaffold-first mode only)

Ask the user for the following. Skip anything already provided in the conversation context.

  • Project name (e.g., "Acme Dashboard")
  • One-paragraph description of what the project does and who it serves
  • Tech stack — framework, database, frontend approach, linter, test framework
  • Key personas — 1-3 user types with a sentence each
  • Quick-start commands — how to start the app, run tests, run the linter

If the user provides a framework name, pre-fill quick-start commands from this lookup table (the user can override):

FrameworkStartTestLint
Railsbin/devbin/rails testbin/standardrb --fix
Next.jsnpm run devnpm testnpm run lint
Hugohugo server -D(none)(none)
Static (no build)Open index.html or use a local server(none)(none)
Generic<!-- TODO: start command --><!-- TODO: test command --><!-- TODO: lint command -->

Step 3: Read templates

Read the template files that may be needed:

  • ~/.claude/docs/prd-workflow/templates/CLAUDE.md
  • ~/.claude/docs/prd-workflow/templates/prd/README.md
  • ~/.claude/docs/prd-workflow/templates/prd/ROADMAP.md
  • ~/.claude/docs/prd-workflow/templates/prd/CHANGELOG.md
  • ~/.claude/docs/prd-workflow/templates/prd/01-overview.md

In PRD-first mode, only CLAUDE.md is typically needed — the PRD files already exist.


Step 4: Check for existing files and determine what needs to be created

Check which of the following already exist in the project:

  • CLAUDE.md (repo root)
  • docs/prd/README.md
  • docs/prd/ROADMAP.md
  • docs/prd/CHANGELOG.md
  • docs/prd/01-overview.md
  • .git/ directory (is this already a git repo?)

Build a list of files to create (those that don't already exist) and files to skip (those that do).


Step 5: Present the plan

CHECKPOINT 1: Present a summary and wait for explicit approval before writing any files.

In PRD-first mode, the summary should include:

  • Mode: PRD-first (existing PRD files detected)
  • Project: Name and one-line description (extracted from the PRD)
  • PRD files found: List the existing files in docs/prd/
  • Files to create: Typically just CLAUDE.md — list with full paths
  • What gets customized in CLAUDE.md: Project name, description, tech stack, quick-start commands (all extracted from the PRD)
  • What stays as TODO: Any CLAUDE.md sections that can't be inferred from the PRD (guardrails, linter specifics, etc.)
  • Git setup: Whether git init is needed, whether to create a GitHub repo
  • Conflicts: Any files that already exist where creation was expected

In scaffold-first mode, the summary should include:

  • Mode: Scaffold-first (creating template PRD files)
  • Project: Name and one-line description
  • Files to create (full paths):
    • CLAUDE.md
    • docs/prd/README.md
    • docs/prd/ROADMAP.md
    • docs/prd/CHANGELOG.md
    • docs/prd/01-overview.md
  • What gets customized: Project name, description, tech stack table, personas, quick-start commands
  • What stays as TODO: Guardrails, terminology, linter/test details — marked with <!-- TODO: ... --> comments
  • Conflicts: Any existing files detected

Do not create any files until the user approves.


Show full SKILL.md (374 more words)Show less
Step 6: Create files

After approval, create each file:

In PRD-first mode:

  1. Create CLAUDE.md from the template, populated with information extracted from the existing PRD files (project name, description, tech stack, quick-start commands, key file references)
  2. Initialize git if .git/ doesn't exist: git init
  3. Create GitHub repo if the user approved it in the checkpoint: gh repo create <repo-name> --public --source=. --push (or --private based on user preference)
  4. Skip PRD files — they already exist

In scaffold-first mode:

  1. Create all PRD template files by copying templates and applying substitutions:
    • Replace [Project Name] with the actual project name in all files
    • Fill in gathered details: description paragraph, tech stack table rows, persona sections, quick-start commands
    • Leave unfillable placeholders as <!-- TODO: ... --> comments
  2. Create docs/prd/ directory as needed
  3. Create CLAUDE.md from template with gathered details
  4. Initialize git if .git/ doesn't exist: git init
  5. Skip any files the user chose not to overwrite in the checkpoint

Step 7: Report

CHECKPOINT 2: Present a summary of what was created and what remains.

In PRD-first mode:

  • Files created: List each file with its path
  • Remaining TODOs: List the <!-- TODO: ... --> placeholders left in CLAUDE.md
  • Suggested next steps:
    1. Review and fill in architectural guardrails in CLAUDE.md
    2. If GitHub repo was created: verify it's accessible and Pages is configured (if applicable)
    3. Set up GitHub labels if using the issue tracker (see ~/.claude/docs/label-taxonomy.md)
    4. Begin Phase 0 of the ROADMAP

In scaffold-first mode:

  • Files created: List each file with its path
  • Remaining TODOs: List the <!-- TODO: ... --> placeholders left in each file
  • Suggested next steps:
    1. Fill in architectural guardrails in CLAUDE.md
    2. Add project-specific phases to docs/prd/ROADMAP.md
    3. Set up GitHub labels (see ~/.claude/docs/label-taxonomy.md)
    4. Commit the scaffolded files (Conventional Commits — see CLAUDE.md "Git Commit Protocol")

Important

  • This skill creates project files only. It does not write application code or call any external APIs beyond git and gh.
  • Both checkpoints are hard stops. Do not proceed without explicit approval.
  • Shared docs are NOT copied. ~/.claude/docs/label-taxonomy.md remains a global reference — it should not be duplicated into individual projects.
  • If a context window clear is needed, it is safe to do so after Step 7 — the files exist on disk and will survive the clear.

© joshukraine, 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 claude/.claude/skills/bootstrap-prd of joshukraine/dotfiles.

Open the folder on GitHubat commit b59ad5b

Compare with similar skills

Bootstrap Prd 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.

Bootstrap Prd compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Bootstrap Prd this skilljoshukraine/dotfiles429—~1.8kAutomated safety check: PassMIT
Cabloy Spec Generationcabloy/cabloy982—~3.2kAutomated safety check: NotesMIT
Sveltekit WebappLeoYeAI/openclaw-master-skills2.2k—~5.2kAutomated safety check: NotesMIT
CCPM Project Managementautomazeio/ccpm8.4k—~1.1kAutomated safety check: PassMIT
Ralph Tui Create Beadssubsy/ralph-tui2.5k1 repos~2.6kAutomated safety check: PassMIT
Trellis Brainstormanjiemo/SunnyBeach1787 repos~4kAutomated safety check: PassApache-2.0

Similar skills

  • A skill your agent uses to create or maintain Cabloy suite specifications under repo-specs, including PRD, SRS, PDP/WBS, acceptance planning, progress, and suite ADRs.

    982 GitHub stars~3.2k tokensUpdated today
    Product & Project ManagementAuto-check: notes
  • Sveltekit Webapp

    LeoYeAI/openclaw-master-skills

    Scaffold and configure a production-ready SvelteKit PWA with opinionated defaults.

    2.2k GitHub stars~5.2k tokensUpdated 2 mo ago
    Product & Project ManagementAuto-check: notes
  • 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
  • Ralph Tui Create Beads

    subsy/ralph-tui

    Convert PRDs to beads for ralph-tui execution. An agent skill from subsy/ralph-tui.

    2.5k GitHub starsUsed in 1 repo~2.6k tokens
    Product & Project ManagementAuto-check passed
  • Trellis Brainstorm

    anjiemo/SunnyBeach

    Guides collaborative requirements discovery before implementation.

    178 GitHub starsUsed in 7 repos~4k tokens
    Product & Project ManagementAuto-check passed
  • Adversarial Spec

    zscole/adversarial-spec

    Iteratively refine a product spec by debating with multiple LLMs (GPT, Gemini, Grok, etc.) until all models agree.

    556 GitHub starsUsed in 1 repo~8.3k tokens
    Product & Project ManagementAuto-check: notes

More from joshukraine/dotfiles

All 24 skills in this repo
  • Todoist CLI

    joshukraine/dotfiles

    Manage Todoist tasks, projects, labels, filters, sections, comments, reminders, and workspaces via the td CLI.

    429 GitHub starsUsed in 2 repos~6.9k tokens
    Auto-check passed
  • Autopilot Triage

    joshukraine/dotfiles

    Vet open issues for autonomous resolution and queue the qualifying ones with the autopilot-queued label — the start-of-day "fill the queue" half of the triage → run split.

    429 GitHub stars~2.1k tokensUpdated 2 days ago
    Auto-check passed
  • Checkpoint

    joshukraine/dotfiles

    Quick 2-minute status update on current phase, completed work, blockers, and health check.

    429 GitHub stars~600 tokensUpdated 2 days ago
    Auto-check passed
  • Create PR

    joshukraine/dotfiles

    Create a pull request with auto-generated description, issue linking, ROADMAP updates, and PR-metadata validation.

    429 GitHub stars~1.3k tokensUpdated 2 days ago
    Auto-check passed
  • Debrief

    joshukraine/dotfiles

    Detailed technical walkthrough covering architecture, test coverage, product tour, and key design decisions.

    429 GitHub stars~2.5k tokensUpdated 2 days ago
    Auto-check passed
  • Drift Check

    joshukraine/dotfiles

    Pre-PR advisory check for deviations from the project spec. An agent skill from joshukraine/dotfiles.

    429 GitHub stars~1.2k tokensUpdated 2 days ago
    Auto-check passed

Works with

Questions about Bootstrap Prd

What does Bootstrap Prd do?

Set up PRD-driven development infrastructure for a new project, including directory structure, templates, and roadmap. Bootstrap Prd is an agent skill from joshukraine/dotfiles. Set up PRD-driven development infrastructure for a new project, including directory structure, templates, and roadmap.

When should I use Bootstrap Prd?

Bootstrap Prd fits situations like: tasks that involve PRD writing.

How do I install Bootstrap Prd in Claude Code?

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

How do I install Bootstrap Prd in Codex?

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

Can I use Bootstrap Prd 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 joshukraine/dotfiles --skill bootstrap-prd -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/bootstrap-prd, .gemini/skills/bootstrap-prd, .github/skills/bootstrap-prd and .opencode/skills/bootstrap-prd in your project.

What does Bootstrap Prd need to run?

Going by SKILL.md and its folder, Bootstrap Prd needs the command-line tools its instructions call (npm, git, rails and gh).

Does Bootstrap Prd access the network?

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

Is Bootstrap Prd 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 Bootstrap Prd use?

Bootstrap Prd 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 Bootstrap Prd use?

About 1.8k tokens (SKILL.md is roughly 7.3k 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 Bootstrap Prd?

Skills that share tags, products or a category with Bootstrap Prd: Cabloy Spec Generation (cabloy/cabloy, 982 stars), Sveltekit Webapp (LeoYeAI/openclaw-master-skills, 2.2k stars), CCPM Project Management (automazeio/ccpm, 8.4k stars) and Ralph Tui Create Beads (subsy/ralph-tui, 2.5k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Bootstrap Prd?

joshukraine (a GitHub user) maintains it in joshukraine/dotfiles, which has 429 GitHub stars. The repository holds 24 skills in this directory. The repository was last updated on October 6, 2026.

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