conversion-agency/agentic-seo-skills / skills/competitive-analysis
competitive-analysis
VerifiedWhen the user wants to compare domains or URLs against competitors across SEO footprint, share of voice, keyword/content gap, head-to-head pages, off-page link gap (via backlink-analysis), and brand positioning. Orchestrates evidence from serp-extract, keyword-research, backlink-analysis, and topic-cluster without duplicating their work.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 16.6 KB |
| contract.yaml | config | 685 B |
| evals/fixture.md | markdown | 3.9 KB |
| references/modules/M1-footprint.md | markdown | 2.4 KB |
| references/modules/M2-share-of-voice.md | markdown | 3.4 KB |
| references/modules/M3-keyword-gap.md | markdown | 2.5 KB |
| references/modules/M4-link-gap.md | markdown | 2.0 KB |
| references/modules/M5-content-footprint.md | markdown | 3.4 KB |
| references/modules/M6-head-to-head.md | markdown | 2.3 KB |
| references/modules/M7-brand.md | markdown | 3.8 KB |
references/modules/M4-link-gap.md
View on GitHub# M4 — Link Gap & Linkable Assets (referenced)
Off-page link surfaces (Link Gap, Link Intersect, Anchor Distribution Comparison, Quality Mix, Velocity Delta, Page-Level Link Gap, Brand Mention Gap) are owned by `backlink-analysis` v2 `multi-competitor` mode.
This module consumes the backlink run and presents only the headline KPIs in the competitive report; it does not re-fetch or recompute.
## Inputs
- `attach_backlink_analysis_run: <slug>` (required) — path resolves to `project/audits/backlinks-<slug>/report.yaml`.
- Optional `bl_sections: []` to limit which backlink surfaces appear in the competitive headline KPIs.
## Behavior
1. Read the backlink run YAML.
2. Validate `mode == multi-competitor` and `status in {complete, partial}`. If `single` or `blocked`, return `m4_link_gap.status: not_run` with a limitation pointing to the missing run.
3. Extract headline KPIs:
```yaml
headline_kpis:
total_link_gap_rows: 0
total_link_intersect_rows: 0
top_anchor_diff_signal: ""
velocity_delta_largest_player: ""
velocity_delta_value: null
brand_mention_gap_rows: null
page_link_gap_rows: null
backlink_run_slug: ""
backlink_run_status: complete | partial
backlink_run_path: project/audits/backlinks-<slug>/report.yaml
```
4. The Companion report shows these KPIs and links to the backlink module's own report (`project/analyses/backlink-analysis/<slug>/report.md`).
## Sub-run policy
When the user did not pass `attach_backlink_analysis_run`, this skill may **schedule** a sub-run of `backlink-analysis` in `multi-competitor` mode using the same target and competitors. The sub-run produces its own report; M4 then attaches to that slug. Never inline backlink computation here.
## Anti-patterns
- Re-implementing `domain_intersection`, `page_intersection`, anchor diff, quality mix, velocity, or brand mention in this module.
- Showing more than a one-screen KPI summary in the competitive report; depth lives in the backlink module's own report.
- Treating an attached `single` run as multi-competitor. Reject and ask for the multi-competitor run.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| add-product-e2e-evalpaperclipai/paperclipAdd or extend a Paperclip full-stack runner E2E workflow, fixture, matcher, or report evidence path for local or Daytona execution. | Stars: 115k | Updated | Claude CodeCodex | Verified | Install |
| add-runner-evalpaperclipai/paperclipAdd or extend a Paperclip Runner protocol evaluation definition, roster, assertion, or report fixture with provenance and narrow validation. | Stars: 115k | Updated | Claude CodeCodex | Verified | Install |
| diagnose-why-work-stoppedpaperclipai/paperclipCompatibility entry point for failed, stalled, looping, or over-recovered Paperclip work. Use fix-failed-paperclip-run for the full diagnosis, regression, repair, real verification, and green-PR workflow; honor an explicitly requested diagnosis-only scope. | Stars: 115k | Updated | Claude CodeCodex | Verified | Install |
| fix-failed-paperclip-runpaperclipai/paperclipDiagnose and fix failed, stuck, slow, or incorrectly blocked Paperclip tasks and runs. Use with a task/run URL or failure report to trace the root cause, prove a regression red then green, check second-order effects, verify the real workflow, and deliver a PR with passing checks. | Stars: 115k | Updated | Claude CodeCodex | Verified | Install |