CtrlK
BlogDocsLog inGet started
Tessl Logo

list-prds

List all PRDs with status, progress, and metadata

56

Quality

45%

Does it follow best practices?

Impact

Pending

No eval scenarios have been run

SecuritybySnyk

Passed

No known issues

Optimize this skill with Tessl

npx tessl skill review --optimize ./plugins/product-design/skills/list-prds/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

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

DimensionReasoningScore

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

DimensionReasoningScore

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.

Validation10 / 11 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

10

/

11

Passed

Repository
jpoutrin/product-forge
Reviewed

Table of Contents

Is this your skill?

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.