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:

Discovery Phase

• Inventory competitor's capabilities (skills, commands, agents, features)

• Catalog your own capabilities for comparison

• Build comparison matrix with matched items

Analysis Phase

• Score each dimension (6 weighted categories)

• Apply scoring rubric (1-5 stars)

• Calculate weighted totals

Scoring Dimensions:

Dimension Weight What to Evaluate

Documentation Completeness 20% Metadata, sections, examples, clarity

Tool/Script Quality 20% CLI support, error handling, testing

Workflow Coverage 15% Number of workflows, depth, practicality

Architecture 15% Modularity, portability, dependencies

Automation 15% Auto-generation, validation, CI/CD

Reference Depth 15% Knowledge bases, templates, examples

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:

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

Gap Categorization

Category Symbol Action

Critical Gap 🔴 Must address immediately

Important Gap 🟠 Address in next quarter

Nice-to-Have 🟡 Consider for roadmap

Strategic Choice ⚪ Intentionally different

Impact Assessment

• User impact (1-5)

• Competitive urgency (1-5)

• Strategic alignment (1-5)

• Implementation effort (1-5)

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:

Advantage Discovery

• Features only you have

• Areas where you score higher

• Unique approaches or innovations

• Integration capabilities

Advantage Classification

Type Description Example

Technical Architecture or implementation superiority Zero-dependency design

Quality Higher standards or better execution 100% validation rate

Coverage More comprehensive offerings 28 skills vs 15

Innovation Novel approaches or features AI-assisted builders

Integration Better ecosystem connectivity MCP server support

Strength Quantification

• Measure the delta (how much better)

• Identify sustainability (easy to copy?)

• Assess market value (does it matter to users?)

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:

Candidate Identification

• Features worth adopting from competitors

• Improvements needed for parity

• Innovations to leapfrog competition

Evaluation Criteria

Criterion Weight Description

User Value 30% How much will users benefit?

Competitive Impact 25% Does this close a critical gap?

Strategic Fit 20% Does it align with our direction?

Implementation Cost 15% Resources and time required

Risk Level 10% Technical and market risks

Prioritization Matrix

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

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

Reference Purpose

scoring-framework.md Detailed scoring criteria and rubrics

gap-analysis-methodology.md Gap categorization and prioritization formulas

Assets/Templates

Template Purpose

scorecard-template.md Blank scorecard for manual analysis

adoption-plan-template.md Roadmap planning template

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

• Gather Complete Data: Ensure you have access to competitor's full codebase or documentation

• Define Scope: Determine what you're comparing (skills, commands, agents, all)

• Establish Baseline: Know your own inventory before comparing

During Analysis

• Use Consistent Criteria: Apply the same scoring rubric to both sides

• Document Assumptions: Note any gaps in information

• Seek Objectivity: Avoid bias toward your own product

After Analysis

• Validate Findings: Have stakeholders review the scorecard

• Prioritize Ruthlessly: Focus on high-impact, low-effort items first

• Create Action Items: Convert insights into backlog items

• 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

Recommendations for US

Version History

Version Date Changes

1.1.0 2025-11-27 Clearer US vs THEM labeling in all outputs

1.0.0 2025-11-27 Initial release with 4 workflows

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