CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

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.

Quality

76%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./skills/product-capability/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

75%Weight 40%Scale 1-5

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

The body is a well-structured, efficient instruction-only skill with a clear four-step workflow, concrete output contract, and explicit decision-gated handoff. Its residual gaps are the absence of a worked example and of validate/retry feedback loops, plus a couple of trimmable editorial lines.

DimensionReasoningScore

Conciseness

The body is lean and list-driven with no explanation of concepts Claude already knows, but a few editorial flourishes could be trimmed: "These are the things that often live only in senior-engineer memory", "If this statement is weak, the implementation will drift", "The goal is not to create another planning stack." Matches anchor 4 (efficient, minor over-explanation trimmable); not anchor 5 because those motivational lines don't earn their tokens, not anchor 3 because nothing rises to unnecessary explanation.

4 / 5

Actionability

Concrete, executable instruction-level guidance throughout: a four-step workflow with named sub-deliverables, an exact output-format skeleton (CAPABILITY / CONSTRAINTS / IMPLEMENTATION CONTRACT / NON-GOALS / OPEN QUESTIONS / HANDOFF), a template path, and named follow-on lanes. Not anchor 5 because there is no worked example of a completed capability statement or filled output; not anchor 3 because the guidance is specific enough to execute directly without guessing.

4 / 5

Workflow Clarity

A clear four-step sequence (Restate → Resolve constraints → Define contract → Translate into execution) ends in an explicit decision gate: "ready for direct implementation / needs architecture review first / needs product clarification first", reinforced by non-negotiable rules. Not anchor 5 because there are no validate-and-retry feedback loops (e.g., revisiting the restatement if weak is advised but not structured as a loop); not anchor 3 because the handoff classification is an explicit checkpoint and no destructive/batch cap applies to a planning skill.

4 / 5

Progressive Disclosure

Well-organized single-file structure (~135 lines) with clear section headers and no nested references; the one referenced path, "docs/examples/product-capability-template.md", is clearly signaled. Matches anchor 4 (good structure, minor organization gaps); not anchor 5 because the under-50-line simple-skill exception does not apply and the template reference cannot be verified against a bundle; not anchor 3 because nothing is buried and structure is clean.

4 / 5

Total

16

/

20

Passed

Description

67%Weight 40%Scale 1-5

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 clearly communicates a distinctive capability with an explicit 'Use when' clause and strong third-person specificity. Its main weaknesses are jargon-heavy triggers ('ECC-native PRD-to-SRS lane') and missing natural synonyms that real users would say, which caps trigger-term quality and keeps completeness one notch below excellent.

Suggestions

Replace or gloss the jargon in the trigger clause with user-natural phrases, e.g. 'Use when turning a PRD, roadmap item, or product discussion into a requirements/spec document or implementation plan.'

Add common synonyms users would actually say (spec, SRS, requirements, implementation plan, feature spec) to broaden natural keyword coverage.

Enumerate 1-2 more discrete concrete actions (e.g. 'restates the capability, extracts invariants and trust boundaries, and produces a handoff-ready contract') to push specificity toward anchor 5.

DimensionReasoningScore

Specificity

"Translate PRD intent, roadmap asks, or product discussions into an implementation-ready capability plan" and "exposes constraints, invariants, interfaces, and unresolved decisions" name several specific actions and outputs. It falls short of anchor 5 because the actions remain abstract ('translate', 'expose') rather than enumerating multiple discrete concrete operations, but sits above anchor 3 since it covers the domain plus multiple named artifacts.

4 / 5

Completeness

Both parts are present: a clear what ("Translate PRD intent... into an implementation-ready capability plan that exposes constraints, invariants, interfaces, and unresolved decisions") and an explicit trigger ("Use when the user needs an ECC-native PRD-to-SRS lane instead of vague planning prose"). Not anchor 5 because the 'when' relies on internal jargon rather than concrete user-sayable phrases; not anchor 3 because the 'when' is explicitly stated, not merely implied.

4 / 5

Trigger Term Quality

Natural terms like "PRD intent", "roadmap asks", and "product discussions" are present, but the description leans on jargon users would not naturally say ("ECC-native PRD-to-SRS lane") and misses common synonyms such as 'spec', 'requirements doc', or 'implementation plan'. Matches anchor 3 (some relevant keywords, missing variations) rather than anchor 4's 'good coverage with a few missing'.

3 / 5

Distinctiveness Conflict Risk

It carves a clear niche (PRD-to-capability-plan translation before multi-service work) with distinct triggers, at most overlapping with closely related planning/spec-writing skills. Matches anchor 4; not anchor 5 because "product discussions" is broad enough to brush against general planning skills.

4 / 5

Total

15

/

20

Passed

Validation

93%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

metadata_version

'metadata.version' is missing

Warning

Total

15

/

16

Passed

Repository

affaan-m/ECC

Path

skills/product-capability/SKILL.md

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.