product-docs-first

A process for writing product documentation for each app before implementation begins. The documents describe what the app should do and can incorporate research and the project's North Star.

In plain words
What is it for?
Use it when starting a new app, turning research into product requirements, or grounding future planning in existing product documents. It is not intended for small fixes or already-scoped technical work.
Why use it?
It gives planning and coding a clear product purpose instead of leaving important behavior to be guessed during implementation.

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/fusebase-dev/fusebase-flow/product-docs-first
Any agent
npx skills add fusebase-dev/fusebase-flow --skill product-docs-first
Clone the repo
git clone --depth 1 https://github.com/fusebase-dev/fusebase-flow

Made for: Claude Code, Codex.

Per session 88 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 913 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 $0.00088 $0.00913
Opus 5 $0.00044 $0.00456
Sonnet 5 $0.00018 $0.00183
Haiku 4.5 $0.00009 $0.00091

Measured 2d ago against content hash ed929e9b9657, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

product-docs-first 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 2d 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.

.agents/skills/product-docs-first/SKILL.md · 85 lines

How it starts

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

Product Docs First

Style: Mode-B-lite. Artifact-gated — acts only when docs/<app>/product.md exists or the operator asks to create one.

Purpose

Design product documentation per app before writing code, so planning and implementation build from a clear product intent instead of guessing. Ingests operator research and the North Star (if present).

When to invoke

  • Operator starts a new app and says "design the product docs first", "write product documentation", "what should this app do".
  • docs/<app>/product.md already exists (read it to ground planning).
  • Operator dropped research in docs/<app>/research/ and asks to turn it into product docs.

Do not invoke when

  • No docs/<app>/product.md AND the operator did not ask to create one → silent no-op; do not auto-create.
  • Mid-implementation edits (planning already done).
  • Small bug fixes, refactors, copy-only changes, narrow technical tickets, or already-scoped implementation work with no long-lived product-intent change → do not expand product docs (FR-23 / flow-skills/documentation-budget/SKILL.md).

Required inputs

Input Where it lives If missing
Product intent (operator answers) chat ask in chat (FR-19); do not invent
Research (optional) docs/<app>/research/ proceed without; note it
North Star (optional) docs/north-star.md proceed; align if present
Template templates/product.md stop; template missing

Procedure

  1. Gate. If no docs/<app>/product.md and no operator request to create one → exit silently.
  2. Ingest any research + the North Star; summarize, cite, never invent domain facts.
  3. Design the product doc from templates/product.md: purpose, users, core jobs, key screens/flows, data, the apps this product breaks into (feeds product-apps-decomposition), non-goals.
  4. Write docs/<app>/product.md with last_updated today (only operator-provided content).
  5. Hand to planning (implementation-planning) grounded in the product doc.
  6. Ambiguity → ask operator (FR-19).

Read the full file on GitHub · 85 lines

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. 2d ago First seen · 85 lines · 88 tokens per session scan A ed929e9b9657

Subscribe to this mod's changes

product-docs-first is a skill published in the GitHub repository fusebase-dev/fusebase-flow (9 stars, last pushed 7d ago), licensed MIT. It adds 88 tokens to every session and 913 once invoked, about $0.0004 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.

Related

Other skills, from other repositories

adobe-express-core

Adobe Express environment essentials, two-runtime architecture, project setup, and MCP server configuration. Use when starting add-on development, understanding iframe vs sandbox boundaries, configuring MCP servers, setting up local projects, or validating manifest configuration.

Sandgrouse/adobe-express-dev-skill · 50 tokens

adobe-express-monetization

Monetize Adobe Express add-ons with subscriptions and payments. Use when designing checkout flows, defining subscription tiers, implementing webhook verification, managing entitlements, or securing backend billing logic.

Sandgrouse/adobe-express-dev-skill · 44 tokens

adobe-express-spectrum-ui-ux

Build or review Adobe Express add-on panel UI with Spectrum patterns, stack selection guidance (raw SWC, swc-react, React Spectrum), Express theme setup, state and navigation design, and actionable UX quality checks. Use when implementing or auditing panel layouts, interaction states, multi-screen flows, and…

Sandgrouse/adobe-express-dev-skill · 70 tokens

adobe-express-cors-and-backend

Diagnose and fix CORS errors between Adobe Express add-on UI and backend APIs across local development, private listing, and public listing stages. Use when browser requests fail with preflight, Access-Control-Allow-Origin, Access-Control-Allow-Headers, or OPTIONS issues; when moving from localhost to hosted add-on…

Sandgrouse/adobe-express-dev-skill · 92 tokens

adobe-express-document-manipulation

Create and modify document content in Adobe Express add-ons using Document SDK. Use when planning document operations, inserting shapes/text/media, sequencing sandbox commands, or troubleshooting document edits.

Sandgrouse/adobe-express-dev-skill · 43 tokens

adobe-express-oauth-authentication

Implement OAuth 2.0 and authentication flows for Adobe Express add-ons. Use when connecting to cloud providers (Dropbox, OneDrive, Google Drive), managing tokens, storing credentials, or designing login surfaces.

Sandgrouse/adobe-express-dev-skill · 50 tokens