Skip to content

aiskillstore/marketplace / skills/aaron-he-zhu/fatigue-frequency-manager

fatigue-frequency-manager

Verified

Use when the user asks to "is my ad fatiguing", "why is CTR dropping at scale", or "should I rotate creative / widen the audience"; reads frequency, CTR and CVR decay against an early-flight baseline and returns Rotate-creative / Widen-audience / Hold triggers with a per-ad-set fatigue read. Not for building the replacement creative — use ad-creative-builder; not for the RQS score or vetoes — use ad-account-auditor. 广告疲劳检测/频次管理/换素材还是扩人群

FileKindSize
SKILL.mdskill md10.9 KB
skill-report.jsonconfig36.2 KB

skill-report.json

View on GitHub
{
  "schema_version": "2.0",
  "meta": {
    "generated_at": "2026-07-26T10:19:45.335Z",
    "slug": "aaron-he-zhu-fatigue-frequency-manager",
    "source_url": "https://github.com/aaron-he-zhu/aaron-marketing-skills/tree/main/ad/scale/fatigue-frequency-manager",
    "source_ref": "main",
    "model": "claude",
    "analysis_version": "3.0.0",
    "source_type": "community",
    "content_hash": "ee2ac43b790049683d2fbe03246f26358924aef7f4b2e6c1dcb7b62a2bbbaa8e",
    "tree_hash": "9dc4c433a0eb8f5a7fcfe8d88191295cccabb3d8dd587893bfc8e1336be0c3de",
    "provenance": {
      "model_effective": "claude",
      "fallback_chain": [
        {
          "agent": "codex",
          "outcome": "failed",
          "error": "2026-07-26T10:19:45.443124Z ERROR codex_models_manager::manager: failed to refresh available models: Missing environment variable: `HELM_API_KEY`.\n2026-07-26T10:19:45.477243Z ERROR codex_models_manage…"
        },
        {
          "agent": "claude",
          "outcome": "success"
        }
      ],
      "analysis_version": "3.0.0"
    },
    "upstream_version_raw": "19.0.0",
    "upstream_version_normalized": "19.0.0",
    "upstream_version_source": "metadata.version",
    "upstream_version_status": "not_bumped",
    "upstream_commit_sha": "49c026d9d90630ed187fbce5c7f7f84ff4710d85"
  },
  "skill": {
    "name": "fatigue-frequency-manager",
    "description": "Analyze paid campaign frequency, CTR, CVR, and reach trends to distinguish creative fatigue from audience saturation and recommend one next action.",
    "summary": "Diagnose ad fatigue and choose rotate, widen, or hold.",
    "icon": "📦",
    "version": "19.0.0",
    "author": "aaron-he-zhu",
    "license": "Apache-2.0",
    "tags": [
      "paid advertising",
      "creative fatigue",
      "frequency management",
      "campaign analytics",
      "ROAS"
    ],
    "supported_tools": [
      "claude",
      "codex",
      "claude-code"
    ],
    "risk_factors": [
      "external_commands",
      "network",
      "filesystem"
    ],
    "category": "data"
  },
  "security_audit": {
    "risk_level": "safe",
    "is_blocked": false,
    "safe_to_publish": true,
    "analysis_status": "ok",
    "summary": "Most static findings are false positives caused by Markdown formatting, fixed documentation links, and metadata URLs. One command template is confirmed: it places a user-controlled ad-set placeholder directly in a shell command, creating a command-injection risk if executed literally. The skill otherwise instructs agents to treat campaign exports as untrusted data and requires confirmation before saving results.",
    "remediation": [
      {
        "issue": "User-controlled ad-set text is embedded in a shell command example.",
        "suggestion": "Replace the shell template with a tool call or a safely quoted argument list. Validate ad-set identifiers against an allowlist before invoking ledger.py.",
        "severity": "high"
      }
    ],
    "risk_factor_evidence": [
      {
        "factor": "external_commands",
        "evidence": [
          {
            "file": "SKILL.md",
            "line_start": 18,
            "line_end": 18
          },
          {
            "file": "SKILL.md",
            "line_start": 22,
            "line_end": 26
          },
          {
            "file": "SKILL.md",
            "line_start": 26,
            "line_end": 30
          },
          {
            "file": "SKILL.md",
            "line_start": 30,
            "line_end": 33
          },
          {
            "file": "SKILL.md",
            "line_start": 33,
            "line_end": 34
          },
          {
            "file": "SKILL.md",
            "line_start": 34,
            "line_end": 34
          },
          {
            "file": "SKILL.md",
            "line_start": 36,
            "line_end": 46
          },
          {
            "file": "SKILL.md",
            "line_start": 46,
            "line_end": 47
          },
          {
            "file": "SKILL.md",
            "line_start": 47,
            "line_end": 48
          },
          {
            "file": "SKILL.md",
            "line_start": 48,
            "line_end": 57
          },
          {
            "file": "SKILL.md",
            "line_start": 57,
            "line_end": 57
          },
          {
            "file": "SKILL.md",
            "line_start": 75,
            "line_end": 75
          },
          {
            "file": "SKILL.md",
            "line_start": 79,
            "line_end": 81
          },
          {
            "file": "SKILL.md",
            "line_start": 81,
            "line_end": 93
          }
        ]
      },
      {
        "factor": "network",
        "evidence": [
          {
            "file": "SKILL.md",
            "line_start": 10,
            "line_end": 10
          },
          {
            "file": "SKILL.md",
            "line_start": 13,
            "line_end": 13
          }
        ]
      },
      {
        "factor": "filesystem",
        "evidence": [
          {
            "file": "SKILL.md",
            "line_start": 40,
            "line_end": 40
          },
          {
            "file": "SKILL.md",
            "line_start": 44,
            "line_end": 44
          },
          {
            "file": "SKILL.md",
            "line_start": 54,
            "line_end": 54
          },
          {
            "file": "SKILL.md",
            "line_start": 62,
            "line_end": 62
          },
          {
            "file": "SKILL.md",
            "line_start": 63,
            "line_end": 63
          },
          {
            "file": "SKILL.md",
            "line_start": 75,
            "line_end": 75
          },
          {
            "file": "SKILL.md",
            "line_start": 79,
            "line_end": 79
          },
          {
            "file": "SKILL.md",
            "line_start": 80,
            "line_end": 80
          },
          {
            "file": "SKILL.md",
            "line_start": 81,
            "line_end": 81
          },
          {
            "file": "SKILL.md",
            "line_start": 82,
            "line_end": 82
          },
          {
            "file": "SKILL.md",
            "line_start": 88,
            "line_end": 88
          },
          {
            "file": "SKILL.md",
            "line_start": 89,
            "line_end": 89
          },
          {
            "file": "SKILL.md",
            "line_start": 90,
            "line_end": 90
          },
          {
            "file": "SKILL.md",
            "line_start": 93,
            "line_end": 93
          }
        ]
      }
    ],
    "static_findings": [
      {
        "id": "external_commands:SKILL.md:18:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 18,
        "line_end": 18,
        "snippet": "Reads a scaling ad set for **creative fatigue** and **audience saturation** — rising frequency, deca"
      },
      {
        "id": "external_commands:SKILL.md:22:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 22,
        "line_end": 26,
        "snippet": "```text"
      },
      {
        "id": "external_commands:SKILL.md:26:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 26,
        "line_end": 30,
        "snippet": "```"
      },
      {
        "id": "external_commands:SKILL.md:30:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 30,
        "line_end": 33,
        "snippet": "**Expected output**: a per-ad-set fatigue read — frequency now vs baseline, CTR and CVR decay slope "
      },
      {
        "id": "external_commands:SKILL.md:33:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 33,
        "line_end": 34,
        "snippet": "- **Writes**: a user-facing fatigue table plus a reusable summary storable under `memory/ad/fatigue-"
      },
      {
        "id": "external_commands:SKILL.md:34:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 34,
        "line_end": 34,
        "snippet": "- **Promotes**: confirmed Rotate/Widen triggers, the frequency/decay thresholds used, and any measur"
      },
      {
        "id": "external_commands:SKILL.md:36:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 36,
        "line_end": 46,
        "snippet": "- **Primary next skill**: use the `Next Best Skill` below."
      },
      {
        "id": "external_commands:SKILL.md:46:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 46,
        "line_end": 47,
        "snippet": "- `~~ad platform` (own data) — campaign / ad-set time-series report CSV from the native ad manager: "
      },
      {
        "id": "external_commands:SKILL.md:47:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 47,
        "line_end": 48,
        "snippet": "- `~~web analytics` (GA4) — Conversions + Traffic-acquisition export to read CVR from the order-ID t"
      },
      {
        "id": "external_commands:SKILL.md:48:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 48,
        "line_end": 57,
        "snippet": "- `~~ecommerce` — store export (orders, revenue) to confirm the conversion side when CVR movement is"
      },
      {
        "id": "external_commands:SKILL.md:57:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 57,
        "line_end": 57,
        "snippet": "2. **Build the trend, not a snapshot.** Read frequency, CTR, and CVR as a slope from baseline to now"
      },
      {
        "id": "external_commands:SKILL.md:75:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 75,
        "line_end": 75,
        "snippet": "Ask \"Save these results?\" If yes, write to `memory/ad/fatigue-frequency-manager/` using `YYYY-MM-DD-"
      },
      {
        "id": "external_commands:SKILL.md:79:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 79,
        "line_end": 81,
        "snippet": "- [ROAS Benchmark](../../../references/roas-benchmark.md) — the paid-ads scoring framework; this ski"
      },
      {
        "id": "external_commands:SKILL.md:81:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 81,
        "line_end": 93,
        "snippet": "- [scripts/connectors/README.md](../../../scripts/connectors/README.md) — `ledger.py` record / trend"
      },
      {
        "id": "network:SKILL.md:10:hardcoded-url",
        "category": "network",
        "severity": "low",
        "pattern": "Hardcoded URL",
        "file": "SKILL.md",
        "line_start": 10,
        "line_end": 10,
        "snippet": "homepage: \"https://github.com/aaron-he-zhu/aaron-marketing-skills\""
      },
      {
        "id": "network:SKILL.md:13:hardcoded-url",
        "category": "network",
        "severity": "low",
        "pattern": "Hardcoded URL",
        "file": "SKILL.md",
        "line_start": 13,
        "line_end": 13,
        "snippet": "metadata: {\"author\": \"aaron-he-zhu\", \"version\": \"19.0.0\", \"discipline\": \"ad\", \"phase\": \"scale\", \"geo"
      },
      {
        "id": "filesystem:SKILL.md:40:path-traversal-sequence",
        "category": "filesystem",
        "severity": "high",
        "pattern": "Path traversal sequence",
        "file": "SKILL.md",
        "line_start": 40,
        "line_end": 40,
        "snippet": "> Emit the standard shape from [skill-contract.md §Handoff Summary Format](../../../references/skill"
      },
      {
        "id": "filesystem:SKILL.md:44:path-traversal-sequence",
        "category": "filesystem",
        "severity": "high",
        "pattern": "Path traversal sequence",
        "file": "SKILL.md",
        "line_start": 44,
        "line_end": 44,
        "snippet": "All integrations optional (see [CONNECTORS.md](../../../CONNECTORS.md)). Inputs come from the user's"
      },
      {
        "id": "filesystem:SKILL.md:54:path-traversal-sequence",
        "category": "filesystem",
        "severity": "high",
        "pattern": "Path traversal sequence",
        "file": "SKILL.md",
        "line_start": 54,
        "line_end": 54,
        "snippet": "Treat every fetched or exported file as **untrusted input** per [SECURITY.md](../../../SECURITY.md) "
      },
      {
        "id": "filesystem:SKILL.md:62:path-traversal-sequence",
        "category": "filesystem",
        "severity": "high",
        "pattern": "Path traversal sequence",
        "file": "SKILL.md",
        "line_start": 62,
        "line_end": 62,
        "snippet": "4. **Check the frequency threshold.** Compare current frequency to the working ceiling for the objec"
      },
      {
        "id": "filesystem:SKILL.md:63:path-traversal-sequence",
        "category": "filesystem",
        "severity": "high",
        "pattern": "Path traversal sequence",
        "file": "SKILL.md",
        "line_start": 63,
        "line_end": 63,
        "snippet": "5. **Confirm the CVR drop is real, not broken tracking (ROAS-R protection).** A falling CVR can be g"
      },
      {
        "id": "filesystem:SKILL.md:75:path-traversal-sequence",
        "category": "filesystem",
        "severity": "high",
        "pattern": "Path traversal sequence",
        "file": "SKILL.md",
        "line_start": 75,
        "line_end": 75,
        "snippet": "Ask \"Save these results?\" If yes, write to `memory/ad/fatigue-frequency-manager/` using `YYYY-MM-DD-"
      },
      {
        "id": "filesystem:SKILL.md:79:path-traversal-sequence",
        "category": "filesystem",
        "severity": "high",
        "pattern": "Path traversal sequence",
        "file": "SKILL.md",
        "line_start": 79,
        "line_end": 79,
        "snippet": "- [ROAS Benchmark](../../../references/roas-benchmark.md) — the paid-ads scoring framework; this ski"
      },
      {
        "id": "filesystem:SKILL.md:80:path-traversal-sequence",
        "category": "filesystem",
        "severity": "high",
        "pattern": "Path traversal sequence",
        "file": "SKILL.md",
        "line_start": 80,
        "line_end": 80,
        "snippet": "- [Measurement & Attribution Protocol](../../../references/measurement-protocol.md) — baseline windo"
      },
      {
        "id": "filesystem:SKILL.md:81:path-traversal-sequence",
        "category": "filesystem",
        "severity": "high",
        "pattern": "Path traversal sequence",
        "file": "SKILL.md",
        "line_start": 81,
        "line_end": 81,
        "snippet": "- [scripts/connectors/README.md](../../../scripts/connectors/README.md) — `ledger.py` record / trend"
      },
      {
        "id": "filesystem:SKILL.md:82:path-traversal-sequence",
        "category": "filesystem",
        "severity": "high",
        "pattern": "Path traversal sequence",
        "file": "SKILL.md",
        "line_start": 82,
        "line_end": 82,
        "snippet": "- [ad-creative-builder](../../orchestrate/ad-creative-builder/SKILL.md) — builds the replacement cre"
      },
      {
        "id": "filesystem:SKILL.md:88:path-traversal-sequence",
        "category": "filesystem",
        "severity": "high",
        "pattern": "Path traversal sequence",
        "file": "SKILL.md",
        "line_start": 88,
        "line_end": 88,
        "snippet": "- **Rotate-creative fired** → [ad-creative-builder](../../orchestrate/ad-creative-builder/SKILL.md) "
      },
      {
        "id": "filesystem:SKILL.md:89:path-traversal-sequence",
        "category": "filesystem",
        "severity": "high",
        "pattern": "Path traversal sequence",
        "file": "SKILL.md",
        "line_start": 89,
        "line_end": 89,
        "snippet": "- **Widen-audience fired** → [audience-segment-builder](../../research/audience-segment-builder/SKIL"
      },
      {
        "id": "filesystem:SKILL.md:90:path-traversal-sequence",
        "category": "filesystem",
        "severity": "high",
        "pattern": "Path traversal sequence",
        "file": "SKILL.md",
        "line_start": 90,
        "line_end": 90,
        "snippet": "- **A measurement-signal risk was flagged (ROAS-R1/R2)** → stop and route to [ad-account-auditor](.."
      },
      {
        "id": "filesystem:SKILL.md:93:path-traversal-sequence",
        "category": "filesystem",
        "severity": "high",
        "pattern": "Path traversal sequence",
        "file": "SKILL.md",
        "line_start": 93,
        "line_end": 93,
        "snippet": "Visited-set and `max-depth: 3` termination rules apply per [Skill Contract](../../../references/skil"
      },
      {
        "id": "blocker:SKILL.md:11:system-reconnaissance",
        "category": "blocker",
        "severity": "low",
        "pattern": "System reconnaissance",
        "file": "SKILL.md",
        "line_start": 11,
        "line_end": 11,
        "snippet": "when_to_use: \"Use when a scaled paid campaign shows rising frequency or falling CTR/CVR and the user"
      },
      {
        "id": "blocker:SKILL.md:57:system-reconnaissance",
        "category": "blocker",
        "severity": "low",
        "pattern": "System reconnaissance",
        "file": "SKILL.md",
        "line_start": 57,
        "line_end": 57,
        "snippet": "2. **Build the trend, not a snapshot.** Read frequency, CTR, and CVR as a slope from baseline to now"
      }
    ],
    "finding_verdicts": [
      {
        "id": "external_commands:SKILL.md:18:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.96,
        "reason": "This detection is Markdown inline or fenced-code formatting, not Ruby or shell backtick execution. No executable command is present at this location."
      },
      {
        "id": "external_commands:SKILL.md:22:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.96,
        "reason": "This detection is Markdown inline or fenced-code formatting, not Ruby or shell backtick execution. No executable command is present at this location."
      },
      {
        "id": "external_commands:SKILL.md:26:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.96,
        "reason": "This detection is Markdown inline or fenced-code formatting, not Ruby or shell backtick execution. No executable command is present at this location."
      },
      {
        "id": "external_commands:SKILL.md:30:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.96,
        "reason": "This detection is Markdown inline or fenced-code formatting, not Ruby or shell backtick execution. No executable command is present at this location."
      },
      {
        "id": "external_commands:SKILL.md:33:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.96,
        "reason": "This detection is Markdown inline or fenced-code formatting, not Ruby or shell backtick execution. No executable command is present at this location."
      },
      {
        "id": "external_commands:SKILL.md:34:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.96,
        "reason": "This detection is Markdown inline or fenced-code formatting, not Ruby or shell backtick execution. No executable command is present at this location."
      },
      {
        "id": "external_commands:SKILL.md:36:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.96,
        "reason": "This detection is Markdown inline or fenced-code formatting, not Ruby or shell backtick execution. No executable command is present at this location."
      },
      {
        "id": "external_commands:SKILL.md:46:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.96,
        "reason": "This detection is Markdown inline or fenced-code formatting, not Ruby or shell backtick execution. No executable command is present at this location."
      },
      {
        "id": "external_commands:SKILL.md:47:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.96,
        "reason": "This detection is Markdown inline or fenced-code formatting, not Ruby or shell backtick execution. No executable command is present at this location."
      },
      {
        "id": "external_commands:SKILL.md:48:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.96,
        "reason": "This detection is Markdown inline or fenced-code formatting, not Ruby or shell backtick execution. No executable command is present at this location."
      },
      {
        "id": "external_commands:SKILL.md:57:ruby-shell-backtick-execution",
        "verdict": "confirmed",
        "confidence": 0.88,
        "severity": "high",
        "reason": "The command example interpolates the ad-set placeholder into a shell command without showing argument quoting or validation. A user-controlled ad-set value could alter command execution if an agent runs the instruction literally."
      },
      {
        "id": "external_commands:SKILL.md:75:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.96,
        "reason": "This detection is Markdown inline or fenced-code formatting, not Ruby or shell backtick execution. No executable command is present at this location."
      },
      {
        "id": "external_commands:SKILL.md:79:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.96,
        "reason": "This detection is Markdown inline or fenced-code formatting, not Ruby or shell backtick execution. No executable command is present at this location."
      },
      {
        "id": "external_commands:SKILL.md:81:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.96,
        "reason": "This detection is Markdown inline or fenced-code formatting, not Ruby or shell backtick execution. No executable command is present at this location."
      },
      {
        "id": "network:SKILL.md:10:hardcoded-url",
        "verdict": "false_positive",
        "confidence": 0.98,
        "reason": "The URL is repository metadata only. The skill contains no instruction or code that sends data or makes a network request to it."
      },
      {
        "id": "network:SKILL.md:13:hardcoded-url",
        "verdict": "false_positive",
        "confidence": 0.98,
        "reason": "The URL is repository metadata only. The skill contains no instruction or code that sends data or makes a network request to it."
      },
      {
        "id": "filesystem:SKILL.md:40:path-traversal-sequence",
        "verdict": "false_positive",
        "confidence": 0.97,
        "reason": "The relative path is a fixed documentation link or a fixed, user-confirmed memory destination. It is not constructed from untrusted input and does not demonstrate path traversal."
      },
      {
        "id": "filesystem:SKILL.md:44:path-traversal-sequence",
        "verdict": "false_positive",
        "confidence": 0.97,
        "reason": "The relative path is a fixed documentation link or a fixed, user-confirmed memory destination. It is not constructed from untrusted input and does not demonstrate path traversal."
      },
      {
        "id": "filesystem:SKILL.md:54:path-traversal-sequence",
        "verdict": "false_positive",
        "confidence": 0.97,
        "reason": "The relative path is a fixed documentation link or a fixed, user-confirmed memory destination. It is not constructed from untrusted input and does not demonstrate path traversal."
      },
      {
        "id": "filesystem:SKILL.md:62:path-traversal-sequence",
        "verdict": "false_positive",
        "confidence": 0.97,
        "reason": "The relative path is a fixed documentation link or a fixed, user-confirmed memory destination. It is not constructed from untrusted input and does not demonstrate path traversal."
      },
      {
        "id": "filesystem:SKILL.md:63:path-traversal-sequence",
        "verdict": "false_positive",
        "confidence": 0.97,
        "reason": "The relative path is a fixed documentation link or a fixed, user-confirmed memory destination. It is not constructed from untrusted input and does not demonstrate path traversal."
      },
      {
        "id": "filesystem:SKILL.md:75:path-traversal-sequence",
        "verdict": "false_positive",
        "confidence": 0.97,
        "reason": "The relative path is a fixed documentation link or a fixed, user-confirmed memory destination. It is not constructed from untrusted input and does not demonstrate path traversal."
      },
      {
        "id": "filesystem:SKILL.md:79:path-traversal-sequence",
        "verdict": "false_positive",
        "confidence": 0.97,
        "reason": "The relative path is a fixed documentation link or a fixed, user-confirmed memory destination. It is not constructed from untrusted input and does not demonstrate path traversal."
      },
      {
        "id": "filesystem:SKILL.md:80:path-traversal-sequence",
        "verdict": "false_positive",
        "confidence": 0.97,
        "reason": "The relative path is a fixed documentation link or a fixed, user-confirmed memory destination. It is not constructed from untrusted input and does not demonstrate path traversal."
      },
      {
        "id": "filesystem:SKILL.md:81:path-traversal-sequence",
        "verdict": "false_positive",
        "confidence": 0.97,
        "reason": "The relative path is a fixed documentation link or a fixed, user-confirmed memory destination. It is not constructed from untrusted input and does not demonstrate path traversal."
      },
      {
        "id": "filesystem:SKILL.md:82:path-traversal-sequence",
        "verdict": "false_positive",
        "confidence": 0.97,
        "reason": "The relative path is a fixed documentation link or a fixed, user-confirmed memory destination. It is not constructed from untrusted input and does not demonstrate path traversal."
      },
      {
        "id": "filesystem:SKILL.md:88:path-traversal-sequence",
        "verdict": "false_positive",
        "confidence": 0.97,
        "reason": "The relative path is a fixed documentation link or a fixed, user-confirmed memory destination. It is not constructed from untrusted input and does not demonstrate path traversal."
      },
      {
        "id": "filesystem:SKILL.md:89:path-traversal-sequence",
        "verdict": "false_positive",
        "confidence": 0.97,
        "reason": "The relative path is a fixed documentation link or a fixed, user-confirmed memory destination. It is not constructed from untrusted input and does not demonstrate path traversal."
      },
      {
        "id": "filesystem:SKILL.md:90:path-traversal-sequence",
        "verdict": "false_positive",
        "confidence": 0.97,
        "reason": "The relative path is a fixed documentation link or a fixed, user-confirmed memory destination. It is not constructed from untrusted input and does not demonstrate path traversal."
      },
      {
        "id": "filesystem:SKILL.md:93:path-traversal-sequence",
        "verdict": "false_positive",
        "confidence": 0.97,
        "reason": "The relative path is a fixed documentation link or a fixed, user-confirmed memory destination. It is not constructed from untrusted input and does not demonstrate path traversal."
      },
      {
        "id": "blocker:SKILL.md:11:system-reconnaissance",
        "verdict": "false_positive",
        "confidence": 0.98,
        "reason": "The flagged wording describes campaign analysis workflow, not host or system reconnaissance. It does not collect system information."
      },
      {
        "id": "blocker:SKILL.md:57:system-reconnaissance",
        "verdict": "false_positive",
        "confidence": 0.98,
        "reason": "The flagged wording describes campaign analysis workflow, not host or system reconnaissance. It does not collect system information."
      }
    ],
    "semantic_findings": [],
    "critical_findings": [],
    "high_findings": [
      {
        "title": "Ruby/shell backtick execution",
        "description": "2. **Build the trend, not a snapshot.** Read frequency, CTR, and CVR as a slope from baseline to now",
        "locations": [
          {
            "file": "SKILL.md",
            "line_start": 57,
            "line_end": 57
          }
        ],
        "review_kind": "capability",
        "source_category": "external_commands",
        "source_severity": "medium",
        "confidence": 0.88,
        "confidence_reasoning": "The command example interpolates the ad-set placeholder into a shell command without showing argument quoting or validation. A user-controlled ad-set value could alter command execution if an agent runs the instruction literally."
      }
    ],
    "medium_findings": [],
    "low_findings": [],
    "dangerous_patterns": [],
    "files_scanned": 1,
    "total_lines": 94,
    "audit_model": "claude",
    "audited_at": "2026-07-26T10:19:45.335Z",
    "agent_auto_install_policy": "allowed",
    "manual_install_policy": "allowed"
  },
  "content": {
    "user_title": "Diagnose ad fatigue and choose the next action",
    "value_statement": "Campaign metrics can decline for different reasons, which makes budget decisions difficult. This skill compares frequency, CTR, CVR, and reach trends to recommend rotating creative, widening an audience, or holding.",
    "seo_keywords": [
      "Claude",
      "Codex",
      "Claude Code",
      "ad fatigue analysis",
      "frequency management",
      "CTR decline",
      "CVR trend analysis",
      "audience saturation",
      "creative rotation",
      "paid campaign analytics"
    ],
    "actual_capabilities": [
      "Compares current frequency, CTR, CVR, and reach with an early-flight baseline.",
      "Distinguishes creative fatigue from audience saturation using trend signals.",
      "Returns one Rotate-creative, Widen-audience, or Hold recommendation per ad set.",
      "Identifies when a short data window or learning phase prevents a reliable decision.",
      "Flags conversion measurement uncertainty before relying on CVR changes."
    ],
    "limitations": [
      "Requires a daily or weekly time-series export; a single-day snapshot is insufficient.",
      "Does not create replacement ads or build new audience segments.",
      "Does not calculate the RQS score or make final measurement veto decisions.",
      "Recommendations depend on the accuracy of the provided platform and order data."
    ],
    "use_cases": [
      {
        "title": "Review a declining prospecting campaign",
        "description": "Compare two weeks of campaign data to determine whether falling CTR requires a creative rotation or audience expansion.",
        "target_user": "Paid media manager"
      },
      {
        "title": "Set a frequency decision rule",
        "description": "Use an early-flight baseline and objective-specific ceiling to define when an ad set needs intervention.",
        "target_user": "Growth marketer"
      },
      {
        "title": "Validate a client performance report",
        "description": "Separate a real conversion decline from incomplete tracking before presenting a campaign recommendation.",
        "target_user": "Marketing analyst"
      }
    ],
    "prompt_templates": [
      {
        "title": "Check a simple fatigue signal",
        "scenario": "Beginner",
        "prompt": "Frequency reached 6.2 and CTR fell by half over two weeks. Explain whether this looks like creative fatigue or audience saturation."
      },
      {
        "title": "Review one ad set",
        "scenario": "Intermediate",
        "prompt": "Review this ad-set time series. Compare it with the first stable week and return frequency, CTR, CVR, reach trends, and one recommended trigger."
      },
      {
        "title": "Compare campaign segments",
        "scenario": "Advanced",
        "prompt": "Analyze these prospecting and retargeting ad sets separately. Use appropriate frequency ceilings, identify the dominant cause for each, and state caveats."
      },
      {
        "title": "Validate data before action",
        "scenario": "Expert",
        "prompt": "Assess this campaign export with GA4 and order totals. Do not recommend rotation or expansion if the CVR decline may be caused by tracking errors."
      }
    ],
    "output_examples": [
      {
        "input": "Prospecting frequency increased from 2.1 to 5.8, reach is still growing, and CTR declined from 1.4% to 0.7%.",
        "output": [
          "Diagnosis: Creative fatigue.",
          "Trigger: Rotate creative.",
          "Reason: Frequency increased while reach continued growing, and CTR declined against the baseline."
        ]
      },
      {
        "input": "Reach has flattened, frequency increased from 3.0 to 7.1, and CTR and CVR both declined.",
        "output": [
          "Diagnosis: Audience saturation.",
          "Trigger: Widen audience.",
          "Caveat: Confirm the CVR decline against order data before acting."
        ]
      }
    ],
    "best_practices": [
      "Provide a stable early-flight baseline and a daily or weekly metric export.",
      "Label estimates separately from exported and user-provided metrics.",
      "Verify conversion tracking with order data before acting on a CVR decline."
    ],
    "anti_patterns": [
      "Do not diagnose fatigue from a single-day dashboard snapshot.",
      "Do not use one universal frequency threshold for every campaign objective.",
      "Do not treat a CVR decline as saturation before checking tracking quality."
    ],
    "faq": [
      {
        "question": "What data should I provide?",
        "answer": "Provide daily or weekly impressions, reach, frequency, clicks or CTR, conversions or CVR, and spend for each ad set."
      },
      {
        "question": "Can the skill use a single-day export?",
        "answer": "No. It needs a time series to compare the current trend with an early-flight baseline."
      },
      {
        "question": "What is the difference between fatigue and saturation?",
        "answer": "Creative fatigue often shows falling CTR while reach still grows. Saturation often shows flat reach and increasing frequency."
      },
      {
        "question": "Does it create new ads?",
        "answer": "No. It diagnoses the issue and can recommend a creative rotation, but another skill creates the replacement ad."
      },
      {
        "question": "What happens when conversion tracking is unreliable?",
        "answer": "The skill flags the measurement risk and avoids relying on CVR for a confident trigger."
      },
      {
        "question": "Does it save campaign results automatically?",
        "answer": "No. It asks for confirmation before saving a reusable result summary."
      }
    ]
  },
  "file_structure": [
    {
      "name": "SKILL.md",
      "type": "file",
      "path": "SKILL.md",
      "lines": 94
    }
  ]
}
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: 472kUpdated Claude CodeCodexVerifiedInstall
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: 472kUpdated Claude CodeCodexVerifiedInstall
rea-tool-designmorluto/reaAudit, investigate, design, or change REA investigation tools, CLI/MCP contracts, provider capabilities, and Evidence semantics.Stars: 472kUpdated Claude CodeCodexVerifiedInstall
ponytail-auditDietrichGebert/ponytailQuality audit of the whole repo: bugs, security, real load, missing tests, speed, and what to delete. Most important first.Stars: 194kUpdated Claude CodeCodexVerifiedInstall