agentsclimarketplace
Sign in

Research icp

Skill hungv47/meta-skills/skills/research/research-icp

Builds ideal customer profiles and buyer personas from real voice-of-customer evidence — demographics, pain points, jobs-to-be-done, decision psychology, and online habitat for a target market. Use to define who you're talking to before messaging, channel, or positioning work. Foundational: its output feeds 13+ downstream skills. Not for competitive positioning (use prioritize) or campaign planning (use plan-campaign); for brand identity, see create-brand; for market sizing, see research-market.From its SKILL.md

Install
npx -y skills add hungv47/meta-skills --skill research-icp

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

One thing to look at

  • 14 stars14 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.

SKILL.md

10.1 KB, ~2.3k tokens by cl100k_base, as published. Nobody here has run it

ICP Research — Orchestrator

Foundational skill for all stacks. Coordinates sub-agents to build audience intelligence from real research, not assumptions. Capability metadata (route triggers, prerequisites, load map, artifact contract) lives in routing.yaml. Why this skill exists, creative-vs-structural framing, 10-gate quality summary: references/playbook.md.

Core question: Who exactly are we talking to and what keeps them up at night?

Critical Gates — load first

Non-negotiable before any agent dispatches:

  1. No guessed personas — VoC or interview evidence only. Every attribute traces to product context, brief, user input, or VoC quotes. Fabricated personas mislead 13+ downstream skills.
  2. Don't skip habitat mapping. IMC planning needs specific community names with density and engagement type. "They're on LinkedIn" is not actionable.
  3. Max 2 personas. More dilutes focus. If 4+ segments surface, force-rank by revenue potential; document cuts in Segment Rationale.
  4. Stale product context (>30 days) → recommend re-run. If docs/forsvn/canonical/product/PRODUCT-CONTEXT.md Date is older than 30 days, warn and recommend re-run. Proceeding → note "stale product context" in artifact header.

The source floor (≥5 independent sources/persona), confidence labels, and the mandatory Sample Bias section are critic-enforced (Gates 8–10 below), not pre-dispatch — see the critic checklist + references/confidence-and-bias.md.

Before Starting

Apply references/_shared/before-starting-check.md. Then:

  • Mode resolution (references/_shared/mode-resolver.md). budget: deep. --fast collapses to Route A (skips habitat-agent + decision-psychology-agent) IF Warm Start has sufficient context; critic gate collapses to single pass. Cold Start STILL fires under --fast when context is missing — --fast does NOT authorize hallucinating personas (Critical Gate 1 floor).
  • references/_shared/execution-policy.md — session execution profile (single-vs-multi)
  • Read .forsvn/index/manifest.json — find any prior docs/forsvn/canonical/research/ICP.md (re-run signal) and check docs/forsvn/canonical/product/PRODUCT-CONTEXT.md staleness (Gate 4).
  • Run Pre-Dispatch per references/procedures/pre-dispatch.md — auto-scan, Warm/Cold Start, 5-question Cold Start prompt, read order, Write-back map.

Quality Gate — critic checklist (9 of 10 gates)

Gate 7 (Brief Alignment) is critic-agent-only — it needs the originating brief. Full 10-gate rubric in agents/critic-agent.md.

  • Every VoC quote includes platform name and traces to a real source (not agent-generated)
  • Each persona has a habitat map with specific channels and supporting evidence. Aim for 3+; document why if fewer.
  • Each emotional driver traces to at least 2 specific quotes
  • Decision psychology names specific cognitive biases and objections (not generic "they need trust")
  • At least 15 VoC quotes across categories
  • Maximum 2 personas
  • Every finding carries [Confidence: H | M | L | sources: N] per references/confidence-and-bias.md. No unresolved L shipped.
  • Sample Bias section present and specific to this dataset. Generic disclaimers FAIL.
  • Each persona meets the ≥5 independent-sources floor. Below 5 → NEEDS_CONTEXT (or --hypothesis-mode with logged override).

Artifact Contract

  • Paths: docs/forsvn/canonical/research/ICP.md (canonical audience record, id: icp-research) + docs/forsvn/canonical/product/PRODUCT-CONTEXT.md (canonical foundational record, id: product-context — research-icp IS the producer).
  • Lifecycle: canonical — edited in place; on re-run overwrite in place and bump the integer version: (no .v[N].md sibling — git history holds priors).
  • Frontmatter: skill, version, date (ISO-8601), status, stack: research, review_surface: html, id: icp-research, type: canonical, keywords: [icp, persona, audience, voice-of-customer, pain, habitat]. See references/_shared/artifact-contract-template.md for the full schema.
  • Required body sections (in order — cross-stack contract): Persona 1 (Demographics + Pain Profile + Decision Psychology + Habitat Map) · Persona 2 (if applicable, max 2) · Top 3 Emotional Drivers · Red Flags · Next Step. Full template (60+ lines): references/format-conventions.md.
  • Optional sections: Segment Rationale (3+ segments surfaced, 2 cut per Gate 3) · Known Issues (critic FAILed twice and artifact ships with annotations).
  • Side effects (mandatory on PASS / done_with_concerns):
    • Write docs/forsvn/canonical/research/ICP.md.
    • Write or update docs/forsvn/canonical/product/PRODUCT-CONTEXT.md (8-section schema + Canonical Terminology).
    • Experience write-back per procedures/pre-dispatch.md Write-back map: Q1 → experience/product.md + mirror to docs/forsvn/canonical/product/PRODUCT-CONTEXT.md Product section; Q2/Q3/Q4 → experience/audience.md. Q5 (Route) is NOT persisted — routing only.
  • Consumed by: plan-campaign · create-brand · write-copy · brief-landing-page · brief-graphic · write-ad · write-outreach · research-shortform · brief-shortform · humanmaxxing · optimize-seo · polish-vn · write-social.
  • Cross-stack OUTPUT contract: Artifact Template structure + Habitat Map 5-column schema + Top 3 Emotional Drivers + Next Step block + PRODUCT-CONTEXT.md 8-section schema are load-bearing — schema changes require atomic update of 13 downstream consumers (anti-patterns.md row "Cross-stack contract drift").

Chain Position

Previous: none (or any skill needing audience context — Route C) | Next: plan-campaign, create-brand.

Foundational role: Creates docs/forsvn/canonical/product/PRODUCT-CONTEXT.md consumed by 13+ downstream skills. Run first for significantly better downstream output.

Re-run triggers: audience pivot, new market entry, major product changes, quarterly for active products.

Skill deference: competitive analysis / market sizing → research-market. Campaign planning from personas → plan-campaign. Brand identity using audience data → create-brand. Business-problem diagnosis → diagnose.

Routing + Dispatch

Three routes (A / B / C) — chosen at Pre-Dispatch (Cold Start Q5 or auto-inferred per procedures/pre-dispatch.md § Route Selection). Agent table + route graphs + pattern-catalog map: references/agent-manifest.md. Full 6-step Dispatch Protocol + single-agent fallback + critic FAIL routing: references/procedures/dispatch-mechanics.md.

Anti-Patterns

Read references/anti-patterns.md before output ships — 12 named anti-patterns (7 from original body + 5 cross-cutting: hallucination under --fast, canonical product-context.md mirror skip, Q5 routing-persistence, cross-stack contract drift, write-back skipped/partial). Detection + bad/good examples + verified agent ownership against critic-agent.md Rewrite Routing Table.

Durable Rules (protected)

<!-- SLOW_UPDATE_START --> <!-- No pinned rules yet. Populate via the slow-update workflow (see references/slow-update-fence.md). Each pinned rule must (a) be procedural not instance-specific, (b) be earned from a regression or critic-flagged failure, (c) cite the artifact / decision record that justified pinning. --> <!-- SLOW_UPDATE_END -->

Completion Status

  • DONE — full ICP synthesized, critic PASS, all 5-7 dimensions populated with quoted evidence.
  • DONE_WITH_CONCERNS — critic PASS but Route A used (habitat/decision-psychology omitted), OR VoC quote density thin (flagged in artifact).
  • BLOCKED — irreconcilable persona contradictions (e.g., two distinct buyers with no merge path); needs user scope decision.
  • NEEDS_CONTEXT — docs/forsvn/canonical/product/PRODUCT-CONTEXT.md missing AND user can't describe product/audience; recommend /discover first.

References

What ships with it: 40 files

411.6 KB alongside SKILL.md, 10 of them executable

agents/

references/

scripts/

Keep looking

Skills are one crate of 325,949. Ordering is by how many stacks a row turns up in, so the top of any crate is what has actually been picked rather than what has the most stars.