google-ads-audit

Google Ads account audit and business context setup. Run this first — it gathers business information, analyzes account health, and saves context that all other ads skills reuse. Trigger on "audit my ads", "ads audit", "set up my ads", "onboard", "account overview", "how's my account", "ads health check", "what should I fix in my ads", or when the user is new to NotFair and hasn't run an audit before. Also trigger proactively when other ads skills detect that business-context.json is missing.

Quality

89%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

Securityby

Low

Low-risk findings worth noting

Quality

Content

85%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

A well-architected skill body: clearly sequenced phases with validation checkpoints, lean prose that assumes competence, and clean progressive disclosure backed by real reference files. The only meaningful gap is the absence of a concrete GAQL query example for the core data pull.

Suggestions

Add one copy-paste-ready GAQL snippet (or a minimal ads.gaqlParallel runScript skeleton) to the Phase 1 dataset pull so the core query is executable rather than left to Claude's discretion.

De-duplicate the signal-failure/STOP guidance so it lives in one canonical place (the reference) and the Phase 3 / Guardrails lines point to it rather than restating the rule.

Consider trimming or linking the full business-context.json schema to references/business-context.md to keep SKILL.md as a leaner overview.

Dimension	Reasoning	Score
Conciseness	Largely lean and efficient with no padding about concepts Claude already knows, but a few points (e.g., the signal-failure/STOP condition restated across Phase 3 and Guardrails #2) are slightly redundant and could be trimmed without losing clarity.	4 / 5
Actionability	Highly actionable via exact JSON schemas, field-to-source mapping tables, and concrete file paths, but the core GAQL execution is delegated ('You decide the exact GAQL shape') without a copy-paste example, leaving a minor gap.	4 / 5
Workflow Clarity	Clear six-phase sequence with explicit validation gates and STOP conditions (signal-quality failure, critical query error), scoped-audit handling, freshness checks, and a guardrails checklist for error recovery.	5 / 5
Progressive Disclosure	SKILL.md serves as a well-organized overview with one-level-deep, clearly signaled references — all four named reference files (account-health-scoring, business-context, conversion-network-audit, persona-discovery) exist in the bundle, and detailed schemas are appropriately inline.	5 / 5
	Total	18 / 20 Passed

Description

95%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

A strong, well-structured description that clearly states what the skill does and when to trigger it with natural user phrases and proactive conditions. It is specific, distinct from sibling skills, and avoids vague fluff.

Dimension	Reasoning	Score
Specificity	Names the domain ('Google Ads account audit and business context setup') and lists several concrete actions — 'gathers business information, analyzes account health, and saves context' — with only minor coverage gaps relative to the full audit scope.	4 / 5
Completeness	Explicitly answers both 'what' (audit, business context setup, account health analysis, context persistence) and 'when' (concrete trigger phrases, 'Run this first', new-user condition, proactive business-context.json-missing condition).	5 / 5
Trigger Term Quality	Comprehensive natural-phrase coverage including synonyms ('audit my ads', 'ads audit', 'ads health check') plus plain-language variations ('set up my ads', 'how's my account', 'what should I fix in my ads').	5 / 5
Distinctiveness Conflict Risk	Clear niche as the onboarding/audit skill with distinct triggers and explicit separation from downstream skills ('/google-ads', '/google-ads-copy', '/google-ads-landing'), minimizing conflict risk.	5 / 5
	Total	19 / 20 Passed

Validation

93%

Warnings & errors only

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 15 / 16 Passed

Validation for skill structure

Criteria	Description	Result
frontmatter_unknown_keys	Unknown frontmatter key(s) found; consider removing or moving to metadata	Warning

	Total	15 / 16 Passed

Repository: nowork-studio/NotFair
Path: google-ads/audit/SKILL.md
Commit: 8d9d54b

Reviewed: 4 days ago

Table of Contents

Discovery Implementation Validation

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.