Skip to content

conversion-agency/agentic-seo-skills / skills/competitive-analysis

competitive-analysis

Verified

When 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.

references/modules/M7-brand.md

View on GitHub
# M7 — Brand Positioning & Conversion Surface

Observable positioning, value proposition, social proof, pricing surface, and CTA design across players. Editorial risk is high; the schema enforces literal-excerpt-before-label.

## Inputs

- `target` (domain) and `competitors[]` (domains).
- Per-player `key_pages[]` (optional): defaults to homepage; can include `/sobre`, primary service/product pages.
- `brand_context`: read from `project/brain/identity.md` and `project/brain/voice.md` when present; otherwise `brand_context: absent`.
- `attach_eeat_run: <slug>` (optional) for the project's own E-E-A-T baseline.

## Extraction surfaces (HTML deterministic)

- H1, hero subhead, hero CTA (text + position + destination URL).
- `## Sobre`/`## About` blocks when present.
- All CTA buttons/links above the fold and in the page's primary section.
- Logo strip / customer logos with adjacent attribution.
- Testimonials: text + name + role + company when visible.
- Numbers with adjacent citation/source (revenue, growth, customers); numbers without an adjacent citation move to `claims_unverified`, never to `proof_inventory`.
- Pricing surface: transparent (value shown), under-request (CTA "fale conosco"), hybrid, hidden.
- Title tag and meta description as compressed message.

## Compute rules

Every observation row must include `excerpt_literal` (max 200 chars) and `position` (`hero | above-the-fold | first-section | sticky | footer | modal`) BEFORE any qualitative label. Qualitative labels live under `synthesis` and reference the row id.

```yaml
positioning_table:
  - player: ""
    role: target | competitor
    h1:
      excerpt_literal: ""
      position: hero
    subhead:
      excerpt_literal: ""
      position: hero
    title_tag: ""
    meta_description: ""
    declared_differentiation:
      excerpt_literal: ""
      position: ""
    implicit_differentiation_observed:
      excerpt_literal: ""
      position: ""
cta_table:
  - player: ""
    cta_text: ""
    cta_position: hero | sticky | footer | modal | inline
    cta_destination: internal | external | anchor | form | calendar | demo | chat
    pressure_label: alta | media | baixa
    pressure_evidence:
      - excerpt_literal: ""
        position: ""
proof_inventory:
  - player: ""
    proof_type: logo | testimonial | number_with_source | award | certification
    excerpt_literal: ""
    position: ""
    source_or_attribution: ""
claims_unverified:
  - player: ""
    excerpt_literal: ""
    position: ""
    reason: "number without adjacent source"
pricing_table:
  - player: ""
    visibility: transparent | under_request | hybrid | hidden
    evidence:
      excerpt_literal: ""
      position: ""
differentiation_synthesis:
  brand_context: present | absent
  contrasts: []
  proposed_log_entry:
    tipo: decisao
    summary: ""
    evidence_refs: []
```

## Edge cases

- Logo carousel without adjacent attribution → `proof_type: logo` is allowed only when alt text or visible caption names the customer; otherwise move to `claims_unverified`.
- Pricing partially visible (faixa "a partir de") → `visibility: hybrid` with the excerpt.
- Hero is a video without overlay text → record `excerpt_literal: null` and position; do not transcribe video.
- Multi-language homepage detected with `hreflang`: extract from the project-language version.

## Anti-patterns

- Calling a CTA "agressivo" without an `excerpt_literal` + `position` row supporting it.
- Treating a customer logo as proof when it appears in a partner grid with no naming.
- Translating tone-of-voice observation into quality judgment ("amador", "fraco"). Stay descriptive.
- Auto-writing to `brain/identity.md` or `brain/voice.md`. Only propose `type: decision` log entries.
- Extracting numbers like "300% growth" without the adjacent source line; route to `claims_unverified`.
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: 115kUpdated Claude CodeCodexVerifiedInstall
add-runner-evalpaperclipai/paperclipAdd or extend a Paperclip Runner protocol evaluation definition, roster, assertion, or report fixture with provenance and narrow validation.Stars: 115kUpdated Claude CodeCodexVerifiedInstall
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: 115kUpdated Claude CodeCodexVerifiedInstall
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: 115kUpdated Claude CodeCodexVerifiedInstall