SkillAgentSearch skills...

generate-prd

Generate product requirements documents with optional publishing to Confluence or other wiki platforms

Install / Use

npx skills add huytieu/COG-second-brain --skill generate-prd

Installs into whichever agent you are using.

About this skill
๐Ÿ“„

SKILL.md

Installable skill definition

Quality Score

89/100

Supported Platforms

Universal

Our assessment of generate-prd

generate-prd scores 89/100 on our quality scale, 520th of 1,155 Content & Media skills we index (top 46%).

Its SKILL.md is 9.2 KB long, well organised into 52 sections with 9 code examples: a thorough specification that gives an agent plenty to work with.

With 1,216 GitHub stars, it is one of the more widely adopted skills in the catalogue.

Substance
29/30
Structure
20/20
Description
12/15
Adoption
13/20
Freshness
15/15

Maintenance, license and trust

  • The repository was last updated about 2 months ago, so generate-prd is actively maintained.
  • Our last check on 2026-10-31 found the source still online.
  • It is released under the MIT license, a permissive license that allows use, modification and commercial use with attribution.
  • Its trust signals score 100/100, with no cautions. These come from repository metadata, not a code audit โ€” read the skill file before letting an agent act on it.

Safety scan

No issues found

Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful.

AI review by kimi-k2.7-code on 2026-10-06. Automated pattern scan on 2026-10-05. It catches known dangerous patterns, not every risk โ€” read a skill before letting an agent act on it.

generate-prd compared with similar skills

All 4 of these similar skills score higher than generate-prd; compare them before choosing.

SkillScoreStarsUpdatedFormat
generate-prd (this skill)by huytieu891.2k59d agoSKILL.md
Claude-Code-Game-Studiosby Donchitos10039.7k7d agoCLAUDE.md
siyuanby siyuan-note10047.3ktodayMCP Server
x402by browser-use100121.0k3d agoSKILL.md
algorithmic-artby anthropics100177.9k55d agoSKILL.md

Frequently asked questions

How do I install generate-prd?
Run npx skills add huytieu/COG-second-brain --skill generate-prd. The install tabs above show the steps for each supported agent.
Which AI agents does generate-prd work with?
It is written for Universal, as a SKILL.md file. Other agents that read the same format can often use it too.
Is generate-prd safe to use?
Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful. It is MIT-licensed and scores 100/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
Is generate-prd still maintained?
The repository was last updated about 2 months ago, so generate-prd is actively maintained.

name: generate-prd description: Generate product requirements documents with optional publishing to Confluence or other wiki platforms roles: [product-manager, engineering-lead, founder] integrations: [confluence, notion, hackmd]

COG Generate PRD Skill

When to Invoke

  • User wants to create a PRD, product spec, or requirements document
  • User says "generate PRD", "write PRD", "product requirements", "spec doc", "feature spec"
  • User has a feature or project that needs formal documentation before development

Agent Mode Awareness

Check agent_mode in 00-inbox/MY-PROFILE.md frontmatter:

  • If agent_mode: team โ€” use parallel agents to gather context from multiple sources (existing PRDs, related issues, competitive research) while drafting
  • If agent_mode: solo โ€” gather context and draft sequentially in the main conversation

Command: /generate-prd

Pre-Flight Check

  1. Read 00-inbox/MY-INTEGRATIONS.md to determine publishing options:

    • Confluence โ€” can publish PRD to team wiki
    • Notion โ€” can publish PRD to Notion workspace
    • HackMD โ€” can publish PRD as shared markdown doc
    • If none active, PRD stays in the vault only (still fully useful)
  2. Read 00-inbox/MY-PROFILE.md for:

    • Active projects
    • User's name and role (for PRD author field)
  3. Get current timestamp: Run date '+%Y-%m-%d %H:%M' using Bash for the created: frontmatter field


Execution Strategy

Phase 1: Gather Requirements

Ask the user for the following (skip what they've already provided):

Required:

  • Feature/product name
  • Problem statement โ€” what problem are we solving?
  • Target users โ€” who is this for?
  • High-level solution โ€” what are we building?

Optional (will generate reasonable defaults if not provided):

  • Success metrics โ€” how do we measure success?
  • Constraints โ€” technical, time, budget, or regulatory constraints
  • Dependencies โ€” what does this depend on?
  • Related documents โ€” links to designs, research, prior art
  • Target timeline โ€” when does this need to ship?

Phase 2: Context Gathering

Team Mode (parallel agents)

Launch context-gathering agents using the Task tool with run_in_background: true:

Agent: "existing-prd-scanner"

Scan the vault for existing PRDs and related documents.

1. Glob for PRDs: 04-projects/*/PRDs/*.md
2. Glob for related project files: 04-projects/[project]/**/*.md
3. Read recent PRDs to understand the user's preferred format and level of detail
4. Look for any existing docs related to the feature being specified

Return: relevant existing content, user's PRD style preferences, and any related docs

Agent: "issue-context-gatherer"

Gather related issues and feature requests from active trackers.

Check 00-inbox/MY-INTEGRATIONS.md for active trackers, then:

If Linear is active:
1. Use ToolSearch to load Linear tools
2. Search for issues related to [feature keywords]
3. Check current initiatives and projects for context

If GitHub is active:
1. gh search issues "[feature keywords]" --repo [CUSTOMIZE: your-org/your-repo] --json number,title,body,labels --limit 15
2. Check for related discussions or feature requests

Return: related issues, existing feature requests, and any prior discussion context

Solo Mode

Run the same context gathering sequentially.

Phase 3: Generate PRD

Create the PRD using this template:

---
type: prd
project: [project-name]
feature: [feature-name]
status: draft
author: [user name]
created: [YYYY-MM-DD HH:MM]
last_updated: [YYYY-MM-DD]
version: "1.0"
approvers: [CUSTOMIZE: list of approvers]
tags: ["#prd", "#product", "#[project-name]"]
---

# PRD: [Feature Name]

## Overview

| Field | Value |
|-------|-------|
| **Author** | [Name] |
| **Status** | Draft |
| **Created** | [Date] |
| **Target Release** | [Timeline or TBD] |
| **Priority** | [High/Medium/Low] |

---

## 1. Problem Statement

[Clear description of the problem being solved. Include data or evidence where available.]

### Who is affected?
[Target users and how they're impacted]

### What is the current experience?
[How users currently deal with this problem]

### Why now?
[Why this is important to solve at this time]

---

## 2. Goals & Success Metrics

### Goals
1. [Primary goal]
2. [Secondary goal]
3. [Tertiary goal]

### Success Metrics
| Metric | Current Baseline | Target | Measurement Method |
|--------|-----------------|--------|-------------------|
| [Metric 1] | [Current] | [Target] | [How to measure] |
| [Metric 2] | [Current] | [Target] | [How to measure] |

### Non-Goals
- [What this project explicitly does NOT aim to solve]
- [Scope boundaries]

---

## 3. User Stories

### Primary User: [User Type]

**Story 1:** As a [user type], I want [goal] so that [benefit].

**Story 2:** As a [user type], I want [goal] so that [benefit].

### Secondary User: [User Type] (if applicable)

**Story 3:** As a [user type], I want [goal] so that [benefit].

---

## 4. Proposed Solution

### 4.1 Solution Overview
[High-level description of the proposed solution]

### 4.2 Key Features
1. **[Feature 1]** โ€” [Description]
2. **[Feature 2]** โ€” [Description]
3. **[Feature 3]** โ€” [Description]

### 4.3 User Flow
[Step-by-step description of the primary user flow]

1. User [action]
2. System [response]
3. User [action]
4. System [response]

### 4.4 Edge Cases & Error Handling
| Scenario | Expected Behavior |
|----------|------------------|
| [Edge case 1] | [How the system handles it] |
| [Edge case 2] | [How the system handles it] |

---

## 5. Technical Considerations

### Architecture Impact
[How this fits into the existing system architecture]

### Dependencies
- [Dependency 1] โ€” [Status: available/needs work]
- [Dependency 2] โ€” [Status: available/needs work]

### Technical Risks
| Risk | Likelihood | Impact | Mitigation |
|------|-----------|--------|------------|
| [Risk 1] | [H/M/L] | [H/M/L] | [Mitigation plan] |

### Performance Requirements
- [Performance requirement 1]
- [Performance requirement 2]

---

## 6. Design & UX

[Link to designs or describe UX requirements]

### Key UX Principles
- [Principle 1]
- [Principle 2]

### Accessibility Requirements
- [Requirement 1]
- [Requirement 2]

---

## 7. Release Strategy

### Rollout Plan
- **Phase 1:** [Description] โ€” [Timeline]
- **Phase 2:** [Description] โ€” [Timeline]

### Feature Flags
- [Feature flag 1] โ€” [Purpose]

### Rollback Plan
[How to roll back if issues arise]

---

## 8. Open Questions

- [ ] [Question 1] โ€” Owner: [Name]
- [ ] [Question 2] โ€” Owner: [Name]
- [ ] [Question 3] โ€” Owner: [Name]

---

## 9. References

- [Link to related PRDs]
- [Link to designs]
- [Link to research]
- [Link to related issues/tickets]

---

## Changelog

| Version | Date | Author | Changes |
|---------|------|--------|---------|
| 1.0 | [Date] | [Author] | Initial draft |

Phase 4: Review Gate

Present the generated PRD to the user:

PRD draft is ready for review.

Sections generated:
1. Problem Statement
2. Goals & Success Metrics
3. User Stories
4. Proposed Solution
5. Technical Considerations
6. Design & UX
7. Release Strategy
8. Open Questions
9. References

Would you like to:
a) Review the full PRD (I'll display it)
b) Save as-is to the vault
c) Make changes to specific sections
d) Publish to [active wiki platform] (requires your approval)

NEVER auto-publish. Always wait for explicit user approval.

Phase 5: Save to Vault

Save the PRD to: 04-projects/[project]/PRDs/prd-[feature-slug]-YYYY-MM-DD.md

Create the directory structure if it doesn't exist:

mkdir -p "04-projects/[project]/PRDs"

Phase 6: Publish (Optional, requires approval)

Only proceed if the user explicitly approves publishing.

Confluence

Use WebFetch to publish via Confluence REST API:
- POST /wiki/rest/api/content
- Space: [CUSTOMIZE: YOUR-SPACE-KEY]
- Parent page: [CUSTOMIZE: PRDs-parent-page-id]
- Title: "PRD: [Feature Name]"
- Body: [converted to Confluence storage format]

Note: Convert markdown to Confluence XHTML storage format before publishing.

Notion

1. Use ToolSearch to load Notion tools
2. Use mcp__claude_ai_Notion__notion-create-pages to create the PRD page
3. Place under [CUSTOMIZE: PRDs database or parent page]

HackMD

Use WebFetch to publish via HackMD API:
- POST to create a new note
- Set permissions as configured

After publishing, update the vault copy with the published URL:

published_url: [URL]
published_at: [timestamp]

Fallback Behavior

| Scenario | Behavior | |----------|----------| | No wiki platform active | Save to vault only โ€” PRD is still fully useful as a local document | | Publishing API fails | Save to vault, provide the formatted content for manual publishing | | User doesn't specify project | List active projects from MY-PROFILE.md and ask | | Minimal input provided | Generate a skeleton PRD with [TODO] markers for the user to fill in | | Existing PRD found for same feature | Ask if this is an update/revision or a new PRD |

Error Handling

  • Context overflow: If gathering too much context from existing docs, summarize rather than include full text
  • API failures: Always save to vault first, then attempt publishing as a separate step
  • Large PRDs: If the PRD exceeds typical wiki page limits, suggest splitting into sub-pages

Related Skills

View on GitHub
GitHub Stars1.2k
CategoryContent
Updated1mo ago
Forks144

Languages

HTML

Trust signals

100/100

From repository metadata: license, adoption, age and documentation. Not a code audit โ€” see the Safety scan above for what the skill file itself contains.

No cautions
generate-prd โ€” Universal Skill: Install & Safety Check | SkillAgent