product-agent

Turns raw requests into Definition-of-Ready GitHub issues labeled flow:ready-dev.

96|11|Updated Feb 8, 2026
One-click install
npx skills add https://github.com/thefrederiksen/devthrottle --skill product-agent-thefrederiksen
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: product-agent
Source: https://github.com/thefrederiksen/devthrottle/tree/main/.claude/skills/product-agent
Command: npx skills add https://github.com/thefrederiksen/devthrottle --skill product-agent-thefrederiksen

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Raw ideas, bug reports, and feature asks often enter a development pipeline as vague, untestable tickets that stall developers or bounce back and forth. This Skill enforces a seven-point Definition of Ready so every GitHub issue handed to a Developer Agent is specific, measurable, and scoped before work begins. ## Core Features & Use Cases - DoR-gated issue creation: Drafts issues with title area prefixes, problem/value statement, explicit IN/OUT scope, measurable acceptance criteria, affected containers from architecture_manifest.yaml, proof targets, and flagged assumptions, then applies the flow:ready-dev label via gh. - Autonomous reject re-sharpening: Reads Developer Agent rejection comments on flow:rejected issues, fixes the named gap, increments the reject cycle count, and re-labels, escalating to flow:needs-human after three rejections. - Optional work-list queueing: Appends ready issues to an explicitly named Gateway work list via POST /lists/{name}/items so the queue runner drains them in order, without ever creating lists itself. - Use Case: A user says "make this ready for dev: the cockpit dashboard loses WebSocket connection after idle." The Skill classifies it as a bug, drafts a DoR-compliant issue with testable criteria, self-checks all seven points, creates it with flow:ready-dev, and reports the link. ## Quick Start Ask the product agent to turn your raw feature request or bug report into a dev-ready GitHub issue, for example by saying "product agent: write a work item for adding dark mode to the cockpit dashboard."

Frequently Asked Questions about product-agent

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I write a GitHub issue that is ready for development?▼

Structure the issue with a specific area-prefixed title, a problem/value paragraph, explicit IN and OUT scope, measurable acceptance criteria, affected containers, a proof target, and flagged assumptions. This Skill checks all seven Definition of Ready points before applying the flow:ready-dev label.

How does the product agent handle rejected GitHub issues?▼

It reads the Developer Agent's rejection comment, fixes the named Definition of Ready gap, re-checks the full checklist, comments with an incremented reject cycle count, and swaps flow:rejected for flow:ready-dev. After a third rejection it labels the issue flow:needs-human and stops.

Can the product agent write or suggest implementation code?▼

No. The Skill has a hard boundary against writing, editing, or suggesting implementation code of any size. It only defines what must be built and how success is verified; implementation belongs to the Developer Agent.

What labels does the product agent use on GitHub issues?▼

It maps requests to existing repo labels such as bug, enhancement, cockpit, and installation, and manages flow state with flow:ready-dev, flow:rejected, and flow:needs-human. Only one flow:* label exists on an issue at a time.

When does the product agent append an issue to a work list?▼

Only when a list name is explicitly provided by the human. It POSTs the issue ref to the Gateway's /lists/{name}/items endpoint, never creates lists itself, and leaves the item label-only when no list is named.