Agent skill

Write A Prd

Creates PRD via interactive interview + codebase exploration + module design.

Apache-2.0Auto-check: notesProduct & Project Management

Install Write A Prd

skills CLI

$ npx skills add softspark/ai-toolkit --skill write-a-prd -a claude-code

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

GitHub CLI

$ gh skill install softspark/ai-toolkit write-a-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/softspark/ai-toolkit.git skills-src && mkdir -p .claude/skills && cp -r skills-src/app/skills/write-a-prd .claude/skills/write-a-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/

Paste into Claude Code

Install the "write-a-prd" agent skill from https://github.com/softspark/ai-toolkit/tree/main/app/skills/write-a-prd into .claude/skills/write-a-prd/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "write-a-prd", then confirm the skill loads.

Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

$skill-installer

$skill-installer install https://github.com/softspark/ai-toolkit/tree/main/app/skills/write-a-prd

Type this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.

skills CLI

$ npx skills add softspark/ai-toolkit --skill write-a-prd -a codex

Project install goes to .agents/skills/; add -g for ~/.codex/skills/.

GitHub CLI

$ gh skill install softspark/ai-toolkit write-a-prd --agent codex

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/softspark/ai-toolkit.git skills-src && mkdir -p .agents/skills && cp -r skills-src/app/skills/write-a-prd .agents/skills/write-a-prd && rm -rf skills-src

Use ~/.agents/skills/ instead of .agents/skills for a personal install.

Codex skills documentation · loads skills from .agents/skills/

Paste into Codex

Install the "write-a-prd" agent skill from https://github.com/softspark/ai-toolkit/tree/main/app/skills/write-a-prd into .agents/skills/write-a-prd/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "write-a-prd", then confirm the skill loads.

Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add softspark/ai-toolkit --skill write-a-prd -a cursor

Project install goes to .agents/skills/; add -g for ~/.cursor/skills/.

GitHub CLI

$ gh skill install softspark/ai-toolkit write-a-prd --agent cursor

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/softspark/ai-toolkit.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/app/skills/write-a-prd .cursor/skills/write-a-prd && rm -rf skills-src

Use ~/.cursor/skills/ instead of .cursor/skills for a personal install.

Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/

Paste into Cursor

Install the "write-a-prd" agent skill from https://github.com/softspark/ai-toolkit/tree/main/app/skills/write-a-prd into .cursor/skills/write-a-prd/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "write-a-prd", then confirm the skill loads.

Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

gemini skills install

$ gemini skills install https://github.com/softspark/ai-toolkit.git --path app/skills/write-a-prd

--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.

skills CLI

$ npx skills add softspark/ai-toolkit --skill write-a-prd -a gemini-cli

Project install goes to .agents/skills/; add -g for ~/.gemini/skills/.

GitHub CLI

$ gh skill install softspark/ai-toolkit write-a-prd --agent gemini-cli

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/softspark/ai-toolkit.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/app/skills/write-a-prd .gemini/skills/write-a-prd && rm -rf skills-src

Use ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.

Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/

Paste into Gemini CLI

Install the "write-a-prd" agent skill from https://github.com/softspark/ai-toolkit/tree/main/app/skills/write-a-prd into .gemini/skills/write-a-prd/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "write-a-prd", then confirm the skill loads.

Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

GitHub CLI

$ gh skill install softspark/ai-toolkit write-a-prd

Installs for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).

skills CLI

$ npx skills add softspark/ai-toolkit --skill write-a-prd -a github-copilot

Project install goes to .agents/skills/; add -g for ~/.copilot/skills/.

Manual copy

$ git clone --depth 1 https://github.com/softspark/ai-toolkit.git skills-src && mkdir -p .github/skills && cp -r skills-src/app/skills/write-a-prd .github/skills/write-a-prd && rm -rf skills-src

Use ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.

GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/

Paste into GitHub Copilot

Install the "write-a-prd" agent skill from https://github.com/softspark/ai-toolkit/tree/main/app/skills/write-a-prd into .github/skills/write-a-prd/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "write-a-prd", then confirm the skill loads.

GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add softspark/ai-toolkit --skill write-a-prd -a opencode

OpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.

GitHub CLI

$ gh skill install softspark/ai-toolkit write-a-prd --agent opencode

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/softspark/ai-toolkit.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/app/skills/write-a-prd .opencode/skills/write-a-prd && rm -rf skills-src

Use ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.

OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/

Paste into OpenCode

Install the "write-a-prd" agent skill from https://github.com/softspark/ai-toolkit/tree/main/app/skills/write-a-prd into .opencode/skills/write-a-prd/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "write-a-prd", then confirm the skill loads.

OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

Facts

Skill name: write-a-prd
GitHub stars: 179
Token cost: ~932 tokens
SKILL.md length: 469 words
Files: 5 (incl. scripts)
Skills in repo: 112
Repo updated: Oct 7, 2026
First seen: Oct 7, 2026
Licence: Apache-2.0

At a glance

Creates PRD via interactive interview + codebase exploration + module design.

Works in 5 steps: Gather Problem Description → Explore the Codebase → Interview Relentlessly → …
Tasks that involve PRD writing
SKILL.md covers Usage, What This Command Does, Process and PRD Template, plus 9 more sections
Runs JavaScript scripts from its folder; calls gh

What it does

Write A Prd is an agent skill from softspark/ai-toolkit. Creates PRD via interactive interview + codebase exploration + module design. Triggers: write PRD, product requirements, plan new feature, PRD interview.

Its SKILL.md is about 930 tokens, which your agent loads only when the skill is triggered. The skill folder holds 6 other files, including scripts (for example `reference/visual-companion.md` and `scripts/poll.js`).

It sits in Product & Project Management, covering PRD writing. It works with GitHub. The repository describes itself as: Professional-grade AI coding toolkit: 94 skills, 44 agents, multi-platform (Claude, Cursor, Windsurf, Copilot, Gemini, Cline, Roo Code, Aider, Augment, Antigravity, Codex CLI… The licence is Apache-2.0.

When your agent uses it

Tasks that involve PRD writing

Example prompts

“Use the write-a-prd skill to create PRD via interactive interview + codebase exploration + module design”
“/write-a-prd”

Requirements

Node.js
Pre-approved tools (allowed-tools): Read, Grep, Glob, Bash, Agent

Workflow steps

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

Gather Problem Description
Explore the Codebase
Interview Relentlessly
Sketch Modules
Write and Submit PRD

What it can do on your machine

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

Tool permissions
Pre-approves these tools, so the agent can use them without asking each time:
- Read
- Grep
- Glob
- Bash
- Agent
From allowed-tools in the SKILL.md frontmatter.
Runs code
Ships 3 files in scripts/ (JavaScript), which the agent can run.
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

Write A Prd loads about 932 tokens when it runs. Until then it costs about 41 tokens; SKILL.md has 469 words of instructions outside code blocks.

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

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: notes

The automated check noted patterns worth knowing about, such as sudo or a known installer.

NotePre-approves every shell command (allowed-tools: Bash)SKILL.md
```
allowed-tools: Read, Grep, Glob, Bash, Agent
```

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); the scripts in this folder are not scanned.

SKILL.md

The full file from softspark/ai-toolkit at commit d64db2b, republished under its Apache-2.0 licence (© softspark). 469 words, ~932 tokens.

Download SKILL.mdSave it as .claude/skills/write-a-prd/SKILL.md (or your agent's skills folder). This skill also uses 4 other files; get the full folder from GitHub.

name: write-a-prd
description: Creates PRD via interactive interview + codebase exploration + module design. Triggers: write PRD, product requirements, plan new feature, PRD interview.
allowed-tools: Read, Grep, Glob, Bash, Agent
user-invocable: true
effort: high
argument-hint: [feature or problem description]

Write a PRD

$ARGUMENTS

Create a PRD through structured interview, codebase exploration, and module design, then submit as a GitHub issue.

Usage

/write-a-prd [feature or problem description]

What This Command Does

Gathers detailed problem description from user
Explores the codebase to verify assertions and understand current state
Interviews relentlessly about every design branch until shared understanding
Sketches major modules — actively seeking deep modules (small interface, deep implementation)
Writes the PRD and submits as GitHub issue via gh issue create

Process

1. Gather Problem Description

Ask the user for a detailed description of:

The problem they want to solve
Any potential ideas for solutions
Who the users/actors are

2. Explore the Codebase

Use Agent (subagent_type=Explore) to understand:

Current architecture relevant to the feature
Existing patterns and conventions
Integration points
Related code that might be affected

3. Interview Relentlessly

Walk down each branch of the design tree, resolving dependencies between decisions one-by-one. For each question, provide your recommended answer.

Ask questions one at a time. If a question can be answered by exploring the codebase, explore instead of asking.

4. Sketch Modules

Identify major modules to build or modify. Look for opportunities to extract deep modules — modules that encapsulate significant functionality behind a simple, testable interface.

Check with the user:

Do these modules match their expectations?
Which modules need tests?

5. Write and Submit PRD

Use the template below. Submit as GitHub issue via gh issue create. Share the URL.

PRD Template

<prd-template>

Problem Statement

The problem from the user's perspective.

Solution

The solution from the user's perspective.

User Stories

Extensive numbered list:

As an <actor>, I want a <feature>, so that <benefit>

Cover ALL aspects of the feature.

Show full SKILL.md (191 more words)Show less

Implementation Decisions

Modules to build/modify
Interface designs for those modules
Architectural decisions
Schema changes
API contracts

Do NOT include specific file paths or code snippets — they go stale quickly.

Testing Decisions

What makes a good test (external behavior, not implementation details)
Which modules to test
Prior art for tests in the codebase

Out of Scope

What is explicitly NOT part of this PRD.

Further Notes

Any additional context.

</prd-template>

Visual Companion (Optional)

When upcoming questions will involve visual content (mockups, layouts, diagrams), offer the browser companion:

"Some of what we're working on might be easier to explain visually. I can show mockups and diagrams in a browser. Want to try it?"

This offer MUST be its own message. Do not combine with other questions. Wait for response.

If accepted, start the server and use it for visual questions only. Text/conceptual questions stay in terminal.

See reference/visual-companion.md for details.

Rules

Interview relentlessly — don't settle for vague answers
No file paths or code snippets in the PRD (durability principle)
User stories must be extensive and cover all aspects
Submit immediately via gh issue create — don't ask for review
Deep modules over shallow modules

Files

SKILL.md and 4 other files (scripts) in app/skills/write-a-prd of softspark/ai-toolkit.

SKILL.md
reference/visual-companion.md
scripts/frame-template.html
scripts/poll.js
scripts/visual-server.cjs

Open the folder on GitHubat commit d64db2b

Compare with similar skills

Write A 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.

Write A Prd compared with similar skills
Skill	Stars	Used in	Tokens	Auto-check	Licence	Repo updated
Write A Prd this skillsoftspark/ai-toolkit	179	—	~932	Automated safety check: Notes	Apache-2.0	yesterday
CCPM Project Managementautomazeio/ccpm	8.4k	—	~1.1k	Automated safety check: Pass	MIT	6 mo ago
Ouroboros PM InterviewQ00/ouroboros	6.2k	1 repos	~5.7k	Automated safety check: Pass	MIT	today
To Issuessmallnest/pigo	475	—	~1.9k	Automated safety check: Pass	MIT	25 days ago
Write A Prdbestofjs/bestofjs	3.1k	1 repos	~722	Automated safety check: Pass	MIT	3 days ago
Write Update Tidb Docspingcap/docs	616	—	~2.3k	Automated safety check: Pass	Custom licence	today

Similar skills

CCPM Project Management
automazeio/ccpm
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
Ouroboros PM Interview
Q00/ouroboros
Runs a guided product-manager interview that classifies each question automatically and produces a Product Requirements Document.
6.2k GitHub starsUsed in 1 repo~5.7k tokens
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).
475 GitHub stars~1.9k tokensUpdated 25 days ago
Product & Project ManagementAuto-check passed
Write A Prd
bestofjs/bestofjs
Create a PRD through user interview, codebase exploration, and module design, then submit as a GitHub issue.
3.1k GitHub starsUsed in 1 repo~722 tokens
Product & Project ManagementAuto-check passed
Write Update Tidb Docs
pingcap/docs
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.
616 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 6 days ago
Product & Project ManagementAuto-check passed

Questions about Write A Prd

What does Write A Prd do?

Creates PRD via interactive interview + codebase exploration + module design. Write A Prd is an agent skill from softspark/ai-toolkit. Creates PRD via interactive interview + codebase exploration + module design.

When should I use Write A Prd?

Write A Prd fits situations like: tasks that involve PRD writing.

How do I install Write A Prd in Claude Code?

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

How do I install Write A Prd in Codex?

Run `npx skills add softspark/ai-toolkit --skill write-a-prd -a codex`. Or copy the skill folder (app/skills/write-a-prd in softspark/ai-toolkit) into .agents/skills/write-a-prd in your project. Codex loads it when a task matches its description.

Can I use Write A 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 softspark/ai-toolkit --skill write-a-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/write-a-prd, .gemini/skills/write-a-prd, .github/skills/write-a-prd and .opencode/skills/write-a-prd in your project.

What does Write A Prd need to run?

Going by SKILL.md and its folder, Write A Prd needs JavaScript for the scripts in its folder and the command-line tools its instructions call (gh). Our summary lists: Node.js. Its frontmatter pre-approves these tools: Read, Grep, Glob, Bash, Agent.

Does Write A Prd 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 Write A Prd safe to install?

Our automated static check of SKILL.md found notes only (pre-approves every shell command (allowed-tools: bash)), nothing it rates as a warning. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Write A Prd use?

Write A Prd is published under the Apache-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Write A Prd use?

About 932 tokens (SKILL.md is roughly 3.7k 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 Write A Prd?

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

Who maintains Write A Prd?

softspark (a GitHub user) maintains it in softspark/ai-toolkit, which has 179 GitHub stars. The repository holds 112 skills in this directory. The repository was last updated on October 7, 2026.

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

Install Write A Prd

Facts

At a glance

What it does

When your agent uses it

Example prompts

Requirements

Workflow steps

What it can do on your machine

Tool permissions

Runs code

Network

Credentials

Context cost

Safety

SKILL.md

Write a PRD

Usage

What This Command Does

Process

1. Gather Problem Description

2. Explore the Codebase

3. Interview Relentlessly

4. Sketch Modules

5. Write and Submit PRD

PRD Template

Problem Statement

Solution

User Stories

Implementation Decisions

Testing Decisions

Out of Scope

Further Notes

Visual Companion (Optional)

Rules

Files

Compare with similar skills

Similar skills

More from softspark/ai-toolkit

Related

Questions about Write A Prd