CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

code-to-prd

Reverse-engineer any codebase into a complete Product Requirements Document (PRD). Analyzes routes, components, state management, API integrations, and user interactions to produce business-readable documentation detailed enough for engineers or AI agents to fully reconstruct every page and endpoint. Works with frontend frameworks (React, Vue, Angular, Svelte, Next.js, Nuxt), backend frameworks (NestJS, Django, Express, FastAPI), and fullstack applications. Use when users mention: generate PRD, reverse-engineer requirements, code to documentation, extract product specs from code, document page logic, analyze page fields and interactions, create a functional inventory, write requirements from an existing codebase, document API endpoints, or analyze backend routes.

65

Quality

82%

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

The canonical home for this skill is code-to-prd in alirezarezvani/claude-skills

SKILL.md
Quality
Evals
Security

Quality

Content

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

A thorough, well-structured instruction skill with concrete templates, clear per-page analysis dimensions, and sensible pacing for large projects. Its main flaws are redundant header sections that duplicate the frontmatter, validation that stays implicit rather than being an explicit workflow step, and a Tooling section pointing to scripts and reference files that are absent from the bundle.

Suggestions

Remove the duplicated '## Name', '## Description', and '## Features' opening sections — they restate the frontmatter description and duplicate the 'Supported Stacks' table, saving ~30 lines of token overhead.

Ship the referenced bundle files (scripts/codebase_analyzer.py, scripts/prd_scaffolder.py, references/prd-quality-checklist.md, references/framework-patterns.md) or delete the Tooling/References sections — as delivered, every command and reference link in the body is broken.

Make validation an explicit workflow step: add a Phase 4 (or end of Phase 3) that runs the quality checklist against each generated page file before output, converting the implicit 'Quality checklist' feature into a concrete feedback loop.

DimensionReasoningScore

Conciseness

The body is mostly operational with no basic-concept padding, but the opening "## Name", "## Description", and "## Features" sections (~30 lines) restate the frontmatter description verbatim and duplicate the later "Supported Stacks" table. This matches the 3 anchor ("mostly efficient but includes some unnecessary explanation or could be tightened") — not 4, since the duplication is a noticeable, easily-removed block rather than a minor trim.

3 / 5

Actionability

Highly concrete: copy-paste commands ("python3 scripts/codebase_analyzer.py /path/to/project -o analysis.json"), full README and per-page Markdown templates, exact table schemas, and specific mock-detection signals. However, the two script commands reference files that do not exist in the bundle, so they cannot actually run — matching the 4 anchor ("concrete code or commands with minor gaps") rather than the fully-executable 5 anchor.

4 / 5

Workflow Clarity

The 3-phase workflow (global scan → page-by-page analysis → document generation) is clearly sequenced with per-phase steps, analysis dimensions, and a batching checkpoint ("Output each batch for user review before proceeding"). It falls short of 5 because validation is only implicit — the quality checklist is mentioned as a reference file but never wired in as an explicit post-generation validation step, a "most checkpoints present; minor validation gaps" match.

4 / 5

Progressive Disclosure

References are clearly signaled one level deep via the Tooling tables (scripts plus references/prd-quality-checklist.md and references/framework-patterns.md), but none of these files — nor the scripts directory — exist in the bundle, so the pointers dangle and the disclosed structure is broken. This matches the 3 anchor ("some structure but could be better organized") rather than 4, since structure that depends on missing files cannot be considered well-placed.

3 / 5

Total

14

/

20

Passed

Description

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

An excellent description: it states concrete capabilities comprehensively, names supported frameworks explicitly, and provides an unusually thorough list of natural user trigger phrases. The only weakness is slight overlap risk between a few trigger terms and generic code-documentation skills.

DimensionReasoningScore

Specificity

The description lists multiple specific concrete actions — "Analyzes routes, components, state management, API integrations, and user interactions" — and precisely scopes the output ("business-readable documentation detailed enough for engineers or AI agents to fully reconstruct every page and endpoint"), with an explicit framework list. This matches the score-5 anchor (comprehensive concrete actions) rather than 4, since there are no meaningful coverage gaps.

5 / 5

Completeness

Both parts are explicit: a clear "what" ("Reverse-engineer any codebase into a complete Product Requirements Document" with the concrete analysis dimensions) and an explicit "when" ("Use when users mention: ..." with concrete trigger phrases). This is a direct match to the score-5 anchor; 4 would apply only if the "when" were less explicit, which it is not.

5 / 5

Trigger Term Quality

"Use when users mention: generate PRD, reverse-engineer requirements, code to documentation, extract product specs from code, document page logic, analyze page fields and interactions, create a functional inventory, write requirements from an existing codebase, document API endpoints, or analyze backend routes" provides ~10 natural phrases including multiple synonyms users would actually say. This matches the 5 anchor's synonym coverage; few if any natural variants are missing, so 4 would underrate it.

5 / 5

Distinctiveness Conflict Risk

The PRD/reverse-engineering niche is clear and most triggers are distinctive, but "code to documentation", "write requirements from an existing codebase", and "document API endpoints" have minor overlap risk with general code-documentation or README/init skills. This matches the 4 anchor ("mostly distinct; minor overlap risk with closely related skills") rather than 5.

4 / 5

Total

19

/

20

Passed

Validation

87%

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

Validation — 14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

relative_links

Relative link issues: 1 missing

Warning

referenced_paths_exist

Referenced path issues: 9 missing

Warning

Total

14

/

16

Passed

Repository

alirezarezvani/claude-skills

Path

.gemini/skills/code-to-prd/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.