CtrlK
BlogDocsLog inGet started
Tessl Logo

replicator-prd

Write or revise hardware product requirements (product/README.md, product/requirements.json, product/contract.json). Use at the start of any hardware product design before parts selection.

73

Quality

92%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Low

Low-risk findings worth noting

SKILL.md
Quality
Evals
Security

Quality

Content

92%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.

An exceptionally tight, actionable workflow body — dense policy rules, exact schemas and enums, and a well-gated completion condition — with one real defect: the only external reference uses a <repo> placeholder path that does not resolve within the skill bundle, making the deferred field-contract details effectively lost.

Suggestions

Replace the <repo>/reference/replicator-original/... placeholder path with a relative path inside the skill bundle (e.g., references/product-files.md) and ship that file alongside SKILL.md so the deferred field-contract details are reachable from the skill alone.

Alternatively, inline the essential allowed values (artifact_level, deliverable_intent, interface sources, CAD delivery targets) into the body and keep only exhaustive enumerations in the reference, so the workflow does not depend on an unresolvable path.

DimensionReasoningScore

Conciseness

The ~40-line body is lean and assumes Claude's competence: terse policy statements ("never rewrite a `user` requirement to make a design pass — ask that single item instead"), no explanations of known concepts, and JSON blocks only where the exact file schema cannot be guessed. Every token earns its place, matching anchor 5 rather than the minor-trimming-needed anchor 4.

5 / 5

Actionability

Fully executable instruction guidance: copy-paste-ready JSON templates for requirements.json and contract.json, the exact source enum ("user / default / research"), a named tool (AskQuestion) with concrete batching rules ("one batch, specific items only, each with 2-4 concrete options"), and an explicit write-back rule. Per the code-vs-instruction note, absence of code is not penalized since the guidance is this concrete.

5 / 5

Workflow Clarity

Six numbered steps in clear sequence with an explicit validation gate ("PRD is ready when `open_questions` is empty"), a feedback loop (open items → AskQuestion → write back with source "user" → empty the list), and an explicit stop-and-handoff rule. This is a drafting workflow, not a destructive or batch operation, so the validation cap does not apply, and it matches the anchor-5 pattern of explicit checkpoints with error-recovery guidance (the never-rewrite-user-requirements guard).

5 / 5

Progressive Disclosure

The pointer to the field contracts is clearly signaled and one level deep, but it targets "<repo>/reference/replicator-original/product/requirements-contract/references/product-files.md" — a placeholder path outside the skill bundle, and no references/ directory exists in the bundle, so the deferred content is unreachable from SKILL.md alone. Since the skill genuinely needs this reference, the under-50-lines exception does not apply, and broken reachability is more than the minor organization gap of anchor 4.

3 / 5

Total

18

/

20

Passed

Description

87%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.

A strong description: it states both what it produces (three named requirement files) and exactly when to use it (start of hardware product design, before parts selection), in a distinct niche. The only gaps are missing common synonyms like "PRD" or "product spec" and no indication of which requirement domains are covered.

DimensionReasoningScore

Specificity

"Write or revise hardware product requirements (product/README.md, product/requirements.json, product/contract.json)" names the domain, two concrete actions, and three specific output files, matching the several-specific-actions-with-minor-gaps anchor. It falls short of anchor 5 because it never indicates what requirement domains are covered (e.g., battery life, connectivity, enclosure), so coverage is not comprehensive.

4 / 5

Completeness

The what is explicit ("Write or revise hardware product requirements (product/README.md, product/requirements.json, product/contract.json)") and the when is an equally explicit trigger clause ("Use at the start of any hardware product design before parts selection"), matching the anchor-5 example structure of both answers with concrete trigger phrases.

5 / 5

Trigger Term Quality

Natural phrases like "hardware product requirements", "hardware product design", and "parts selection" give good keyword coverage, matching anchor 4. It misses common synonyms a user would say — "PRD", "product spec", "specification" — so it does not reach anchor 5's comprehensive synonym coverage.

4 / 5

Distinctiveness Conflict Risk

The "hardware" qualifier plus the pipeline position "before parts selection" carve out a clear niche with distinct triggers, minimal conflict risk against software-PRD, general-writing, or parts-selection skills. Matches the clear-niche anchor rather than the minor-overlap anchor 4.

5 / 5

Total

18

/

20

Passed

Validation

100%

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

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository
JimmyPang02/open-replicator
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.