mcpField
C
competitor-intel-agent

competitor-intel-agent

github.com/onewave-aiMarketing & growth393236 installsUpdated 1w ago
Repository

About competitor-intel-agent

competitor-intel-agent is a skill for monitoring competitors, interpreting public activity, and producing reports with historical context. It supports setup, recurring monitoring, and report-only runs, with explicit change scoring and data-quality rules.

Key features

  1. 01Configure competitors and monitoring dimensions
  2. 02Save dated snapshots and change logs
  3. 03Score changes and flag major shifts
  4. 04Generate reports with trend analysis
  5. 05Track sources, timestamps, and confidence

Use cases

  1. 01Set up tracking for selected competitors
  2. 02Review competitor changes across monitoring runs
  3. 03Summarize historical signals into recommendations

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/onewave-ai/claude-skills --skill competitor-intel-agent

After installing, type/competitor-intel-agentin Claude Code to confirm it loaded.

Bundled files

References and scripts installed along with SKILL.md.

references/
directory-structure.md
intel-report-format.md
monitoring-dimensions.md
scoring-and-rules.md

Details

From the project README

Competitor Intelligence Agent

Track competitor activity across multiple dimensions, detect meaningful changes, interpret the signals, and deliver actionable intelligence that builds historical context over time. Act as an analyst that connects dots, not a raw scraper.

Contents

  • references/directory-structure.md -- tracking directory layout, config.yaml, and usage-history.json templates
  • references/monitoring-dimensions.md -- the six monitoring dimensions with per-dimension analysis frameworks, detection protocols, and snapshot output formats
  • references/intel-report-format.md -- the full intelligence report template
  • references/scoring-and-rules.md -- change-detection scoring, trend protocol, data-quality rules, execution rules, quick commands

Workflow

  1. Determine the operating mode on invocation:
    • Setup (no tracking directory exists): collect the user's company name and description, competitor URLs/domains, priority monitoring dimensions, and output directory (default ./competitor-intel/). Create the directory structure and config.yaml. See references/directory-structure.md.
    • Monitoring run (tracking directory exists): proceed to steps 2-7.
    • Report only (user wants a report without new monitoring): read existing snapshots and change logs, synthesize trends, and generate strategic recommendations using references/intel-report-format.md.
  2. Read config.yaml to load the competitor list and settings, then read the most recent snapshot for each competitor and dimension.
  3. Execute monitoring across all configured dimensions. Apply the detection protocol for each dimension in references/monitoring-dimensions.md.
  4. Compare new data against previous snapshots. Score every change for magnitude per references/scoring-and-rules.md; flag changes rated 4-5 as immediate alerts.
  5. Write dated snapshots in the per-dimension output formats and log detected changes under the competitor's changes/ folder.
  6. Generate the intelligence report following references/intel-report-format.md. When 3 or more snapshots exist for a competitor, add longitudinal trend analysis.
  7. Update usage-history.json with the run metadata.

Guardrails

  • Never fabricate competitor data. If a fetch fails or a dimension has no data, state the gap.
  • Separate raw data (snapshots) from interpretation (reports).
  • Tag every data point with source, timestamp, and confidence; flag data older than 30 days as stale.
  • Recommend only legal, ethical competitive responses. Collect only publicly available professional information.

Apply the detailed change-detection, trend, data-quality, and execution rules in references/scoring-and-rules.md throughout.

Comments

Markdown supported