competitive-analysis
npx machina-cli add skill jikig-ai/soleur/competitive-analysis --openclawCompetitive Analysis
Run a competitive intelligence scan producing a structured report at knowledge-base/overview/competitive-intelligence.md.
Steps
1. Detect Invocation Mode
If arguments are present (non-empty):
- If arguments contain
--tiers, extract the comma-separated tier list. - Otherwise, use default tiers (0,3).
- Skip to Step 3.
If no arguments, proceed to Step 2.
2. Interactive Tier Selection (skipped if args provided)
Use AskUserQuestion to select tiers:
- Tier 0 + 3: Platform threats and CaaS competitors (default)
- All tiers (0-5): Full landscape scan
3. Run Competitive Intelligence Agent
Spawn the competitive-intelligence agent via Task tool:
Task competitive-intelligence: "Run a competitive intelligence scan for tiers <TIERS>. Research each competitor in the specified tiers, read brand-guide.md and business-validation.md for positioning context, and write the report to knowledge-base/overview/competitive-intelligence.md."
4. Report Results
After the agent completes:
- Confirm the report was written (or output as code block in CI)
- Display the executive summary
Scheduled Execution
The scheduled-competitive-analysis.yml workflow runs this skill monthly via claude-code-action. The agent's prompt includes instructions to commit and push the report to main after creating the audit trail issue. The push must happen inside the agent (not a separate workflow step) because: (1) claude-code-action revokes the App installation token in its post-step cleanup, and (2) the Claude App is a bypass actor on the CLA Required ruleset, so only pushes under its identity succeed. The GitHub Issue is still created as an audit trail.
Source
git clone https://github.com/jikig-ai/soleur/blob/main/plugins/soleur/skills/competitive-analysis/SKILL.mdView on GitHub Overview
This skill runs competitive intelligence scans against tracked competitors and produces a structured knowledge-base report at knowledge-base/overview/competitive-intelligence.md. It uses the competitive-intelligence agent and reads brand-guide.md and business-validation.md for positioning context.
How This Skill Works
When invoked with arguments, it parses --tiers or defaults to tiers 0 and 3. Without args, it offers an interactive tier selection. It then spawns the competitive-intelligence agent to scan the specified tiers and writes the results to knowledge-base/overview/competitive-intelligence.md, followed by presenting an executive summary.
When to Use It
- Run a monthly or quarterly landscape update for tracked competitors at tiers 0 and 3.
- Perform a market research report comparing competitors across tiers 0-5.
- Ensure positioning aligns with brand-guide.md and business-validation.md for each competitor.
- Automate scheduled competitive intelligence to maintain an up-to-date knowledge base.
- Prepare an executive summary for leadership with a complete competitive snapshot.
Quick Start
- Step 1: Invoke the skill with --tiers or trigger words (e.g., competitive analysis).
- Step 2: If no args are provided, allow the system to AskUserQuestion to select tiers.
- Step 3: Run the Task: competitive-intelligence to generate the report and save it to knowledge-base/overview/competitive-intelligence.md.
Best Practices
- Define the exact set of tracked competitors and pre-configured tiers before running the scan.
- Ensure brand-guide.md and business-validation.md exist for accurate positioning context.
- Prefer the scheduled-competitive-analysis workflow for consistency and audit trails.
- Review the executive summary separately from the full report for quick decisions.
- Store the resulting report at knowledge-base/overview/competitive-intelligence.md and link it in the knowledge base.
Example Use Cases
- Monthly landscape update for Tier 0+3, highlighting platform threats and CaaS competitors.
- Full market research across Tiers 0-5 to compare features, pricing, and positioning.
- Positioning alignment check using brand-guide.md and business-validation.md.
- Automated report generation with push to main after creating an audit trail issue.
- Executive summary displayed after the competitive-intelligence agent completes the scan.
