shipkit-product-definition

shipkit-product-definition is a skill for Claude Code, Codex from stefan-stepzero/shipkit. It costs 43 tokens per session (4,367 once invoked), scanned A, original, MIT.

A product-planning guide that turns discovered user needs into a blueprint for what an app should contain, including features, user-interface patterns, and key differences from alternatives.

In plain words
What is it for?
Use it after user research to define features, UX patterns, differentiators, and the product’s core quality bar before technical planning.
Why use it?
It prevents teams from jumping straight into technical decisions before agreeing on the user-facing solution. It also records the product’s essential qualities as checks that can be evaluated later.

Skill for Claude CodeCodex

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add skills/stefan-stepzero/shipkit/shipkit-product-definition
Any agent
npx skills add stefan-stepzero/shipkit --skill shipkit-product-definition
Clone the repo
git clone --depth 1 https://github.com/stefan-stepzero/shipkit

Made for: Claude Code, Codex.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for shipkit-product-definition

README.md
[![agentmods](https://agentmods.dev/badge/skills/stefan-stepzero/shipkit/shipkit-product-definition.svg)](https://agentmods.dev/skills/stefan-stepzero/shipkit/shipkit-product-definition)
Your own site
<a href="https://agentmods.dev/skills/stefan-stepzero/shipkit/shipkit-product-definition"><img src="https://agentmods.dev/badge/skills/stefan-stepzero/shipkit/shipkit-product-definition.svg" alt="Measured on agentmods" height="20"></a>
Per session 43 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 4,367 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. Scan, not verified.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00043 $0.04367
Opus 5 $0.00022 $0.02184
Sonnet 5 $0.00009 $0.00873
Haiku 4.5 $0.00004 $0.00437

Measured 5d ago against content hash 535c859d2f28, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-05, from the pricing page.

Security

Grade A, and why

shipkit-product-definition scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 5d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

install/skills/shipkit-product-definition/SKILL.md · 457 lines

How it starts

The opening of the file, as written. The whole thing — 457 lines — stays where its author put it; the contents beside it link to each section on GitHub.

shipkit-product-definition — Product Blueprint

Defines WHAT we build to solve discovered user needs. Reads product-discovery.json (pain points, personas, opportunities) and produces a product blueprint: features, UX patterns, differentiators, and the app's essence — its non-negotiable differentiators and interaction/quality bar captured as testable assertions a later eval can score a build against.

This is the product blueprint — it defines the user-facing solution. The technical approach (mechanisms, design decisions, stack) is handled by /shipkit-engineering-definition. Feature phasing (what to build now vs. later) is handled by /shipkit-product-goals through stage gates.


When to Invoke

User triggers:

  • "What should we build?", "Define features", "Product definition"
  • "UX patterns", "Differentiators", "What to build"
  • "Solution design", "Product blueprint"

Workflow position:

  • After /shipkit-product-discovery (needs discovered user needs)
  • Before /shipkit-engineering-definition (engineering designs mechanisms for these features)
  • Before /shipkit-product-goals (goals derive criteria from features and mechanisms)

Prerequisites

Required (fail gracefully if missing):

  • .shipkit/product-discovery.json — who the users are and what they need

Recommended (enrich the proposal):

  • .shipkit/why.json — project purpose and vision
  • .shipkit/goals/strategic.json — project stage and constraints

Optional (for existing projects):

  • .shipkit/stack.json — technology constraints (informs feasibility)
  • .shipkit/codebase-index.json — what already exists

If product-discovery.json is missing, tell the user: "Run /shipkit-product-discovery first — I need to understand user needs before designing a solution." and stop.


Process

Completion Tracking

After reading context, create tasks:

  • TaskCreate: "Define features mapped to pain points"
  • TaskCreate: "Define 2-4 UX patterns with rationale"
  • TaskCreate: "Capture essence — 3-5 non-negotiable differentiators as testable assertions"
  • TaskCreate: "Capture the interaction/quality bar as testable assertions"
  • TaskCreate: "Write product-definition.json"

Read the full file on GitHub · 457 lines

Files

What ships with it

2 files beside SKILL.md in the same directory: the scripts, references and assets a skill reads on demand. Not counted in the per-session cost; read them before you install if any of them is executable.

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 5d ago First seen · 457 lines · 43 tokens per session scan A 535c859d2f28

Subscribe to this mod's changes

shipkit-product-definition is a skill published in the GitHub repository stefan-stepzero/shipkit (1 stars, last pushed 1mo ago), licensed MIT. It adds 43 tokens to every session and 4,367 once invoked, about $0.0002 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.