skills.rest
williamsforeal
williamsforealCOMMUNITY
Explore all skills by this author →
GitHub

icp-deep-dive

Generate ICP persona cards from brand foundation files and web research.

1|Updated Feb 6, 2026
Search Tags:#marketing strategy#competitive analysis#customer insights#voice of customer#icp#persona research#firecrawl agent
One-click install
npx skills add https://github.com/williamsforeal/Cyclone-SS --skill icp-deep-dive
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: icp-deep-dive
Source: https://github.com/williamsforeal/Cyclone-SS/tree/main/global-skills/icp-deep-dive
Command: npx skills add https://github.com/williamsforeal/Cyclone-SS --skill icp-deep-dive

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill builds detailed ideal customer profile (ICP) cards without relying on guesswork by researching real customer language, pain points, and behaviors online (and optionally incorporating your first-party customer data).

Core Features & Use Cases

  • Foundation-driven research: Reads ./brand/brand-dna.md first (and recommends ./brand-voice.md) to scope research correctly to your category, competitors, and priority products.
  • Voice-of-customer extraction: Uses Firecrawl Agent to pull structured insights and direct quotes from forums, reviews, and social discussion, minimizing invented or generic persona language.
  • Persona refinement & validation: Confirms uncertain details via a short interview and saves 1–3 persona cards to ./brand/icp-cards.md for downstream marketing and ad/content execution.
  • Optional data-first flow: Prompts you to share reviews/surveys/support logs so first-party evidence can be prioritized over web research.

Quick Start

Ask the AI to build ICP cards for your brand by first loading brand DNA from ./brand/brand-dna.md and then generating up to three research-backed persona cards.

Frequently Asked Questions about icp-deep-dive

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

FAQPage Schema
How do I create research-backed ICP personas without guessing?▼

To build research-backed ICP personas, extract category, competitor, and voice-of-customer signals from brand foundation files and optional first-party inputs. This generates 1-3 validated persona cards saved for targeted marketing execution.

What is voice-of-customer extraction for persona research?▼

Voice-of-customer extraction for persona research pulls structured insights and direct quotes from forums, reviews, and social discussion. This minimizes generic language by capturing real customer pain points to define accurate ICP cards.

Can I use first-party customer data to build ideal customer profiles?▼

You can use first-party customer data to build ideal customer profiles by sharing reviews, surveys, and support logs. This data-first flow prioritizes your internal evidence over web research to refine persona accuracy.

Do I need brand foundation files to generate customer segmentation cards?▼

You need the brand DNA foundation file to generate customer segmentation cards, as it scopes research to your category and priority products. A brand voice file is also recommended to align persona extraction with your messaging.

What is the best way to define personas for targeted ads and content strategy?▼

The best way to define personas for targeted ads and content strategy is combining web-based voice-of-customer extraction with first-party data validation. This outputs structured persona cards aligning marketing execution with real customer behaviors.

What happens if web research tools are unavailable for persona research?▼

If web research tools are unavailable for persona research, the system falls back to interview-only refinement. It confirms uncertain details through a short interview and outputs final persona cards to your local markdown file.

Related Skills

Explore More Marketing & Sales Skills→
williamsforealwilliamsforeal
1

brand-voice-profiler

Build a brand voice rules file from brand DNA and scraped copy.

Community
Advanced
mentileadmentilead

content

Plan content marketing strategies for Shopify app developers.

Official
Advanced
lapaixkemsdortshlee-svglapaixkemsdortshlee-svg

customer-research

Extract customer insights from interviews, surveys, support tickets, and online reviews.

Community
Advanced
Celia-12Celia-12

find-customers

Identify and compile qualified B2B prospect companies into a CSV spreadsheet.

Community
Intermediate