OpenParable
Skip to content
← Back to skills

List Prds

Productivity
list-prds

List Prds is an Agent Skill for productivity published in the majiayu000/claude-skill-registry repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.

List all PRDs with status, progress, and metadata

View on GitHub ↗
QUICK START

How to use this skill

Bring this guide into your coding agent with a prompt tailored to the tool you use.

  1. Open your project in Codex.
  2. Copy and paste the prompt below.
  3. Review files and risks before approving any action.
Prompt to paste
Inspect the Agent Skill at https://github.com/majiayu000/claude-skill-registry/blob/HEAD/skills/product/list-prds/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/list-prds, but wait for my approval before writing files or running scripts.

Copying this prompt does not install or run the skill. Review third-party files before use.

list-prds

Category: Product & Strategy

Usage

list-prds [--status <status>] [--type <type>] [--format <format>]

Arguments

  • --status: Optional - Filter by status (draft, review, approved, active, complete, archived)
  • --type: Optional - Filter by type (product, feature, simple)
  • --format: Optional - Output format (table, list, json). Default: table

Execution Instructions for Claude Code

When this command is run, Claude Code should:

  1. Search for all PRD files in the product-docs/ directory structure
  2. Read the YAML metadata header from each PRD file
  3. Extract key information: title, status, version, dates, linked task file
  4. If a task file is linked, calculate implementation progress
  5. Apply any filters specified in the arguments
  6. Format and display the results according to the specified format

Output Format

Table Format (default)

PRD List - Found 12 PRDs

Status    | Type    | Name                      | Version | Progress | Updated
----------|---------|---------------------------|---------|----------|------------
ACTIVE    | Feature | user-authentication-frd   | 1.2     | 67%      | 2025-01-06
ACTIVE    | Product | inventory-system-prd      | 2.0     | 45%      | 2025-01-05
REVIEW    | Feature | quick-search-simple-frd   | 1.0     | N/A      | 2025-01-04
APPROVED  | Feature | data-export-frd          | 1.1     | 0%       | 2025-01-03

List Format

šŸ“„ user-authentication-frd.md
   Status: ACTIVE | Version: 1.2 | Progress: 67%
   Location: product-docs/prds/active/feature-prds/
   Tasks: ./tasks/user-authentication-frd-tasks.md

šŸ“„ inventory-system-prd.md
   Status: ACTIVE | Version: 2.0 | Progress: 45%
   Location: product-docs/prds/active/product-prds/
   Tasks: ./tasks/inventory-system-prd-tasks.md

Error Handling

  • If no product-docs/ directory exists: Create it with proper structure
  • If PRD has no metadata: Show with status "UNKNOWN"
  • If linked task file not found: Show progress as "N/A"

Example

# List all PRDs
list-prds

# List only active PRDs
list-prds --status active

# List only feature PRDs in list format
list-prds --type feature --format list

# List all PRDs in review status
list-prds --status review

Implementation Tips for Claude Code

  1. Directory Traversal: Use recursive search through all PRD directories
  2. Metadata Parsing: Use YAML parsing for the header between --- markers
  3. Progress Calculation: Count [x] vs [ ] in linked task files
  4. Sorting: Default sort by status (active first) then by last updated date
  5. Type Detection: Infer from filename suffix (-prd, -frd, -simple-frd)