List all PRDs with status, progress, and metadata
56
45%
Does it follow best practices?
Impact
Pending
No eval scenarios have been run
Passed
No known issues
Optimize this skill with Tessl
npx tessl skill review --optimize ./plugins/product-design/skills/list-prds/SKILL.mdQuality
Discovery
32%Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.
The description identifies a specific domain (PRDs) and action (listing with metadata) but is incomplete due to missing trigger guidance. It lacks the 'Use when...' clause that would help Claude know when to select this skill, and could benefit from more natural keyword variations that users might actually say.
Suggestions
Add a 'Use when...' clause with trigger terms like 'list PRDs', 'show requirements', 'PRD status', 'product requirements documents'
Include natural keyword variations such as 'product requirements', 'requirements documents', 'PRD overview', 'project requirements'
Expand the capability description to include related actions if applicable, such as filtering, searching, or summarizing PRDs
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | Names the domain (PRDs) and a specific action (list with status, progress, metadata), but only describes one action rather than multiple concrete capabilities. | 2 / 3 |
Completeness | Describes what the skill does but completely lacks any 'Use when...' clause or explicit trigger guidance for when Claude should select this skill. | 1 / 3 |
Trigger Term Quality | Includes 'PRDs' which is a relevant keyword, but misses natural variations users might say like 'product requirements', 'requirements documents', 'show PRDs', or 'PRD list'. | 2 / 3 |
Distinctiveness Conflict Risk | PRDs are a specific document type which provides some distinctiveness, but could overlap with general document listing or project management skills without clearer triggers. | 2 / 3 |
Total | 7 / 12 Passed |
Implementation
57%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This skill provides a clear specification for a PRD listing command with good output format examples and reasonable organization. However, it lacks executable code implementations, relying instead on abstract descriptions of what Claude should do. The 'Implementation Tips' section is somewhat redundant given Claude's existing capabilities.
Suggestions
Replace 'Execution Instructions for Claude Code' with actual executable Python code that parses YAML headers and traverses the directory structure
Remove or significantly condense the 'Implementation Tips' section - Claude already knows how to parse YAML and traverse directories
Add a validation step to verify PRD files are well-formed before processing the entire batch
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The content is reasonably efficient but includes some unnecessary sections like 'Implementation Tips for Claude Code' that explain things Claude already knows (YAML parsing, directory traversal). The output format examples are helpful but could be more compact. | 2 / 3 |
Actionability | Provides clear structure and output examples, but lacks executable code. The 'Execution Instructions' describe what to do abstractly rather than providing concrete implementation. No actual Python/bash code for parsing YAML or traversing directories. | 2 / 3 |
Workflow Clarity | Steps are listed in the execution instructions but lack validation checkpoints. Error handling section exists but doesn't specify how to verify successful completion or handle partial failures during batch file processing. | 2 / 3 |
Progressive Disclosure | For a skill of this size and scope, the organization is appropriate. Clear sections for usage, arguments, output formats, error handling, and examples. No unnecessary external references or deeply nested content. | 3 / 3 |
Total | 9 / 12 Passed |
Validation
90%Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.
Validation — 10 / 11 Passed
Validation for skill structure
| Criteria | Description | Result |
|---|---|---|
frontmatter_unknown_keys | Unknown frontmatter key(s) found; consider removing or moving to metadata | Warning |
Total | 10 / 11 Passed | |
0ebe7ae
Table of Contents
If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.