CtrlK
BlogDocsLog inGet started
Tessl Logo

tdg-personal/product-capability

Translate PRD intent, roadmap asks, or product discussions into an implementation-ready capability plan that exposes constraints, invariants, interfaces, and unresolved decisions before multi-service work starts. Use when the user needs an ECC-native PRD-to-SRS lane instead of vague planning prose.

74

Quality

74%

Does it follow best practices?

Impact

Pending

No eval scenarios have been run

SecuritybySnyk

Passed

No known issues

Overview
Quality
Evals
Security
Files

Quality

Discovery

75%

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 establishes a clear niche and includes both 'what' and 'when' clauses, which is strong. However, it relies on domain-specific jargon (ECC-native, PRD-to-SRS lane) that may not match natural user language, and the specific actions could be more granularly enumerated. The trigger terms could be broadened to include more common synonyms users might actually use.

Suggestions

Replace jargon like 'ECC-native PRD-to-SRS lane' with more natural language users would say, such as 'converting product requirements into technical specifications' or 'turning a PRD into a detailed spec'.

Add common trigger term variations such as 'product requirements', 'spec', 'technical specification', 'system design', 'requirements document', 'feature spec' to improve matching.

DimensionReasoningScore

Specificity

The description names the domain (PRD-to-SRS translation) and mentions some outputs (constraints, invariants, interfaces, unresolved decisions), but the actions are described at a high level ('translate...into an implementation-ready capability plan') rather than listing multiple concrete discrete actions like 'extract requirements, define interfaces, identify constraints, document open questions.'

2 / 3

Completeness

The description clearly answers both 'what' (translate PRD intent into implementation-ready capability plans exposing constraints, invariants, interfaces, and unresolved decisions) and 'when' (explicit 'Use when' clause specifying the trigger scenario of needing a PRD-to-SRS lane).

3 / 3

Trigger Term Quality

Includes some relevant terms like 'PRD', 'roadmap', 'product discussions', 'SRS', and 'implementation-ready', but uses jargon like 'ECC-native PRD-to-SRS lane' that users are unlikely to naturally say. Missing common variations like 'product requirements', 'spec', 'specification', 'technical design', 'system requirements'.

2 / 3

Distinctiveness Conflict Risk

The skill occupies a clear niche — translating product requirements documents into system requirements specifications with specific outputs (constraints, invariants, interfaces). This is distinct enough from general planning, coding, or documentation skills to avoid conflicts.

3 / 3

Total

10

/

12

Passed

Implementation

62%

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

This is a well-structured process skill with a clear workflow and good handoff logic, but it lacks concrete examples that would make it truly actionable. The content is moderately concise but includes some sections that explain things Claude already understands (like motivational 'Good Outcomes'). The biggest gap is the absence of a worked example showing a real PRD input transformed into the output format.

Suggestions

Add a concrete worked example showing a brief PRD input and the corresponding completed output in the CAPABILITY/CONSTRAINTS/IMPLEMENTATION CONTRACT format—this would significantly boost actionability.

Remove or compress the 'Good Outcomes' section, as it describes benefits to the user rather than instructing Claude on what to do.

Move the output format template to the referenced `docs/examples/product-capability-template.md` file and keep only a brief summary inline, improving progressive disclosure.

DimensionReasoningScore

Conciseness

The skill is reasonably efficient but includes some unnecessary sections like 'Good Outcomes' (Claude doesn't need motivation) and 'When to Use' is somewhat verbose with overlapping bullet points. The 'Inputs' section explains obvious things like 'read only what is needed.' However, it's not egregiously padded.

2 / 3

Actionability

The workflow steps are clear conceptually but remain at the level of abstract guidance rather than concrete, executable instructions. There are no real examples of a completed capability plan, no sample input/output pair, and the output format template is a skeleton rather than a filled-in example. The skill describes what to produce but doesn't demonstrate it concretely.

2 / 3

Workflow Clarity

The four-step workflow is clearly sequenced (restate → resolve constraints → define contract → translate to execution), with an explicit decision checkpoint at step 4 (ready / needs review / needs clarification). The handoff step acts as a validation gate, and the output format provides a clear checklist structure including open questions as a blocking mechanism.

3 / 3

Progressive Disclosure

The skill references external files like `docs/examples/product-capability-template.md` and other ECC lanes, which is good progressive disclosure. However, the main content itself is somewhat monolithic—the 'When to Use' section, 'Non-Negotiable Rules', 'Inputs', and 'Core Workflow' could benefit from tighter organization. The inline output format template could potentially be a separate reference file given its length.

2 / 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

Reviewed

Table of Contents