Generate a personalized Second Brain PRD from a completed requirements template. Use when the user has filled out my-second-brain-requirements.md and wants to generate their build plan. Triggers on "create my second brain PRD", "generate my PRD", "build my second brain plan", "/create-second-brain-prd", or after completing the requirements template.
55
62%
Does it follow best practices?
Impact
—
No eval scenarios have been run
Advisory
Suggest reviewing before use
Optimize this skill with Tessl
npx tessl skill review --optimize ./.claude/skills/create-second-brain-prd/SKILL.mdQuality
Discovery
89%Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.
This is a solid skill description with excellent trigger coverage and completeness. It clearly defines when to use the skill with multiple explicit triggers and references a specific input file. The main weakness is that the 'what' could be more specific about what the generated PRD contains or what concrete steps are performed beyond 'generate a personalized PRD'.
Suggestions
Add more specific actions describing what the PRD generation entails (e.g., 'Generates architecture recommendations, feature priorities, and implementation roadmap based on user requirements').
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | It names the domain ('Second Brain PRD') and the core action ('Generate a personalized PRD from a completed requirements template'), but doesn't list multiple concrete sub-actions like what the PRD contains or what processing steps are involved. | 2 / 3 |
Completeness | Clearly answers both 'what' (generate a personalized Second Brain PRD from a completed requirements template) and 'when' (explicit triggers listed, plus the condition of having filled out the requirements template). Has an explicit 'Use when' clause with multiple trigger scenarios. | 3 / 3 |
Trigger Term Quality | Includes multiple natural trigger phrases users would say: 'create my second brain PRD', 'generate my PRD', 'build my second brain plan', '/create-second-brain-prd', and references the specific template file name. Good coverage of variations. | 3 / 3 |
Distinctiveness Conflict Risk | Very specific niche: generating a 'Second Brain PRD' from a particular template file (my-second-brain-requirements.md). The domain-specific terminology and file reference make it highly unlikely to conflict with other skills. | 3 / 3 |
Total | 11 / 12 Passed |
Implementation
35%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 comprehensive but overly verbose specification for generating a Second Brain PRD. Its main weakness is extreme length — the detailed phase-by-phase PRD structure could be extracted into a reference template, dramatically reducing the SKILL.md size. The workflow is reasonably clear but lacks validation steps, and the guidance is descriptive rather than providing concrete output examples or executable snippets.
Suggestions
Extract the detailed Phase 1-9 PRD structure into a separate reference file (e.g., `references/prd-template.md`) and reference it from SKILL.md, reducing the body by ~60%.
Add a validation step after reading the requirements file to check that required sections are filled out before proceeding with generation.
Include a concrete example snippet showing what a generated phase entry should look like (e.g., a sample Phase 1 output) so the format is unambiguous.
Trim the 'Research ALL tools and APIs' section to a concise checklist — Claude doesn't need to be told why APIs have nuances or what 'research' means.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The skill is extremely verbose, spending hundreds of tokens describing every phase of the PRD in exhaustive detail. Much of this is prescriptive content that Claude could generate from a much shorter specification. The detailed phase descriptions (Phase 1-9) essentially duplicate what the output should look like rather than providing concise instructions for generating it. The 'Research ALL tools and APIs' section over-explains what research means. | 1 / 3 |
Actionability | The skill provides a clear workflow structure and specific file paths, but contains no executable code, no concrete command examples, and no template snippets showing what the output PRD should actually look like. The guidance is detailed but descriptive rather than executable — it tells Claude what to include but doesn't show concrete examples of the output format. | 2 / 3 |
Workflow Clarity | The 5-step workflow is clearly sequenced (read requirements → load reference → research → generate → confirm), but there are no validation checkpoints. There's no step to verify the requirements file is properly filled out, no validation that the research step produced useful results, and no check that the generated PRD is complete before confirming to the user. For a document generation task this matters less than for destructive operations, but some validation would improve reliability. | 2 / 3 |
Progressive Disclosure | The skill references an architecture reference file at `${CLAUDE_SKILL_DIR}/references/architecture-reference.md` and a requirements template, which is good progressive disclosure. However, the massive inline PRD structure description (Phases 1-9) should arguably be in a separate reference file rather than inline in the SKILL.md. No bundle files were provided to verify the referenced paths exist. | 2 / 3 |
Total | 7 / 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.
Validation — 10 / 11 Passed
Validation for skill structure
| Criteria | Description | Result |
|---|---|---|
frontmatter_unknown_keys | Unknown frontmatter key(s) found; consider removing or moving to metadata | Warning |
Total | 10 / 11 Passed | |
4cf6d48
Table of Contents
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.