ship-decisions

Guides "ship or iterate?" decisions using Shreyas Doshi's frameworks, Marty Cagan's shipping philosophy, and Tobi Lutke's reversible decision-making. Use when deciding if feature is ready, preventing perfectionism paralysis, applying one-way vs two-way door thinking, or balancing technical debt vs shipping speed.

Quality

88%

Does it follow best practices?

Impact

—

No eval scenarios have been run

Securityby

Passed

No known issues

Quality

Content

77%

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

This skill provides excellent actionable frameworks with clear decision trees and practical templates for shipping decisions. However, it's overly verbose for a skill file, explaining concepts Claude already knows and including extensive examples that could be referenced externally. The workflow clarity is strong with explicit checkpoints and scoring systems.

Suggestions

Move the three action templates to a separate templates/ directory and reference them from the main skill file

Condense the real-world examples section to 2-3 sentences each or move to a references/examples.md file

Remove explanatory text like 'Don't Ship to Everyone at Once' headers and basic feature flag code examples that Claude already understands

Consolidate the 'Common Pitfalls' and 'Key Quotes' sections into the main frameworks or move to reference files

Dimension	Reasoning	Score
Conciseness	The skill contains valuable frameworks but is verbose with repetitive explanations. The extensive examples, multiple templates, and real-world case studies add bulk that could be condensed. Claude doesn't need explanations of what feature flags are or basic rollout concepts.	2 / 3
Actionability	Provides highly actionable content with concrete decision trees, specific checklists, scoring systems (5/5 checks), and copy-paste ready templates. The decision framework with clear thresholds (5/5 → Ship, 4/5 → Internal, etc.) gives explicit guidance.	3 / 3
Workflow Clarity	Excellent workflow clarity with explicit decision trees, numbered steps, validation checkpoints (the 5-check system), and clear rollout stages. The 'Ship or Wait?' decision tree provides unambiguous sequencing with feedback loops for each decision point.	3 / 3
Progressive Disclosure	References external files (references/reversible-decisions.md, etc.) appropriately, but the main skill file is monolithic with ~400 lines of content. The templates, examples, and frameworks could be split into separate reference files with the SKILL.md serving as a leaner overview.	2 / 3
	Total	10 / 12 Passed

Description

100%

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 an excellent skill description that hits all the key criteria. It clearly articulates what the skill does (guides shipping decisions using named frameworks), provides explicit trigger conditions via a 'Use when...' clause, and uses natural language that product managers and developers would actually use. The specificity of the frameworks and decision-making concepts creates a distinct niche.

Dimension	Reasoning	Score
Specificity	Lists multiple specific concrete actions: 'ship or iterate decisions', 'preventing perfectionism paralysis', 'one-way vs two-way door thinking', 'balancing technical debt vs shipping speed'. Names specific frameworks and thought leaders (Shreyas Doshi, Marty Cagan, Tobi Lutke).	3 / 3
Completeness	Clearly answers both what (guides ship/iterate decisions using specific frameworks) AND when (explicit 'Use when...' clause with four distinct trigger scenarios: deciding if feature is ready, preventing perfectionism paralysis, applying decision-making frameworks, balancing debt vs speed).	3 / 3
Trigger Term Quality	Includes natural keywords users would say: 'ship or iterate', 'feature is ready', 'perfectionism', 'one-way vs two-way door', 'technical debt', 'shipping speed'. These are terms developers and product managers naturally use when facing these decisions.	3 / 3
Distinctiveness Conflict Risk	Clear niche focused on product shipping decisions with distinct triggers. The combination of named frameworks (Shreyas Doshi, Marty Cagan, Tobi Lutke) and specific concepts (reversible decisions, perfectionism paralysis) makes it unlikely to conflict with general product management or coding skills.	3 / 3
	Total	12 / 12 Passed

Validation

100%

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 — 11 / 11 Passed

Validation for skill structure

No warnings or errors.

Repository: menkesu/awesome-pm-skills
Commit: 53530ef

Reviewed: 4 months 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.