domain-authority-auditor

$npx mdskill add aaron-he-zhu/aaron-marketing-skills/domain-authority-auditor

Audits domain authority against a peer cohort using a 40-item CITE profile.

  • Evaluates domain trust and citation credibility relative to competitors.
  • Depends on a declared peer cohort and market context for comparison.
  • Runs a 40-item CITE profile with evidence gaps and veto checks.
  • Delivers a complete CITE score with manipulation and penalty verification.

SKILL.md

.github/skills/domain-authority-auditorView on GitHub ↗
---
name: domain-authority-auditor
slug: domain-authority-auditor
displayName: "Domain Authority Auditor · 域名权威"
summary: "域名权威/网站可信度"
description: 'Use when auditing domain authority, trust, or citation credibility; runs a peer-relative 40-item CITE profile with evidence coverage and verified manipulation/penalty veto checks. Not for page-level content quality — use content-quality-auditor; not for backlink profiling alone — use offsite-signal-analyzer. 域名权威/网站可信度'
version: "18.0.0"
license: Apache-2.0
compatibility: "Claude Code and compatible agent-skill hosts"
homepage: "https://github.com/aaron-he-zhu/aaron-marketing-skills"
when_to_use: "Use when auditing domain trust and citation authority against a declared peer cohort. Runs the typed CITE 40-item profile with explicit evidence gaps and veto verification."
argument-hint: "<domain> <market> <peer cohort> [domain type]"
class: auditor
metadata: {"author": "aaron-he-zhu", "version": "18.0.0", "discipline": "seo-geo", "phase": "evaluate", "geo-relevance": "medium", "hermes": {"tags": ["marketing", "seo-geo", "evaluate"], "category": "seo-geo"}, "openclaw": {"emoji": "🔍", "homepage": "https://github.com/aaron-he-zhu/aaron-marketing-skills"}}
---

# Domain Authority Auditor

Audit one domain's citation-trust signals relative to a declared peer cohort. Produce a complete CITE score only when all applicable evidence and comparison context are present. CITE is advisory; it does not predict whether an answer engine will cite the domain.

## When This Must Trigger

- The user asks whether a domain is trustworthy, authoritative, or citation-ready.
- A campaign needs a peer-relative CITE baseline or rerun.
- Link, entity, penalty, or citation evidence may materially change a domain gate.

## Quick Start

```text
Audit example.com against these five same-stage U.S. SaaS peers.
Run the CITE content-publisher profile; mark every private-data gap Unknown.
```

## Skill Contract

Use `offsite-signal-analyzer` for link diagnosis without a gate, `content-quality-auditor` for one page, and `entity-registry` for canonical entity repair. Compare multiple domains as separate same-profile runs; never score them as one pooled target.

**Reads:** one domain, one locked cohort, and dated citation/identity/trust/eminence evidence. **Writes:** only a permissioned v3 artifact. **Done when:** context is complete, all 40 states are explicit, the scorer result is preserved, and any saved artifact validates.

## Instructions

### Runtime Contract

Read `../../../references/auditor-runbook.md`, `scoring-semantics.md`, `cite-domain-rating.md`, and the `CITE` entry in `framework-catalog.json`. For standalone installs, use bundled immutable `references/auditor-runtime.md`; never fetch mutable `main` or guess missing policy. Before deterministic calls, follow [`runtime-invocation.md`](../../../references/runtime-invocation.md), resolve `AARON_SKILLS_ROOT="${CLAUDE_PLUGIN_ROOT:-$(git rev-parse --show-toplevel 2>/dev/null || true)}"`, and require the scorer, validator, and typed catalogs. If unavailable, return `score_state: NOT_SCORED` / `score_confidence: not_scored` with no gate verdict or persistent artifact.

### Required Setup

Declare:

- one canonical domain and observation date;
- market and entity stage;
- domain type/profile: `default`, `content-publisher`, `product-service`, `ecommerce`, `community-ugc`, `tool-utility`, or `authority-institutional`;
- a locked peer cohort with inclusion rules and evidence window.

Without peer cohort, market, stage, or domain type, return `NEEDS_INPUT/UNDECIDED`; the inherited numeric anchors are diagnostic priors, not universal thresholds.

## Data Sources

| Need | Preferred evidence |
|---|---|
| Links | Dated backlink export/index with known coverage |
| Identity | Structured data, canonical profiles, knowledge-graph/public entity evidence |
| Trust | Link-history comparison, security checks, authorized console evidence |
| Eminence | Search/analytics visibility and locked peer/query panels |
| Cohort | Named domains plus inclusion/exclusion, market, stage, type, and window |

### Evidence Procedure

1. Normalize the domain and verify scope (host/subdomain/protocol treatment).
2. Freeze backlink, entity, security, search visibility, citation-panel, and reputation evidence with sources/dates.
3. Evaluate all 40 IDs against the declared cohort. Tool estimates remain `estimated` or `proxy`; user exports remain `user-provided` unless independently verified.
4. Use Unknown for absent backlink indexes, private console data, or comparison universes. Do not mark link-dependent items N/A simply because data is unavailable.
5. Apply catalog-authorized N/A only with a reason, for example an AI-citation item when no locked panel is in scope.
6. Verify vetoes positively:
   - `CITE-T03`: material link/traffic incoherence plus corroborating manipulation evidence relative to the cohort.
   - `CITE-T05`: verified manipulation network after common-source/ecosystem adjustment.
   - `CITE-T09`: verified active manual action or material unresolved deindexing.

Domain youth, privacy-protected WHOIS, low absolute volume, or missing private-console access cannot by themselves fail a veto.

Create a typed `audit-run.schema.json` input and execute `python3 "$AARON_SKILLS_ROOT/scripts/rubric-score.py" score <run.json>` when the verified runtime is available. Never renormalize weights around Unknown items.

## Report

Lead with verdict, profile/cohort/target/date, score or `NOT_SCORED` coverage/interval, and confidence. Then provide:

- C/I/T/E score and coverage table;
- peer-relative evidence and cohort definition;
- verified risks versus unresolved Unknowns;
- top fixes with owner, evidence needed, and rerun condition;
- provenance appendix, including qualified IDs when detailed traceability is requested.

Use SHIP/FIX/BLOCK/UNDECIDED as the canonical artifact verdict. User-facing prose may say trusted/cautious only as a descriptive translation, never as a separate decision system.

## Verdict Rules

- Complete, no veto, healthy score/no failures: `DONE` + `SHIP`.
- Complete, remediation needed or one veto: `DONE_WITH_CONCERNS` + `FIX`; one veto caps final at 59.
- Complete, 2+ verified vetoes: `DONE` + `BLOCK`; no final score.
- Missing applicable/cohort evidence: `NEEDS_INPUT` + `UNDECIDED`; no score.

Route link investigation to `offsite-signal-analyzer`, technical/index evidence to `technical-seo-checker`, entity repair to `entity-registry`, and page quality to `content-quality-auditor`.

## §2 CITE Worked Examples

- Complete product-service profile, raw 78, one verified T09 failure: `DONE_WITH_CONCERNS/FIX`, final 59.
- Complete profile, raw 45, one verified T05 failure: final remains 45; the ceiling never raises a score.
- Verified T03 and T05 failures with complete evidence: `DONE/BLOCK`, raw retained, no final score.
- Missing backlink universe or private-console evidence: affected items are Unknown and no total is emitted.

## §3 CITE Guardrails

- Young domain age and WHOIS privacy are neutral without contradictory evidence.
- A press/launch spike can explain link velocity; test the explanation before labeling manipulation.
- Absolute volume is interpreted within peer cohort, entity stage, market, and domain type.
- Public index absence does not prove a private manual action; T09 requires positive evidence.

## §5 CITE Translation

Use plain descriptions by default. On a trace request, show `CITE-T03`, `CITE-T05`, and `CITE-T09` with source/date/cohort; never expose an unqualified ID.

## Persistence

Persist only after explicit authorization. Assemble the complete v3 draft, validate it against the intended `memory/audits/domain/YYYY-MM-DD-<topic>.md` relative path, persist only through one full-content Write, and revalidate the target. Edit/shell/MCP mutations of the reserved sink are unsupported. Use:

```bash
python3 "$AARON_SKILLS_ROOT/scripts/validate-audit-artifact.py" <draft> --relative-path <target>
```

The audit request itself does not authorize hot-cache, candidate, or registry writes.

## Validation Checkpoints

- Target/profile/market/stage/cohort are explicit and locked.
- All 40 IDs have evidence-backed state, Unknown, or valid N/A.
- Absolute anchors were not applied as cohort-independent laws.
- Vetoes are verified failures, not absence-of-evidence shortcuts.
- Scorer output, coverage, confidence, status, and verdict are preserved.
- Persisted artifact is permissioned, path-correct, minimized, and validator-clean.

## Reference Materials

- [CITE benchmark](../../../references/cite-domain-rating.md)
- [Auditor runbook](../../../references/auditor-runbook.md)
- [Scoring semantics](../../../references/scoring-semantics.md)
- [Offsite signal analyzer](../offsite-signal-analyzer/SKILL.md)

## Next Best Skill

- **Investigate links:** [offsite-signal-analyzer](../offsite-signal-analyzer/SKILL.md)
- **Repair entity state:** [entity-registry](../../../protocol/entity-registry/SKILL.md)
- **Verify technical/index state:** [technical-seo-checker](../../tune/technical-seo-checker/SKILL.md)
- **Audit representative content:** [content-quality-auditor](../../tune/content-quality-auditor/SKILL.md)

More from aaron-he-zhu/aaron-marketing-skills

SkillDescription
ad-account-auditorUse when auditing a paid ad account for incremental contribution, wasted spend, or measurement integrity before scaling; runs a typed 20-item ROAS profile with verified vetoes and a SHIP/FIX/BLOCK/UNDECIDED gate on own exported data. Not for campaign structure design — use campaign-architect; not for creative production — use ad-creative-builder. 付费广告账户审计/ROAS评分
ad-creative-builderUse when the user asks to "write ad copy", "generate RSA headlines", or "build ad creative at volume"; produces ad units — RSA headlines/descriptions, hooks, and an angle matrix — message-matched to the destination landing page. Not for scoring an ad account — use ad-account-auditor; not for the post-click page — use landing-optimizer; not for organic articles — use content-writer. 广告创意/广告文案/RSA标题
ad-test-designerUse when the user asks to "design an A/B test", "set up a creative/landing test", "run an incrementality test", or "is this result statistically and practically material?"; produces a hypothesis, variant matrix, sample-size/duration/power plan, and a documented effect/uncertainty read from own exported results. It applies only a precommitted owner-approved action rule; the statistical helper never chooses a business action. Not for producing variants — use ad-creative-builder; not for reading back one shipped change — use paid-measurement-loop. 广告AB测试设计/实验设计/显著性判定/增效测试
advocacy-program-designerUse when the user asks to "design an employee advocacy program", "set up founder-led sharing", or "build a share kit for the team"; produces an advocacy program blueprint in two modes — participation-driven opt-in (default) or top-down assigned with its coercion and authenticity risks flagged — with a voluntary opt-in roster spec submitted as channel-registry proposal events, share kits with mandatory per-person variation, staggered human posting windows plus anti-pod guardrails (no coordinated identical reshares, no engagement rings), per-person material-connection disclosure lines per FTC and 《互联网广告管理办法》, and a Slack/Teams distribution spec. Not for paid creator campaigns — use campaign-planner. 员工倡导/创始人IP分享/内部分享计划/披露合规
attribution-reconcilerUse when platform-reported conversions disagree with GA4/ecommerce, when you suspect Meta and Google are double-counting the same sales, or for a standing (monthly) reconciliation workbook that de-dups stacked credit against an order-ID truth set, normalizes attribution windows and currency, compares attribution models, and reads incrementality from a geo/holdout test. Not for the point-in-time R2 veto or RQS gate — use ad-account-auditor; not for the ROI/ROAS ratio math itself — use roi-calculator; not for organic dark-social share attribution or GA4 direct-traffic decomposition — use dark-social-attributor. 付费广告归因对账/去重/增量
audience-belief-mapperUse when the user asks to "map what our buyers believe", "capture the objections we keep hearing", or "find the switching forces that move the beachhead"; produces a belief map of the beachhead — held beliefs and mental models, the recurring objections and their reframes, and the JTBD four forces (push of the problem, pull of the new, anxiety of switching, habit of the present) — each item sourced from interviews or win-loss notes (User-provided) and labeled Measured / User-provided / Estimated, with any unverified quote or comparative claim marked "[needs source]" and routed to the claims candidates, never adjudicated here. Not for demographic or persona profiling — use audience-mapper; not for the positioning canvas — use positioning-truth-tracer. 受众信念/异议地图/切换四力/流失语言
audience-mapperUse when the user asks to "analyze my target audience", "build an audience profile for influencer targeting", "research a niche community", or "deep-dive a subculture before partnering with creators"; in audience mode produces demographic/psychographic profiles, a platform-priority matrix, named personas, and an influencer-selection criteria set, and in niche mode produces a community map, culture decode (language/norms/taboos), key-voice tiers, a Brand Fit Score, and a phased entry strategy. Not for finding specific creators to contract — use influencer-discovery; not for scoring a shortlist on Suitability — use fit-scorer. 目标受众画像/人群分析 · 细分社群/亚文化调研
audience-segment-builderUse when the user asks to "build audience segments from my customer list", "make value-based / lookalike seed lists", "set up exclusion / suppression segments", or "map audiences to funnel stages across platforms"; turns the user''s OWN customer/CRM/GA4 export into seed audiences, value-based lookalike SEED lists, exclusion/suppression segments, and a cross-platform funnel-stage targeting map, informing the ROAS A (Audience) dimension. Not for building account structure or match types — use campaign-architect; not for organic SERP intent — use keyword-research. 付费广告受众分群/种子人群/排除人群/相似人群种子
bid-strategy-plannerUse when the user asks to "pick a bid strategy", "set a tCPA/tROAS target", or "plan the learning-phase entry"; produces a bid-strategy choice (tCPA / tROAS / max-conversions / manual CPC), the starting target math, a portfolio grouping map, and a learning-phase entry plan. Not for splitting the budget across campaigns — use budget-optimizer; not for in-flight pacing/scale moves — use budget-pacing-monitor; not for scoring the account — use ad-account-auditor. 出价策略/tCPA目标/tROAS/学习期
brand-language-codifierUse when the user asks to "codify our brand voice", "define naming rules for our products and tiers", or "write the tone-of-voice guide with banned phrases"; produces the brand-level voice canon (register, tone spectrum, banned-phrase list, few-shot examples drawn only from the brand''s own published material) and the naming tax (product / feature / tier naming rules plus approved and banned terms) that seeds the narrative-registry canon and that every channel''s voice adaptation points up to. Not for per-platform voice adaptation — use channel-registry''s voice-dossier; not for finished copy or blog posts — use content-writer; not for the message hierarchy itself — use message-system-architect; not for claim adjudication — use offer-claims-registry. 品牌语气/词汇表/命名税/禁用词/品牌语言规范