Sandbox
@gmaxxxie/ai-native-product-agent-skills

AI product skills pack for agent-led product work

This repo gives builders a staged product methodology for AI-native work. The orchestrator routes you through needs discovery, direction framing, experiments, system design, business model, growth, UX, release, operations, team design, judgment, and aesthetics. Each stage lives as a skill file, so you can use the whole system or pull in one step at a time.

46 stars0 forksPythonUpdated 8d ago
Who it's for

Builders who want their agent to help them decide what to build, validate it, and ship it with structure.

What it delivers

You can move from a product idea to a validated plan without re-inventing the method at each step.

What it does

Stage-based methodology

Covers P0 through P14, from needs discovery to aesthetic authority.

Orchestrator and routing

Uses `orchestrator/SKILL.md` to route requests and detect conflicts across stages.

Executable skill library

Ships 80 skill definitions under `skills/`, each focused on one product decision or task.

Cross-stage combos

Includes combo skills such as needs-to-direction, business-to-growth, and UX-to-audit.

Validation and context helpers

Adds references for stage routing, product context schema, and conflict detection.

Install and run scripts

Provides `install.sh` plus Python scripts for initialization and validation.

How to get it

  1. 1Run
    # Install all 80 skills + orchestrator
    curl -fsSL https://raw.githubusercontent.com/gmaxxxie/ai-native-product-agent-skills/main/install.sh | bash
    
    # Start a product project
    hermes run "I want to build an AI customer service product, help me start from direction framing"
  2. 2Run
    git clone https://github.com/gmaxxxie/ai-native-product-agent-skills.git
    cd ai-native-product-agent-skills
    bash install.sh   # copies all skills to ~/.hermes/skills/ai-native-pm/

README

AI Native Product Methodology — 15 Stages Hero's Journey

AI Native PM Agent

An AI product coach that asks "Is this direction really worth pursuing?" — with structured methodology backing every decision, from spark of inspiration to production deployment.

📖 中文版 README


Why Do You Need This?

90% of AI product teams die in the same traps:

  • Direction Trap: Spend 3 months building an AI feature, only to find users won't pay for it
  • Needs Trap: Fake needs look too much like real ones — AI makes prototyping near-free, but also lets you build the wrong thing faster
  • Boundary Trap: AI crosses the line and does things it shouldn't, triggering compliance risks
  • Hallucination Trap: Pre-launch accuracy looks like 95%, post-launch reality says otherwise
  • Cost Trap: Token bills explode, business model falls apart

This Agent doesn't write code for you — it makes you pause at every critical decision point and verify with structured methods.

Why Not Just Use Traditional Product Methodology?

Traditional product frameworks (Lean Startup, Jobs-to-be-Done, Design Thinking) were built for a world where prototyping was expensive and AI didn't exist. They break down in the AI era because:

Traditional AssumptionAI Era Reality
Build-Measure-Learn takes weeksAI prototypes are near-free — you can build the wrong thing faster
User needs are relatively stableAI creates new needs and makes old ones obsolete overnight
Product boundaries are clearAI crosses lines you didn't draw — compliance, ethics, autonomy
Cost scales with featuresToken costs scale with usage — business model can invert
Launch is a milestoneAI products degrade post-launch (hallucinations, drift, adversarial inputs)

This methodology is AI Native from the ground up: it starts with boundary design before capability design, validates with certainty rather than confidence, and prices on risk reduction rather than feature count. Every stage assumes AI is in the loop — and designs for what happens when it goes wrong.


See What It Does in 30 Seconds

Click to watch the intro video
▶ Click to play the 30s introduction video (2.3 MB MP4)

Core Capabilities: 80 executable Skills across 8 stages + Stage auto-routing + Conflict detection + Evidence chain tracking


A Concrete Example

Scenario: You want to build an "AI Contract Review Assistant"

Needs Discovery (P0)

The Agent validates the need with tool cards:

  • Micro-Needs Five Questions: Lawyers review contract clauses daily — the pain is small but constant
  • Real-Needs Validation: Long-standing problem + compensation behaviors (manual annotation) + structural root cause (liability risk)
  • Four-Layer Decomposition: Surface: "automate review" → Situation: "lawyers bear liability risk" → Cost: "$200/hour per review"
  • Agent Boundary Checklist: AI can flag risky clauses, but cannot determine contract validity

Output: Needs validated + Agent boundary design

Direction Framing (P1)

The Agent asks you:

  • Where does contract data come from? (Availability)
  • Does it involve client confidentiality? (Desensitization)
  • Who is responsible for review results? (Authorization)
  • Is the output format standardized? (Structured)
  • What happens when new regulations emerge? (Sustained supply)

Output: Direction Brief — clear go/no-go with conditions

Business Model (P6)

The Agent prices using the Certainty Premium formula:

  • Fear Level: Lawyers' biggest fear is missing a risky clause → High
  • Error Cost: Missing one clause could mean millions in liability → Extremely high
  • Substitution Cost: Manual review at $200/hour → Medium
  • Recommended Model: Insurance Mode (charge per successful review, compensate for misses)

Output: Pricing strategy — $5/review, 10x compensation for missed clauses

Audit & Release (P9)

The Agent checks:

  • Reliability: Identification accuracy, hallucination rate
  • Safety: Sensitive information handling
  • Boundaries: Which clause types require human review
  • Cost: Token cost per review vs. pricing

Output: Release boundary document — Auto-execute zone / Human handoff zone / Disabled zone


Quick Start

Option 1: One-Click Install (Recommended)

# Install all 80 skills + orchestrator
curl -fsSL https://raw.githubusercontent.com/gmaxxxie/ai-native-product-agent-skills/main/install.sh | bash

# Start a product project
hermes run "I want to build an AI customer service product, help me start from direction framing"

Option 2: Install from GitHub URL

Install individual skills on demand:

# Orchestrator (entry point)
hermes skills install \
  https://raw.githubusercontent.com/gmaxxxie/ai-native-product-agent-skills/main/orchestrator/SKILL.md \
  --name ai-native-pm-agent

# Any individual skill
hermes skills install \
  https://raw.githubusercontent.com/gmaxxxie/ai-native-product-agent-skills/main/skills/p1-direction-framing/SKILL.md \
  --name p1-direction-framing

Option 3: Clone & Local Install

git clone https://github.com/gmaxxxie/ai-native-product-agent-skills.git
cd ai-native-product-agent-skills
bash install.sh   # copies all skills to ~/.hermes/skills/ai-native-pm/

Option 4: Use with Other AI Agents

These skills work as structured prompts — they're not tied to any specific agent framework.

The simplest way: just tell your AI agent to install from this repo.

AgentInstall Command
Hermes Agenthermes skills install https://github.com/gmaxxxie/ai-native-product-agent-skills
Claude Codeclaude "Install all skills from https://github.com/gmaxxxie/ai-native-product-agent-skills into this project"
OpenAI Codexcodex "Clone and set up https://github.com/gmaxxxie/ai-native-product-agent-skills — read all SKILL.md files and make them available as product methodology tools"
OpenCodeopencdoe run "Install AI Native PM Agent from https://github.com/gmaxxxie/ai-native-product-agent-skills"
Any LLMJust paste: "Read the skills from https://github.com/gmaxxxie/ai-native-product-agent-skills and apply the methodology to my product idea"

💡 Tip: Claude Code, Codex, and OpenCode can all git clone the repo and read SKILL.md files directly. Just give them the repo URL and tell them to install — they'll figure out the rest.

Per-Stage Usage

Each stage is an independent Skill you can call individually:

StageTrigger PhraseOutput
P0 Needs Discovery"I have a pain point…"Needs validation report
P0a Micro-Needs"Is this problem too small to matter?"Micro-needs list
P0b Real Needs"Is this need real or fake?"Real/fake verdict
P0c Decomposition"Help me decompose this need"Four-layer breakdown
P0d Archaeology"What's the deep need?"Deep needs report
P1 Direction Framing"I have an idea…"Direction Brief
P2 Experiment Engine"Help me design experiments…"Experiment plan + Rubric
P3 System Building"How to go from experiment to product…"System architecture
P5 Business Model"How to price this…"Pricing strategy
P6 Growth Strategy"How to get cold start…"Growth plan
P8 UX Design"How should this AI feel to use?"UX design + trust tiers
P9 Audit & Release"Ready to launch, check it…"Release boundary document
P10 Production Ops"It's live, how do I keep it healthy?"Monitoring + feedback loops
P11 Product Team"How should humans and AI collaborate?"Team structure + roles
P12 Contemplation"Am I even asking the right question?"View correction + prerequisite check
P13 Judgment & Intuition"How do I make better decisions?"Nine-step decision framework
P14 Aesthetic Authority"What makes this feel premium?"Aesthetic system + selection criteria

Cross-Stage Combos (One-Stop)

ComboTrigger PhraseOutput
Needs → Direction"Take me from pain point to direction framing"Direction Brief
Business → Growth"How should pricing and growth align?"Pricing-growth alignment
UX → Audit"Is this UX design safe to release?"UX audit report + release recommendation

Complete Skill List (80 Skills)

P0 — Needs Discovery Layer (17 Skills)

P0 Needs Discovery — Micro-Needs, Real-Needs Validation

IDNameWhat It Does
p0-needs-orchestratorNeeds Discovery OrchestratorCoordinates six tool cards for systematic needs discovery
p0-product-needsAI Native Product NeedsUnified needs discovery + fake needs detection
p0a-micro-needs-detectorMicro-Needs Five QuestionsDetects overlooked micro-needs
p0b-real-needs-validatorReal-Needs Five QuestionsDistinguishes real needs from fake ones
p0c-needs-decomposerNeeds Four-Layer DecompositionExpression / Scenario / Situation / Cost layers
p0d-needs-archaeologistNeeds Archaeology Five StepsUncovers deep needs and historical constraints
p0e-good-question-generatorGood Questions Six DimensionsDiscovers good questions from six perspectives
p0f-agent-boundary-designerAgent Boundary ChecklistDefines AI permission boundaries
p0g-diverse-recommendation-rewriterDiverse Recommendation RewriteFrom "guess what you like" to "help you discover"
p0g-diversity-rewrite-checklistDiversity Rewrite ChecklistValidates diversity rewrite quality
p0h-ai-product-triple-balanceAI Product Triple BalanceBusiness / Humanity / Technology balance
p0h-triple-balance-assessorTriple Balance AssessorEvaluates product triple balance state

P1–P2 — Direction & Experiment Layer (8 Skills)

P1 Direction Framing — Five Must-Answer Questions P2 Experiment Engine — Validate Before You Build

IDNameWhat It Does
p1-direction-framingDirection FramingFive-dimension judgment, Direction Brief
p2-experiment-engineExperiment Engine (Overview)Capability / Product / Business three-layer experiments
p2a-experiment-overviewExperiment OverviewMaterials prep, three-layer design, evaluation Rubric
p2b-product-form-explorationProduct Form ExplorationCapability boundary, interaction prototype, form judgment
p2c-process-redesignProcess RedesignTask decomposition, human-AI collaboration mode
p2d-convergence-decisionConvergence DecisionExperiment records, convergence signals, continue/pause/stop
p2e-shadow-validationShadow ValidationShadow system, parallel run, human comparison, audit evidence

P3–P4 — System Building Layer (5 Skills)

P3 System Building — Data→Capability→Product→Moat, Context Engineering, Agent Boundary

IDNameWhat It Does
p3-system-buildingSystem BuildingFrom experiments to product
p4-agent-skill-designAgent & Skill Unit DesignAgent/Skill unit design
p5-memory-systemMemory System DesignAI product memory architecture
p6-context-engineeringContext EngineeringContext management system
p7-knowledge-ragRAG & Knowledge SystemKnowledge management + RAG design

P5–P6 — Business Model Layer (5 Skills)

P6 Business Model — Certainty Premium & Pricing Strategy

IDNameWhat It Does
p6-business-modelAI Native Business Model (Overview)Certainty Premium business model design
p6a-certainty-premium-calculatorCertainty Premium CalculatorCalculates certainty premium
p6b-arbiter-mode-designerArbiter Mode Designer"Truth-as-a-Service" business model
p6c-insurance-mode-designerInsurance Mode Designer"Result Guarantee" business model
p6d-prediction-arbitrage-designerPrediction Arbitrage Designer"Time Arbitrage" business model

P7 — Growth Strategy Layer (6 Skills)

IDNameWhat It Does
p7-marketing-growthAI Native Marketing & Growth (Overview)Growth flywheel & marketing strategy
p7a-data-flywheel-builderData Flywheel BuilderAssesses and builds self-reinforcing data flywheels
p7b-intent-prediction-designerIntent Prediction DesignerFrom audience targeting to individual foresight
p7c-predictive-retention-designerPredictive Retention DesignerFrom post-churn recovery to pre-churn prevention
p7d-marketing-productizerMarketing-as-Product DesignerTurns marketing activities into product features
p7e-customer-loopCustomer LoopEarly customer filtering, co-creation boundaries, feedback loops

P8 — User Experience Layer (4 Skills)

P8 UX — RAX Framework, Trust Tiers, Progressive Disclosure

IDNameWhat It Does
p8-ux-designAI Native UX Design (Overview)UX design methodology
p8a-rax-risk-assessorRAX Risk AssessorRisk / Ambiguity / eXposure assessment
p8b-trust-tier-designerTrust Tier DesignerProgressive trust system design
p8c-progressive-disclosureProgressive Disclosure ChecklistFeature reveal pacing design

P9–P11 — Audit, Operations & Team Layer (9 Skills)

P11 Team + P12 Contemplation + P13 Intuition — Human-AI Collaboration, Decision Correction, Nine-Step Framework

IDNameWhat It Does
p9-audit-releaseAudit & ReleaseGo/no-go decision
p10-production-opsProduction OperationsMonitoring & feedback loops
p10a-value-discovery-loopValue Discovery LoopFrom value signal to direction correction闭环
p10b-aiops-caseAIOps Case TemplateComplete methodology path for high-risk scenarios
p10c-customer-service-caseAI Customer Service CaseService collaboration, Copilot, experience leverage
p10d-saas-caseAI Native SaaS CaseSemantic layer, capability moats, data flywheels
p11-product-teamAI Native Product TeamHuman-AI division, capability gaps, team roles

P12 — Contemplation Layer (10 Skills)

From: Contemplation — Product Judgment, User Understanding, and Decision Correction in the AI Era

IDNameWhat It Does
p12-contemplation-orchestratorContemplation OrchestratorRoutes to correct chapter skill, chains full decision-correction flow
p12a-contemplation-right-viewRight ViewThree-layer problem framing: phenomenon / situation / relationship
p12a-contemplation-view-correctionView CorrectionDefault checks, evidence validation, consequence inquiry, eight correction angles
p12a-contemplation-prerequisite-checkPrerequisite CheckIdentifies situational changes, validates assumptions, reassigns methods
p12a-contemplation-right-thinkingRight ThinkingDissect judgment chain, distinguish premise/evidence/reasoning/emotion
p12a-contemplation-right-speechRight SpeechLanguage cleaning, meeting health check, honest expression practice
p12a-contemplation-right-actionRight ActionValue/cost/emotion/exit-right quadruple check before execution
p12a-contemplation-right-livelihoodRight LivelihoodRevenue source review and incentive bias check
p12a-contemplation-right-effortRight EffortZero-based analysis, pause strategy, stop-loss decision
p12a-contemplation-right-mindfulnessRight MindfulnessEstablish personal and team decision awareness

P13 — Judgment & Intuition Layer (12 Skills)

From: Intuition — Judgment and Intuition in the AI Era

IDNameWhat It Does
p13-intuition-orchestratorIntuition OrchestratorNine-step closed-loop decision roadmap router
p13a-judgment-metacognitionJudgment MetacognitionUnderstanding judgment, identifying judgment scenarios
p13b-systemic-thinkerSystemic ThinkingStructural analysis, relationship mapping, feedback loop identification
p13c-product-psychologyProduct PsychologyUser mental models, behavior design, motivation analysis
p13d-intuition-trainingIntuition TrainingCompress intuition into cognitive models and pattern recognition
p13e-nine-step-frameworkNine-Step Framework OverviewComplete framework from "what to do" to feedback loop
p13f-first-half-judgmentFirst Half — What & Worth"What to do, is it worth it, should we use AI" judgment
p13g-mid-judgmentMid — Form & Trust"What form, how much trust, how to do it" judgment
p13h-validation-marketSecond Half — Validation"How to validate, how to enter market, feedback loop"
p13i-judgment-trapsJudgment TrapsCommon judgment errors and cognitive bias defenses
p13j-organizational-judgmentOrganizational JudgmentTranslating personal judgment into team judgment capability
p13k-intuition-evolutionIntuition EvolutionContinuous judgment training, standard improvement mechanism

P14 — Aesthetic Authority Layer (9 Skills)

P14 Aesthetic Authority — When Everything Can Be Generated, Selection Is the Skill

From: AI Beaty — Aesthetic Authority in the Age of AI

IDNameWhat It Does
p14-beauty-orchestratorBeauty OrchestratorRoutes to aesthetic training and aesthetic authority system
p14a-beauty-redefinitionAesthetic RedefinitionGeneration anxiety, six aesthetic dimensions, dual-axis model
p14b-beauty-ai-rolesAI's Role in AestheticsAmplifier / sparring partner / collaborator, not aesthetic itself
p14c-beauty-selectionSelection Over GenerationSelection is the new core skill — Context determines output ceiling
p14d-beauty-narrativeNarrative as AestheticStory structure, emotional rhythm, information architecture aesthetics
p14e-beauty-human-edgeHuman IndispensabilityAesthetic as moat, standard evolution, human core advantage
p14f-beauty-commercialCommercial Value of AestheticsMarket acceptance, aesthetic premium, experiential aesthetics
p14g-beauty-systemAesthetic Training SystemSystematic aesthetic standard accumulation and calibration
p14h-beauty-prefacePreface & Core PropositionAesthetic authority as core competitive advantage when everything can be generated

Cross-Book Combo Skills (3 Skills)

IDNameWhat It Does
combo-needs-to-directionNeeds → DirectionPain point to Direction Brief in one pass
combo-business-to-growthBusiness → GrowthPricing-flywheel alignment design
combo-ux-to-auditUX → AuditRAX assessment + trust tiers + release recommendation

Project Structure

ai-native-pm-agent-skills/
├── README.md / README_CN.md         # This document (EN / 中文)
├── ARCHITECTURE.md                  # System architecture design
├── skill-registry.yaml              # Skill registry (80 skills registered)
├── orchestrator/SKILL.md            # Main orchestrator: stage routing + conflict detection
├── install.sh                       # One-click install script
├── assets/                          # Hero banner, pipeline flow, industry matrix, methodology books
├── skills/
│   ├── p0-needs-orchestrator/        # P0 Needs Discovery orchestrator
│   ├── p0-product-needs/             # P0 unified needs discovery
│   ├── p0a-micro-needs-detector/     # P0a micro-needs detection
│   ├── p0b-real-needs-validator/     # P0b real vs fake needs
│   ├── p0c-needs-decomposer/        # P0c four-layer decomposition
│   ├── p0d-needs-archaeologist/     # P0d deep needs archaeology
│   ├── p0e-good-question-generator/ # P0e good questions six dimensions
│   ├── p0f-agent-boundary-designer/ # P0f AI boundary design
│   ├── p0g-diverse-recommendation-rewriter/    # P0g diversity rewrite
│   ├── p0g-diversity-rewrite-checklist/       # P0g diversity checklist
│   ├── p0h-ai-product-triple-balance/         # P0h triple balance
│   ├── p0h-triple-balance-assessor/           # P0h balance assessor
│   ├── p1-direction-framing/        # P1 direction framing
│   ├── p2-experiment-engine/        # P2 experiment overview
│   ├── p2a-experiment-overview/     # P2a experiment setup
│   ├── p2b-product-form-exploration/ # P2b product form
│   ├── p2c-process-redesign/       # P2c process redesign
│   ├── p2d-convergence-decision/    # P2d convergence decision
│   ├── p2e-shadow-validation/       # P2e shadow validation
│   ├── p3-system-building/          # P3 system building
│   ├── p4-agent-skill-design/       # P4 agent & skill design
│   ├── p5-memory-system/           # P5 memory system
│   ├── p6-context-engineering/      # P6 context engineering
│   ├── p7-knowledge-rag/            # P7 RAG & knowledge
│   ├── p6-business-model/           # P6 business model overview
│   ├── p6a-certainty-premium-calculator/    # P6a certainty premium
│   ├── p6b-arbiter-mode-designer/  # P6b arbiter mode
│   ├── p6c-insurance-mode-designer/ # P6c insurance mode
│   ├── p6d-prediction-arbitrage-designer/   # P6d prediction arbitrage
│   ├── p7-marketing-growth/         # P7 marketing overview
│   ├── p7a-data-flywheel-builder/   # P7a data flywheel
│   ├── p7b-intent-prediction-designer/      # P7b intent prediction
│   ├── p7c-predictive-retention-designer/   # P7c predictive retention
│   ├── p7d-marketing-productizer/   # P7d marketing productizer
│   ├── p7e-customer-loop/           # P7e customer loop
│   ├── p8-ux-design/               # P8 UX design overview
│   ├── p8a-rax-risk-assessor/       # P8a RAX risk assessment
│   ├── p8b-trust-tier-designer/     # P8b trust tier design
│   ├── p8c-progressive-disclosure/  # P8c progressive disclosure
│   ├── p9-audit-release/           # P9 audit & release
│   ├── p10-production-ops/          # P10 production operations
│   ├── p10a-value-discovery-loop/  # P10a value discovery loop
│   ├── p10b-aiops-case/            # P10b AIOps case
│   ├── p10c-customer-service-case/  # P10c AI customer service case
│   ├── p10d-saas-case/              # P10d SaaS case
│   ├── p11-product-team/           # P11 product team design
│   ├── p12-contemplation-orchestrator/     # P12 Contemplation orchestrator
│   ├── p12a-contemplation-right-view/      # P12 right view
│   ├── p12a-contemplation-view-correction/ # P12 view correction
│   ├── p12a-contemplation-prerequisite-check/   # P12 prerequisite
│   ├── p12a-contemplation-right-thinking/    # P12 right thinking
│   ├── p12a-contemplation-right-speech/      # P12 right speech
│   ├── p12a-contemplation-right-action/      # P12 right action
│   ├── p12a-contemplation-right-livelihood/   # P12 right livelihood
│   ├──

Files in the repo

Repository payload15 top-level entries
  • assets
  • orchestrator
  • references
  • scripts
  • skills
  • .audit-data.json
  • .review-prompt.txt
  • AGENTS.md
  • ARCHITECTURE.md
  • audit-report.md
  • COMMIT_MSG
  • install.sh
  • README_CN.md
  • README.md
  • skill-registry.yaml

Discussion (0)

Ask about usage, or say what you built with it

Sign in to join the discussion.

No comments yet. Be the first to say what this is good for.

More skills

obra/
superpowers

An agentic skills framework & software development methodology that works.

285k
1 add

Turn any codebase, with its docs, SQL schemas, configs, and PDFs, into a queryable knowledge graph. A /graphify skill for Claude Code, Cursor, Codex, and Gemini CLI: local deterministic AST parsing, every edge explained, no vector store.

117k
1 add
Vincentwei1021/
anything2explainer

Topic in, narrated explainer video out. A Claude Code / Codex skill that turns any topic into a black-canvas motion-graphics explainer video with TTS voiceover, subtitles and a chapter progress bar. Chinese or English; every frame drawn in code with Remotion.

666

Open-source AI job search: scan job portals, evaluate listings into a structured A-H report with a global 1-5 score, tailor your CV, track applications — runs locally in your AI coding CLI (Claude Code, Codex, OpenCode, Antigravity…)

71k