Hainrixz/claude-ads / ads
ads
UnverifiedFree-first paid advertising audit and optimization skill, focused on the 3 platforms where 95% of advertiser spend lives: Meta, Google, TikTok. Guided onboarding (/ads start) saves context once and step-by-step OAuth walkthroughs; continuous coach (/ads next) ranks Quick Wins after each audit. ~158 weighted checks with scoring, parallel agents, industry templates, and AI creative generation.
references/profile-schema.json
View on GitHub{
"$schema": "http://json-schema.org/draft-07/schema#",
"$id": "https://github.com/Hainrixz/claude-ads/blob/main/ads/references/profile-schema.json",
"title": "claude-ads user profile",
"description": "Shape of ~/.claude-ads/profile.json — persistent per-user context, platform connection state, and preferences. Read by every /ads command so the user never re-types their context. Written by /ads start and /ads start edit.",
"type": "object",
"additionalProperties": false,
"required": ["version", "created_at", "updated_at", "context", "connections", "zernio", "preferences"],
"properties": {
"version": {
"type": "string",
"const": "1.0",
"description": "Schema version. Bumped on breaking shape changes."
},
"created_at": {
"type": "string",
"format": "date-time",
"description": "ISO-8601 UTC timestamp profile was first initialized."
},
"updated_at": {
"type": "string",
"format": "date-time",
"description": "ISO-8601 UTC timestamp of the most recent write."
},
"context": {
"type": "object",
"description": "Business context. Asked once during /ads start, reused on every audit / plan / creative run.",
"additionalProperties": false,
"properties": {
"industry": {
"type": ["string", "null"],
"enum": [null, "ecommerce", "local-service", "real-estate", "healthcare", "finance", "agency", "other"]
},
"monthly_spend_usd": {
"type": ["number", "null"],
"minimum": 0,
"description": "Approximate USD monthly ad spend across all platforms combined."
},
"primary_goal": {
"type": ["string", "null"],
"enum": [null, "sales", "leads", "app-installs", "calls", "brand"]
},
"active_platforms": {
"type": "array",
"items": { "type": "string", "enum": ["meta", "google", "tiktok"] },
"uniqueItems": true,
"default": []
}
}
},
"connections": {
"type": "object",
"description": "Per-platform connection state. Populated by /ads start's per-platform wizard.",
"additionalProperties": false,
"required": ["meta", "google", "tiktok"],
"properties": {
"meta": { "$ref": "#/definitions/platformConnection" },
"google": { "$ref": "#/definitions/platformConnection" },
"tiktok": { "$ref": "#/definitions/platformConnection" }
}
},
"zernio": {
"type": "object",
"description": "Zernio publishing state (for /ads publish). Optional — only set if user opts in.",
"additionalProperties": false,
"properties": {
"signed_up": { "type": "boolean", "default": false },
"api_key_present": { "type": "boolean", "default": false, "description": "True if ZERNIO_API_KEY env var is set. The key itself is NEVER stored in the profile." },
"connected_socials": { "type": "array", "items": { "type": "string" }, "default": [] }
}
},
"preferences": {
"type": "object",
"additionalProperties": false,
"properties": {
"default_audit_depth": { "type": "string", "enum": ["quick", "default", "deep"], "default": "default" },
"report_format": { "type": "string", "enum": ["pdf", "md"], "default": "md" },
"language": { "type": "string", "enum": ["en", "es"], "default": "en" }
}
},
"last_command": { "type": ["string", "null"], "description": "Last /ads command the user ran." },
"last_command_at": { "type": ["string", "null"], "format": "date-time" }
},
"definitions": {
"platformConnection": {
"type": "object",
"additionalProperties": false,
"properties": {
"tier": {
"type": ["string", "null"],
"enum": [null, "mcp_claude_ai", "mcp_brijr", "mcp_cohnen", "mcp_adsmcp", "direct_api", "manual", "skipped"],
"description": "Which Capa (tier) the user is using for this platform. mcp_* values reflect the specific community MCP server picked."
},
"ad_account_id": { "type": ["string", "null"], "description": "Platform-native account ID (e.g., act_123456789 for Meta, 123-456-7890 for Google, 7234... for TikTok)." },
"connected_at": { "type": ["string", "null"], "format": "date-time" },
"last_verified_at": { "type": ["string", "null"], "format": "date-time", "description": "Most recent successful test-call timestamp. /ads start sets this after each verification step." }
}
}
}
}
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| rea-analysis-optimizationmorluto/reaOptimize REA providers and shared analysis workflows for agent context, latency, CPU, and memory while preserving correctness and Evidence. Use for analysis bottlenecks and cache or query design; CI/test-suite optimization belongs to rea-ci-tests-audit. | Stars: 472k | Updated | Claude CodeCodex | Verified | Install |
| rea-ci-tests-auditmorluto/reaAudit REA CI and test suites for correctness, fixture drift, false passes, and measured performance; use for suite or workflow investigations and efficiency changes, rather than ordinary feature testing or a single test failure. | Stars: 472k | Updated | Claude CodeCodex | Verified | Install |
| rea-tool-designmorluto/reaAudit, investigate, design, or change REA investigation tools, CLI/MCP contracts, provider capabilities, and Evidence semantics. | Stars: 472k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-auditDietrichGebert/ponytailQuality audit of the whole repo: bugs, security, real load, missing tests, speed, and what to delete. Most important first. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |