competitive-analysis（竞争分析）

Competitive Analysis Skill

Overview

The Competitive Analysis skill provides a structured framework for comparing your skills, commands, agents, and features against competitors. It enables systematic evaluation using weighted scoring dimensions and generates actionable insights for product strategy.

Core Capabilities

• Scorecard Generation - Multi-dimensional comparison with weighted scoring for visual scorecards
• Gap Analysis - Identify what competitors have that you don't with prioritized gap lists
• Advantage Identification - Document your competitive strengths in differentiation matrices
• Adoption Prioritization - Rank improvements by impact and effort for action roadmaps

When to Use This Skill

• Evaluating new market entrants or competitor updates
• Planning product roadmap priorities
• Identifying feature gaps before releases
• Documenting competitive differentiation for stakeholders
• Strategic planning sessions

Quick Start

# Run competitive analysis
python scripts/competitive_analyzer.py --competitor-path ./competitor-code --our-path ./

# Generate gap analysis
python scripts/gap_analyzer.py --competitor-path ./competitor

# Create visual scorecard
python scripts/scorecard_generator.py --analysis-file analysis.json

Key Workflows

1. Competitive Scorecard Generation

Purpose: Create a comprehensive comparison scorecard between your product and competitors.

Trigger: User provides competitor code/documentation for analysis

Process:

1. Discovery Phase

- Inventory competitor's capabilities (skills, commands, agents, features) - Catalog your own capabilities for comparison - Build comparison matrix with matched items

1. Analysis Phase

- Score each dimension (6 weighted categories) - Apply scoring rubric (1-5 stars) - Calculate weighted totals

1. Scoring Dimensions:

1. Output Generation

- Generate visual scorecard (ASCII box format) - Create feature comparison table - Summarize overall position (AHEAD / EVEN / BEHIND)

Deliverable: Competitive scorecard with visual summary and detailed breakdown

Example Output:

┌───────────────────────────────────────────────────────────┐
│                 COMPETITIVE SCORECARD                      │
│                 US (claude-skills) vs THEM (Competitor)    │
├───────────────────────────────────────────────────────────┤
│  🏆 WE WIN:     12 areas  (48%)  - Our advantages         │
│  🤝 TIE:         8 areas  (32%)  - At parity              │
│  🔄 DIFFERENT:   3 areas  (12%)  - Neither better         │
│  ❌ THEY WIN:    2 areas  (8%)   - Gaps to address        │
│                                                            │
│  Overall Position: WE ARE AHEAD                            │
│  Confidence: HIGH                                          │
└───────────────────────────────────────────────────────────┘

2. Feature Gap Analysis

Purpose: Identify gaps in your product compared to competitors and prioritize which to address.

Trigger: After scorecard generation or standalone gap assessment request

Process:

1. Gap Identification (Always label clearly as US vs THEM)

- THEY have, WE don't → Gaps for us to fill - WE have, THEY don't → Our advantages to maintain - Different approaches → Neither better, just different - THEY score higher → Priority improvements for us

1. Gap Categorization

1. Impact Assessment

- User impact (1-5) - Competitive urgency (1-5) - Strategic alignment (1-5) - Implementation effort (1-5)

1. Priority Calculation

   Priority Score = (Impact × 0.4) + (Urgency × 0.3) + (Strategic × 0.2) + (1/Effort × 0.1)

Deliverable: Prioritized gap list with recommended actions

Example Output:

┌───────────────────────────────────────────────────────────────┐
│                       GAP ANALYSIS                            │
│                   US vs THEM Comparison                        │
├───────────────────────────────────────────────────────────────┤
│                                                                │
│  🏆 WHAT WE HAVE THAT THEY DON'T (Our Advantages)             │
│  ├─ Executable Python tools (they have zero)                   │
│  ├─ Modular package structure (SKILL.md + scripts/)            │
│  ├─ Agent integration                                          │
│  └─ Builder tools for creation/validation                      │
│                                                                │
│  ❌ WHAT THEY HAVE THAT WE DON'T (Gaps to Fill)               │
│  ├─ Industry-specific guidance                                 │
│  ├─ Methodology variants (Agile/Waterfall)                     │
│  └─ Detailed constraint documentation                          │
│                                                                │
│  🟢 RECOMMENDATIONS FOR US                                    │
│  ├─ Add industry guides to our skill                           │
│  ├─ Document methodology variants                              │
│  └─ Add common challenges section                              │
│                                                                │
└───────────────────────────────────────────────────────────────┘

Reference: See references/gap-analysis-methodology.md

3. Competitive Advantage Identification

Purpose: Document and articulate your competitive strengths.

Trigger: Strategy sessions, positioning reviews, or marketing alignment

Process:

1. Advantage Discovery

- Features only you have - Areas where you score higher - Unique approaches or innovations - Integration capabilities

1. Advantage Classification

1. Strength Quantification

- Measure the delta (how much better) - Identify sustainability (easy to copy?) - Assess market value (does it matter to users?)

1. Messaging Development

- Elevator pitch for each advantage - Supporting evidence/metrics - Competitive positioning statement

Deliverable: Competitive advantage matrix with messaging guidance

4. Adoption Prioritization

Purpose: Create a prioritized roadmap for adopting competitor features or innovations.

Trigger: After gap analysis, planning sessions, or roadmap reviews

Process:

1. Candidate Identification

- Features worth adopting from competitors - Improvements needed for parity - Innovations to leapfrog competition

1. Evaluation Criteria

1. Prioritization Matrix

   HIGH IMPACT
        │
        │  ┌─────────┐  ┌─────────┐
        │  │ Quick   │  │ Major   │
        │  │ Wins    │  │Projects │
        │  └─────────┘  └─────────┘
        │
        │  ┌─────────┐  ┌─────────┐
        │  │ Fill    │  │ Consider│
        │  │ Ins     │  │ Later   │
        │  └─────────┘  └─────────┘
        │
        └──────────────────────────→
              LOW EFFORT    HIGH EFFORT

1. Timeline Planning

- Immediate (this sprint) - Short-term (this quarter) - Medium-term (next quarter) - Long-term (future consideration)

Deliverable: Adoption roadmap with prioritized items and timeline

Template: See assets/adoption-plan-template.md

Python Tools

competitive_analyzer.py

Purpose: Core analysis engine for competitive comparison

Usage:

# Analyze competitor against our repo
python scripts/competitive_analyzer.py --competitor-path ./competitor-code --our-path ./

# Scope to specific types
python scripts/competitive_analyzer.py --scope skills --competitor-path ./competitor

# Output JSON for further processing
python scripts/competitive_analyzer.py --output json --competitor-path ./competitor

Features:

• Auto-detection of skills, commands, agents
• Pattern matching for comparison candidates
• Weighted scoring calculation
• Multiple output formats (markdown, json, console)

gap_analyzer.py

Purpose: Identify and categorize feature gaps

Usage:

# Run gap analysis
python scripts/gap_analyzer.py --competitor-path ./competitor

# Focus on critical gaps only
python scripts/gap_analyzer.py --severity critical --competitor-path ./competitor

# Generate prioritized list
python scripts/gap_analyzer.py --prioritize --competitor-path ./competitor

Features:

• Gap categorization (critical, important, nice-to-have)
• Impact scoring
• Priority calculation
• Actionable recommendations

scorecard_generator.py

Purpose: Generate visual scorecards and comparison tables

Usage:

# Generate scorecard from analysis
python scripts/scorecard_generator.py --analysis-file analysis.json

# Custom output format
python scripts/scorecard_generator.py --format ascii --analysis-file analysis.json
python scripts/scorecard_generator.py --format markdown --analysis-file analysis.json

# Include detailed breakdown
python scripts/scorecard_generator.py --detailed --analysis-file analysis.json

Features:

• ASCII box scorecards
• Markdown tables
• Visual indicators (🟢 ✅ 🟡 ❌)
• Executive summary generation

References

Assets/Templates

Integration with Agents

This skill integrates with the following product team agents:

cs-product-strategist

Uses competitive analysis for:

• Market positioning decisions
• Feature prioritization
• Strategic planning sessions

Invocation: "Analyze competitor X against our product using the competitive-analysis skill"

cs-product-manager

Uses competitive analysis for:

• Roadmap planning
• Feature gap identification
• Sprint prioritization

Invocation: "Run a competitive scorecard against this repository"

cs-business-analyst

Uses competitive analysis for:

• Requirements gathering
• Gap documentation
• Stakeholder reporting

Invocation: "Generate a gap analysis comparing our capabilities to competitor Y"

Integration with Commands

/analyze.competition

The slash command version of this skill for quick analysis:

# Basic usage - paste competitor code after
/analyze.competition

# Scope filtering
/analyze.competition --scope skills
/analyze.competition --scope commands

# Output format
/analyze.competition --output markdown
/analyze.competition --output json

Relationship:

• Skill: Provides deep methodology, multiple workflows, reusable tools
• Command: Quick execution for ad-hoc analysis

Best Practices

Before Analysis

1. Gather Complete Data: Ensure you have access to competitor's full codebase or documentation
2. Define Scope: Determine what you're comparing (skills, commands, agents, all)
3. Establish Baseline: Know your own inventory before comparing

During Analysis

1. Use Consistent Criteria: Apply the same scoring rubric to both sides
2. Document Assumptions: Note any gaps in information
3. Seek Objectivity: Avoid bias toward your own product

After Analysis

1. Validate Findings: Have stakeholders review the scorecard
2. Prioritize Ruthlessly: Focus on high-impact, low-effort items first
3. Create Action Items: Convert insights into backlog items
4. Track Progress: Revisit gaps quarterly

Example Analysis Session

# 1. User invokes competitive analysis
/analyze.competition

# 2. System prompts for competitor code
"Please paste the competitor code you want to analyze..."

# 3. User pastes competitor SKILL.md, agent files, etc.
[User pastes code]

# 4. System runs 4-phase analysis
Phase 1: Discovery... inventorying 15 competitor skills
Phase 2: Analysis... scoring across 6 dimensions
Phase 3: Gap Analysis... identifying 8 gaps, 12 advantages
Phase 4: Reporting... generating scorecard

# 5. Output displayed and saved
Report saved to: output/sessions/{user}/{session}/competitive-analysis-2025-11-27.md

┌───────────────────────────────────────────────────────────┐
│                 COMPETITIVE SCORECARD                      │
│                 US (claude-skills) vs THEM (Competitor)    │
├───────────────────────────────────────────────────────────┤
│  🏆 WE WIN:     12 areas  (48%)  - Our advantages         │
│  🤝 TIE:         8 areas  (32%)  - At parity              │
│  🔄 DIFFERENT:   3 areas  (12%)  - Neither better         │
│  ❌ THEY WIN:    2 areas  (8%)   - Gaps to address        │
│                                                            │
│  Overall Position: WE ARE AHEAD                            │
│  Confidence: HIGH                                          │
└───────────────────────────────────────────────────────────┘

## Dimension Comparison

| Dimension | US | THEM | Winner |
|-----------|-----|------|--------|
| Documentation | ⭐⭐⭐⭐ | ⭐⭐⭐⭐⭐ | 🏆 THEM |
| Python Tools | ⭐⭐⭐⭐⭐ | ⭐⭐ | 🏆 US |
| Workflows | ⭐⭐⭐⭐ | ⭐⭐⭐⭐⭐ | 🏆 THEM |
| Architecture | ⭐⭐⭐⭐⭐ | ⭐⭐ | 🏆 US |
| Automation | ⭐⭐⭐⭐⭐ | ⭐ | 🏆 US |
| References | ⭐⭐⭐⭐ | ⭐⭐⭐ | 🏆 US |

## Recommendations for US

| What to Improve | Priority | Effort |
|-----------------|----------|--------|
| Add their workflow depth | 🟢 High | Low |
| Adopt their documentation patterns | 🟠 Medium | Medium |

Version History

Maintained By: Product Team Last Updated: November 27, 2025 Status: Production