product-manager-toolkit

Essential tools and frameworks for modern product management, from discovery to delivery.

Quality

26%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

Securityby

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./skills/product-manager-toolkit/SKILL.md

Quality

Content

42%Scale 1-5

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

This skill is overly broad, attempting to cover the entire product management discipline rather than focusing on the specific tools it provides. The script-related content is reasonably actionable, but it's buried in extensive general PM knowledge (frameworks, best practices, pitfalls) that Claude already knows. The content would benefit significantly from trimming to focus on the unique value: the two scripts and the PRD templates, with validation steps added to the workflows.

Suggestions

Remove or drastically reduce sections that teach general PM concepts Claude already knows: MoSCoW, opportunity solution trees, stakeholder management, discovery tips, funnel analysis, metrics frameworks, common pitfalls, and integration points.

Add explicit validation/verification steps to workflows, e.g., 'Review the RICE output for scoring anomalies before proceeding to roadmap generation' or 'Verify extracted pain points against transcript before synthesizing.'

Move the Prioritization Frameworks, Discovery Frameworks, and Metrics sections into separate reference files and link to them from the SKILL.md overview to improve progressive disclosure.

Provide example input/output for the scripts (e.g., sample CSV format, sample analyzer output) so Claude knows exactly what to expect and can verify correctness.

Dimension	Reasoning	Score
Conciseness	Extensively verbose with many sections that explain concepts Claude already knows well (MoSCoW method, opportunity solution trees, stakeholder management tips, customer discovery tips, funnel analysis). The 'Common Pitfalls', 'Best Practices', 'Integration Points', and 'Metrics & Analytics' sections are largely general PM knowledge that doesn't add actionable value specific to this toolkit.	2 / 5
Actionability	The script usage examples are concrete and executable (rice_prioritizer.py, customer_interview_analyzer.py), but the majority of the content is frameworks, templates, and best practices described in abstract terms rather than executable guidance. The PRD workflow is entirely procedural advice with no concrete tooling. No bundle files are provided, so the referenced scripts and templates cannot be verified.	3 / 5
Workflow Clarity	The three core workflows (Feature Prioritization, Customer Discovery, PRD Development) have clear sequential steps, but lack explicit validation checkpoints or feedback loops. There's no verification step after running the scripts (e.g., checking output validity, reviewing results before proceeding). The workflows describe what to do but not how to verify success at each stage.	3 / 5
Progressive Disclosure	References to external files like 'references/prd_templates.md' and scripts exist, but no bundle files are provided to verify them. The SKILL.md itself is monolithic (~300 lines) with substantial content that should be in separate reference files (frameworks, best practices, metrics templates). The Reference Documents section describes prd_templates.md contents inline rather than deferring to it.	3 / 5
	Total	11 / 20 Passed

Description

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

This description is essentially a tagline rather than a functional skill description. It lacks any concrete actions, specific trigger terms, or 'when to use' guidance, making it nearly impossible for Claude to reliably select this skill from a pool of alternatives. The phrase 'from discovery to delivery' is marketing fluff that adds no discriminative value.

Suggestions

List specific concrete actions the skill performs, e.g., 'Creates PRDs, builds product roadmaps, writes user stories, defines acceptance criteria, prioritizes features using frameworks like RICE or MoSCoW.'

Add an explicit 'Use when...' clause with natural trigger terms, e.g., 'Use when the user asks about product requirements, roadmaps, user stories, feature prioritization, sprint planning, or product strategy.'

Include domain-specific keywords and synonyms users would naturally say, such as 'PRD,' 'product spec,' 'backlog grooming,' 'OKRs,' 'stakeholder alignment,' 'MVP,' etc.

Dimension	Reasoning	Score
Specificity	The description uses entirely vague language like 'tools and frameworks' and 'discovery to delivery' without naming any concrete actions. No specific capabilities are listed.	1 / 5
Completeness	The 'what' is extremely vague ('tools and frameworks') with no concrete actions described, and there is no 'when' clause or trigger guidance whatsoever.	1 / 5
Trigger Term Quality	'Product management' is a relevant keyword, but 'discovery to delivery,' 'tools,' and 'frameworks' are generic buzzwords. Missing natural user phrases like 'PRD,' 'roadmap,' 'user stories,' 'prioritization,' 'backlog,' etc.	2 / 5
Distinctiveness Conflict Risk	'Product management' provides some domain specificity, but 'tools and frameworks' and 'discovery to delivery' are so broad that this could overlap with project management, agile coaching, business analysis, or many other skills.	2 / 5
	Total	6 / 20 Passed

Validation

90%

Warnings & errors only

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

Repository: administrakt0r/AI-Agents-Safe-Coding-Skills
Path: skills/product-manager-toolkit/SKILL.md
Commit: 57c135b

Reviewed: 3 days ago

Table of Contents

Discovery Implementation Validation

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.