Agent-Skills.md

Agent Skills: Stage 01 - Market Research

Conduct comprehensive market research and competitive analysis to validate the problem, understand the market landscape, and identify opportunities. Use when starting stage 01 (market-research) or when user asks about competitors or market analysis.

UncategorizedID: X-School-Academy/ai-dev-swarm/dev-swarm-stage-market-research

Repository

X-School-Academy/ai-dev-swarm
X-School-AcademyLicense: AGPL-3.0
73

Install this agent skill to your local

pnpm dlx add-skill https://github.com/X-School-Academy/ai-dev-swarm/tree/HEAD/dev-swarm/skills/dev-swarm-stage-market-research

Skill Files

Browse the full folder contents for dev-swarm-stage-market-research.

Download Skill

Loading file tree…

dev-swarm/skills/dev-swarm-stage-market-research/SKILL.md

Skill Metadata

Name
dev-swarm-stage-market-research
Description
Conduct comprehensive market research and competitive analysis to validate the problem, understand the market landscape, and identify opportunities. Use when starting stage 01 (market-research) or when user asks about competitors or market analysis.

Stage 01 - Market Research

Conduct comprehensive market research and competitive analysis to validate the problem, understand the market landscape, identify competitors, and discover market gaps and opportunities.

When to Use This Skill

  • User asks to start stage 01 (market-research)
  • User wants to research competitors or market landscape
  • User asks about market size, trends, or opportunities

Your Roles in This Skill

See dev-swarm/docs/general-dev-stage-rule.md for role selection guidance.

Role Communication

See dev-swarm/docs/general-dev-stage-rule.md for the required role announcement format.

Pre-Stage Check

Before starting, verify previous stages:

  1. Check if 00-init-ideas/ folder has content (not just .gitkeep)
  2. If previous stage is empty and has no SKIP.md:
    • Ask user: "Stage 00 is not complete. Would you like to skip it or start from that stage first?"

Instructions

Step 1: Context Review

Read all files to understand the project:

  • ideas.md
  • 00-init-ideas/*.md - All markdown files

Step 2: Create Stage Proposal

General Rules: See dev-swarm/docs/general-dev-stage-rule.md → "Create Stage Proposal Rules" section.

If this stage is skipped (has SKIP.md), execute the next non-skipped stage's agent skill. Otherwise, create the file 01-market-research/README.md with the following content:

2.1 Stage Goal

Brief the goal in 2-3 paragraphs:

  • What this stage aims to achieve
  • Why market research is critical for product success
  • How this builds upon previous stages
  • What deliverables will be produced

2.2 File Selection

Select files from these options based on project needs:

Market Analysis:

  • competitive-analysis.md - In-depth analysis of direct and indirect competitors
  • similar-products.md - Research on similar products in the market
  • market-size-opportunity.md - TAM, SAM, SOM analysis

Strategic Analysis:

  • swot-analysis.md - Strengths, weaknesses, opportunities, and threats analysis
  • market-trends.md - Current industry trends and market direction
  • market-gaps.md - Identified gaps in the market

Business Intelligence:

  • pricing-strategy.md - Competitor pricing research and recommended pricing models
  • feature-comparison.md - Feature comparison matrix

For each selected file, provide:

  • Short description
  • Why it's essential for this project
  • Key information it should include

2.3 Request User Approval

Ask user: "Please check the Stage Proposal in 01-market-research/README.md. Update it directly or tell me how to update it."

Step 3: Execute Stage Plan

Once user approves 01-market-research/README.md:

3.1 Create All Planned Files

Create each file listed in the approved README:

  • For .md files: Write comprehensive content based on actual web research

Quality Guidelines:

  • Use web search to gather real market data and competitor information
  • Cite sources where possible for credibility
  • Include quantitative data when available
  • Analyze at least 3-5 direct competitors
  • Identify specific, actionable market opportunities

3.2 Request User Approval for Files

After creating all files:

  • Provide a summary of what was created
  • Highlight key market insights discovered
  • Ask: "Please review the market research documents. You can update or delete files, or let me know how to modify them."

Step 4: Finalize Stage

Once user approves all files:

4.1 Documentation Finalization

  • Sync 01-market-research/README.md to remove any deleted files
  • Ensure all files are complete and well-formatted
  • Verify research findings are accurate and well-sourced

4.2 Prepare for Next Stage

  • Summarize key market insights for reference in later stages
  • Identify top competitors to consider during persona development
  • Note market gaps that represent strongest opportunities

4.3 Announce Completion

Inform user:

  • "Stage 01 (Market Research) is complete"
  • Summary of deliverables created
  • Key insights discovered
  • "Ready to proceed to Stage 02 (Personas) when you are"

Stage Completion Rules

See dev-swarm/docs/general-dev-stage-rule.md for stage completion, commit, and skip rules.

Key Principles

  • Base research on real data, not assumptions
  • Cite sources for credibility
  • Connect findings to product concept
  • Support smooth transition to persona development