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.
90
88%
Does it follow best practices?
Impact
Pending
No eval scenarios have been run
Passed
No known issues
Quality
Discovery
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 |
Implementation
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 |
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 — 11 / 11 Passed
Validation for skill structure
No warnings or errors.
- Repository
- menkesu/awesome-pm-skills
- Commit
53530ef
- 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.