@raishin/vanguard-frontier-agentic 1.9.0 → 2.0.1

package/skills/marketing/marketing-maestro/references/workflow-and-output.md

@@ -0,0 +1,110 @@
+# Routing table and domain taxonomy
+
+Use this reference when classifying a task or selecting the right specialist(s).
+
+## Routing table
+
+| Signal keywords | Agent ID | Domain | Live-guard? |
+|---|---|---|---|
+| consent banner, cookie banner, CMP, consent management platform, tags fire before consent, Consent Mode, GDPR consent, ePrivacy, cookie policy, pre-ticked, reject all, dark pattern banner, tracker disclosure, cross-border transfer, consent record | marketing-consent-data-collection-review-agent | Consent and data-collection posture | No |
+| advertising pixel, Meta Pixel, TikTok pixel, Google Ads tag, LinkedIn Insight Tag, conversion event, dataLayer, PII in URL, email in query parameter, form-field capture, advanced matching, enhanced conversions, pixel on health page, PHI leakage, hashed identifier | marketing-pixel-data-leakage-review-agent | Advertising-pixel personal-data leakage | No |
+| OAuth grant, connected app, API key, integration scope, CRM role, marketing automation permission, martech access, least privilege, over-permissioned connector, stale token, refresh token, shared admin key, token rotation, bulk export permission, access review | martech-access-governance-review-agent | Martech access governance | No |
+| Global Privacy Control, GPC, opt-out signal, Do Not Sell, opt-out honored, GPC not propagated, tag bypass on opt-out, server-side opt-out, CPPA enforcement, opt-out cookie | marketing-gpc-signal-honoring-review-agent | GPC opt-out signal honoring | No |
+| SPF, DKIM, DMARC, BIMI, sender authentication, DNS TXT record, p=none, DKIM selector, SPF lookup limit, email spoofing, bulk sender, deliverability, VMC, CMC | email-sender-authentication-review-agent | Email sender authentication | No |
+| ads.txt, app-ads.txt, sellers.json, SupplyChain Object, programmatic supply chain, unauthorized reseller, domain spoofing, IVT, invalid traffic, authorized seller, DIRECT, RESELLER | programmatic-supply-chain-integrity-review-agent | Programmatic supply-chain integrity | No |
+| ad targeting, audience targeting, Advantage+, lookalike targeting, protected class, discrimination, Fair Housing, ECOA, disparate impact, targeting fairness, automated bidding bias, health-proxy segment | ai-advertising-targeting-fairness-review-agent | AI ad-targeting fairness | No |
+| EU AI Act, AI Act, high-risk AI, prohibited AI practice, AI risk tier, conformity assessment, AI system classification, Annex III, human oversight, profiling AI, fundamental-rights impact | eu-ai-act-marketing-system-review-agent | EU AI Act marketing-system classification | No |
+| custom audience, lookalike audience, audience upload, customer match, matched audience, hashing, SHA-256, MD5, field mapping, audience consent basis, data upload to ad platform | lookalike-audience-upload-compliance-review-agent | Lookalike-audience upload compliance | No |
+| email list, list hygiene, suppression list, consent record, consent timestamp, data retention, storage limitation, CASL record-keeping, list segment, last-engagement date, re-permission | marketing-email-list-retention-review-agent | Email list retention and hygiene | No |
+| influencer, creator, endorsement, material connection, disclosure, FTC Endorsement Guides, sponsored post, gifted product, #ad, disclosure placement, creator brief | influencer-disclosure-compliance-review-agent | Influencer disclosure compliance | No |
+| conversion flow, sign-up flow, upsell, free trial enrollment, cancellation flow, dark pattern, pre-checked box, false urgency, countdown timer, negative option, ROSCA, hard to cancel | marketing-conversion-flow-dark-pattern-review-agent | Conversion-flow dark patterns | No |
+| analytics config, GA4, BigQuery export, data minimization, event parameter, user property, analytics retention, user-scoped dimension, persistent user ID, raw event export | analytics-data-minimization-review-agent | Analytics data minimization | No |
+
+## Domain taxonomy
+
+| Domain | Keywords and signals |
+|---|---|
+| `consent` | CMP banner configuration, tag-manager consent gating, Consent Mode wiring, cookie policy disclosure, consent records, cross-border transfer mechanisms |
+| `pixel-leakage` | Advertising and social pixels, conversion event payloads, `dataLayer` values, URL-parameter PII, form-field auto-capture, pixels on sensitive pages, identifier hashing |
+| `access-governance` | OAuth connected apps and scopes, API keys, CRM and marketing-automation roles, shared and stale credentials, token rotation, integration ownership, bulk-export spread |
+| `gpc` | Global Privacy Control signal path, opt-out propagation to tag execution, server-side conversion-API bypass, pre-existing-GPC handling |
+| `email-auth` | SPF, DKIM, DMARC, BIMI DNS records, policy enforcement level, alignment, SPF lookup limits, ESP subdomain authentication |
+| `supply-chain` | ads.txt and app-ads.txt entries, sellers.json records, SupplyChain Object, authorized resellers, domain-spoofing exposure, invalid-traffic risk |
+| `targeting-fairness` | Ad-platform audience targeting, AI delivery optimization, protected-class proxies, disparate impact, Fair Housing and ECOA exposure |
+| `ai-act` | EU AI Act risk-tier classification, prohibited practices, high-risk Annex III triggers, human-oversight adequacy, profiling, conformity assessment |
+| `audience-upload` | Custom and lookalike audience uploads, hashing adequacy, PII field scope, consent basis for the seed list, platform data-sharing restrictions |
+| `list-retention` | Email list segment metadata, consent-record completeness, suppression-list coverage, retention schedules, storage limitation |
+| `influencer` | Influencer campaign briefs and contracts, material-connection disclosure, disclosure placement and conspicuousness, honest-opinion suppression |
+| `conversion-dark-patterns` | Sign-up, upsell, trial-enrollment and cancellation flows, pre-checked options, asymmetric accept/decline weight, false urgency, negative-option cancellation friction |
+| `analytics-minimization` | Analytics platform schema, event parameters, user properties, raw-data export configuration, data-retention periods, internal collection scope |
+
+## Dispatch examples
+
+### Example 1: Single-domain question
+
+**User request:** "Does our DMARC record actually block spoofed mail, or is it just monitoring?"
+
+**Routing:**
+```
+Route: email-sender-authentication-review-agent
+Reason: Task is a pure sender-authentication question about DMARC enforcement posture — single email-auth domain.
+Mode: single
+```
+
+`email-sender-authentication-review-agent` reviews the DNS records and reports whether the DMARC policy enforces or only monitors.
+
+---
+
+### Example 2: Two domains in parallel
+
+**User request:** "Check whether our opt-out signal actually stops the pixels, and review our cookie banner for dark patterns."
+
+**Routing:**
+```
+Route: marketing-gpc-signal-honoring-review-agent, marketing-consent-data-collection-review-agent
+Reason: Task spans GPC opt-out signal propagation and consent-banner design — two distinct governance domains.
+Mode: parallel (2)
+```
+
+---
+
+### Example 3: Multi-domain posture review (ceiling enforced)
+
+**User request:** "Full audit: consent banner, pixel leakage, who has CRM access, and whether our audience uploads are hashed correctly."
+
+**Routing:**
+```
+Route: marketing-consent-data-collection-review-agent, marketing-pixel-data-leakage-review-agent, martech-access-governance-review-agent, lookalike-audience-upload-compliance-review-agent
+Reason: Task spans four distinct governance domains — consent, pixel leakage, access governance, and audience-upload compliance.
+Mode: parallel (4)
+```
+
+Four specialists is the hard ceiling. If a request implies more than four domains, dispatch the four highest-risk and tell the caller which domains were deferred to a follow-up.
+
+---
+
+### Refused request: live mutation
+
+**User request:** "Revoke the SurveyTool OAuth grant and republish the tag container with the GPC fix."
+
+**Routing:**
+```
+Route: REFUSED
+Reason: This request requires live writes — an OAuth revocation and a tag-container publish. No live-guard agents exist in v1. Escalate to a human operator.
+Mode: N/A
+```
+
+No agent in this provider executes mutations. Specialists produce the scoped recommendation; the human operator applies it.
+
+---
+
+## Provenance label protocol
+
+Every value produced by a routed specialist must carry one of these labels:
+
+| Label | Meaning |
+|---|---|
+| `live-evidence` | Observed in the sanitized configuration or artifact the user provided in this session |
+| `documentation-based` | Sourced from official regulation or platform documentation |
+| `inference` | Derived by the specialist from inputs using documented methodology |
+| `excluded` | Data intentionally excluded from the output, and why |

package/skills/marketing/marketing-pixel-data-leakage-review/SKILL.md

@@ -0,0 +1,43 @@
+---
+name: marketing-pixel-data-leakage-review
+description: Use this skill when reviewing advertising pixels and event-tracking for personal-data leakage to third-party ad networks. Trigger when a user provides a tag-manager container, a Meta/TikTok/Google/LinkedIn pixel snippet, a conversion-event payload, a dataLayer specification, or asks whether their tracking pixels leak email, phone numbers, health, or financial data to ad platforms, or whether pixels on sensitive pages create a breach or HIPAA exposure.
+allowed-tools: Read Grep Glob
+metadata:
+  author: "github: Raishin"
+  version: "0.1.0"
+  updated: "2026-05-17"
+  category: security
+  lifecycle: experimental
+---
+
+# Marketing Pixel Data-Leakage Review
+
+## Purpose
+This skill reviews advertising pixels and conversion event tracking for unintended exfiltration of personal data to third-party ad networks. Marketing pixels are an attacker-irrelevant but regulator-relevant data path: a pixel that captures an email in a URL parameter, auto-collects form fields, or sits on a health or financial page silently transmits identifiable data to Meta, TikTok, Google, or LinkedIn with no contract, no consent scope, and no breach visibility. This pattern has produced large HIPAA settlements, FTC Health Breach Notification Rule actions, and wiretap class actions. The review catches PII in event payloads, form-field auto-capture, pixels on sensitive-context pages, unhashed identifier transmission, and missing data-redaction controls before they ship.
+
+## Lean operating rules
+- Treat raw email address, phone number, full name, or government identifier sent to an ad network in a URL query parameter, event parameter, or `dataLayer` value as HIGH — this is uncontracted disclosure of personal data to a third party.
+- Treat tag-manager or pixel features that auto-collect form field values (advanced/automatic matching, form-input listeners, generic "form submit" variables capturing field contents) as HIGH — they capture whatever the user typed, including sensitive fields.
+- Treat any advertising or social pixel present on a health, medical, financial, legal, or other special-category page (symptom checkers, patient portals, loan applications, insurance quotes) as HIGH — page context alone reveals special-category data.
+- Treat advertising pixels on authenticated/post-login pages that carry account or transaction context as HIGH — the URL and page state themselves leak personal circumstances.
+- Treat identifiers sent to ad networks without SHA-256 hashing where the platform's API requires hashing as HIGH — and note that hashing reduces but does not eliminate the disclosure.
+- Treat URL query strings containing PII forwarded verbatim into pixel page-view events as HIGH — strip or redact before the pixel reads `location`.
+- Flag conversion values transmitting precise revenue, order contents, or account balances when only a conversion flag is needed as MEDIUM.
+- Flag pixels loaded before the consent signal as MEDIUM here and defer the full consent-gating analysis to `marketing-consent-data-collection-review`.
+- Flag the absence of a documented redaction or allowlist layer between the page and ad pixels as MEDIUM.
+- Do not recommend removing a pixel without naming the conversion measurement it supports and the attribution loss.
+- Label every finding with evidence basis: payload provided, container provided, documentation-based, or inference from missing config.
+
+## References
+Load these only when needed:
+- [Workflow and output contract](references/workflow-and-output.md) — use when executing the full review or formatting the final answer.
+
+## Response minimum
+Return, at minimum:
+- PII-in-payload findings (URL params, event params, dataLayer values)
+- Form-field auto-capture assessment
+- Sensitive-context page assessment (health, financial, legal, authenticated)
+- Identifier handling assessment (hashing, redaction, allowlist)
+- Conversion-payload minimization findings
+- Severity-labelled finding list (critical / high / medium / low)
+- Safe next actions

package/skills/marketing/marketing-pixel-data-leakage-review/metadata.json

@@ -0,0 +1,21 @@
+{
+  "id": "marketing-pixel-data-leakage-review",
+  "name": "Marketing Pixel Data-Leakage Review",
+  "type": "skill",
+  "provider": "marketing",
+  "harnesses": ["codex", "claude-code", "cursor", "gemini", "kiro", "other"],
+  "summary": "Review advertising pixels and conversion event tracking for personal-data leakage to ad networks — PII in payloads, form-field auto-capture, pixels on sensitive pages, and unhashed identifier transmission.",
+  "source_type": "original",
+  "official_docs": [
+    "https://www.hhs.gov/hipaa/for-professionals/privacy/guidance/hipaa-online-tracking/index.html",
+    "https://www.ftc.gov/legal-library/browse/rules/health-breach-notification-rule",
+    "https://developers.facebook.com/docs/meta-pixel/",
+    "https://support.google.com/google-ads/answer/9888656",
+    "https://owasp.org/www-project-top-ten/"
+  ],
+  "security_notes": "Advertising pixels that capture email, phone, health, or financial data transmit personal data to third-party ad networks with no contract, no consent scope, and no breach visibility — a pattern behind major HIPAA settlements, FTC Health Breach Notification Rule actions, and wiretap class actions. Review works from sanitized payloads and container exports only; never request real visitor data or ad-platform credentials.",
+  "last_verified": "2026-05-17",
+  "path": "skills/marketing/marketing-pixel-data-leakage-review",
+  "author": "github: Raishin",
+  "version": "0.1.0"
+}

package/skills/marketing/marketing-pixel-data-leakage-review/references/workflow-and-output.md

@@ -0,0 +1,129 @@
+# Workflow and Output Contract
+
+## Workflow
+
+### Step 1 — Collect inputs
+
+Ask the user to provide one or more of the following as sanitized exports (replace real values with placeholders; no real visitor data, no ad-platform credentials):
+- Tag manager container export showing pixels, triggers, and the variables they read
+- Pixel snippets (Meta Pixel, TikTok Pixel, Google Ads / floodlight, LinkedIn Insight Tag, etc.)
+- A representative conversion or page-view event payload (the parameters actually sent)
+- The `dataLayer` specification or a sample `dataLayer` push
+- The list of page types the pixels load on, especially any sensitive-context pages
+- Whether advanced/automatic matching is enabled on any pixel
+
+If the user provides only a partial set, note which sections are absent and scope findings accordingly.
+
+### Step 2 — Page-context classification
+
+Classify the pages each pixel loads on before inspecting payloads. Context alone can be the leak:
+- **Special-category context**: health/medical, mental health, reproductive, financial hardship, loan/credit, legal, sexual orientation, religious, immigration.
+- **Authenticated context**: post-login account, transaction, order-history, or profile pages.
+- **General marketing context**: homepage, blog, top-of-funnel landing pages.
+
+Any advertising or social pixel firing in a special-category or authenticated context is HIGH on context alone — the URL, referrer, and page title reveal the person's circumstances regardless of payload contents.
+
+### Step 3 — Payload PII audit
+
+Inspect every parameter the pixel transmits. Flag direct identifiers and quasi-identifiers:
+
+```text
+# HIGH — raw email in the page URL, forwarded into the pixel page-view event
+https://example.com/welcome?email=jane.doe@example.com
+Meta Pixel: track('PageView')   # pixel reads location.href → email leaves the page
+
+# HIGH — PII pushed into dataLayer and mapped to event parameters
+dataLayer.push({ event: 'signup', user_email: 'jane.doe@example.com', phone: '+15551234567' });
+
+# CORRECT — only a non-identifying conversion signal
+dataLayer.push({ event: 'signup', signup_tier: 'free' });
+```
+
+Check for: email, phone, full name, postal address, date of birth, government IDs, account numbers, precise geolocation, and free-text fields that may contain any of the above.
+
+### Step 4 — Form-field auto-capture audit
+
+Identify any feature that captures form input without an explicit field allowlist:
+- Meta Pixel **Advanced Matching** (automatic) — scrapes form fields on the page.
+- Google **enhanced conversions** with auto-detection rather than a defined selector.
+- Tag-manager **form-submit** triggers with a variable capturing all field values.
+- Generic input/keystroke listeners.
+
+```text
+# HIGH — automatic advanced matching scrapes every form field on the page
+fbq('init', 'PIXEL_ID', {}, { autoConfig: true });
+
+# LOWER RISK — matching restricted to explicitly chosen, hashed fields
+fbq('init', 'PIXEL_ID');
+fbq('track', 'Lead');   # no automatic field scraping; identifiers handled server-side if needed
+```
+
+Auto-capture is HIGH because it collects whatever the visitor typed, including fields the marketer never intended to send.
+
+### Step 5 — Identifier-handling audit
+
+For any identifier intentionally sent for matching:
+- Confirm SHA-256 hashing where the ad platform's API requires it, and confirm hashing happens before transmission, not by the ad network on receipt.
+- Note that hashing is pseudonymization, not anonymization — it still constitutes disclosure of personal data and still requires a lawful basis and consent scope.
+- Confirm a redaction or allowlist layer strips PII from URLs and referrers before any pixel reads `location`.
+
+Missing hashing where required is HIGH. Missing a redaction layer is MEDIUM.
+
+### Step 6 — Payload minimization audit
+
+Conversion events should send the minimum signal needed for measurement:
+- A conversion flag and a coarse category are usually sufficient.
+- Precise revenue, full order line items, account balances, or SKU-level health/financial detail sent to an ad network is MEDIUM — it is more than measurement requires.
+
+### Step 7 — Consent-load ordering check
+
+Note whether pixels load before the consent signal. Flag as MEDIUM and explicitly defer the full consent-gating analysis to the `marketing-consent-data-collection-review` skill — do not duplicate that analysis here.
+
+### Step 8 — Produce the output
+
+Format findings using the Output section below.
+
+---
+
+## Output
+
+Return findings in this structure:
+
+```
+## Verdict
+<one sentence: pass / needs work / critical issues found>
+
+## Evidence level
+<payload provided | container provided | documentation-based | inference>
+
+## Findings
+
+### CRITICAL
+- [C1] <finding title>: <description> — <remediation>
+
+### HIGH
+- [H1] <finding title>: <description> — <remediation>
+
+### MEDIUM
+- [M1] <finding title>: <description> — <remediation>
+
+### LOW
+- [L1] <finding title>: <description> — <remediation>
+
+## Safe next actions
+1. <action>
+2. <action>
+
+## Open questions
+- <question requiring user clarification>
+```
+
+---
+
+## Security and scope notes
+
+- This is a static review. Never request real visitor data, real conversion logs, or ad-platform credentials. Work from sanitized payloads with placeholder values.
+- A leak found here may be a reportable breach under HIPAA, the FTC Health Breach Notification Rule, or state law — flag that possibility and route the determination to qualified counsel and the incident-response process. Do not make the breach-notification call yourself.
+- Never recommend a fix that keeps PII flowing to the ad network "but hashed" as a complete remedy — hashing is mitigation, not elimination.
+- Never recommend removing a pixel without naming the conversion measurement lost and a server-side or consent-scoped alternative.
+- When evidence is partial, scope each finding to what was provided and state the assumption explicitly.

package/skills/marketing/martech-access-governance-review/SKILL.md

@@ -0,0 +1,45 @@
+---
+name: martech-access-governance-review
+description: Use this skill when reviewing access governance across a marketing technology stack — OAuth grants and connected apps, API keys and tokens, CRM and marketing-automation role assignments, and integration scopes. Trigger when a user provides an OAuth connected-app inventory, an integration scope list, a CRM/MAP role matrix, an API-key inventory, or asks whether their martech integrations are over-permissioned, whether stale connectors still hold live tokens, or how to apply least privilege to their marketing stack.
+allowed-tools: Read Grep Glob
+metadata:
+  author: "github: Raishin"
+  version: "0.1.0"
+  updated: "2026-05-17"
+  category: security
+  lifecycle: experimental
+---
+
+# Martech Access Governance Review
+
+## Purpose
+This skill reviews identity and access governance across a marketing technology stack — the CRM, marketing automation platform, CDP, analytics, and the long tail of connected SaaS apps. Marketing operations accumulate OAuth grants, API keys, and seat permissions faster than any other business function, and rarely deprovision them. The result is a stack where third-party connectors hold full-CRM scopes, a single shared admin key authenticates a dozen tools, and a contractor's connected app still has a live refresh token a year after the engagement ended. This is one of the most exploited SaaS breach paths: the marketing stack holds the entire customer database and is governed loosely. The review catches over-broad OAuth scopes, shared and non-rotating credentials, stale grants, missing token expiry, and absent ownership before they become an incident.
+
+## Lean operating rules
+- Treat any third-party connected app granted a full-read or read-write scope over the entire CRM contact/lead database when its function needs a narrow scope as HIGH — over-broad scope is the blast radius if that vendor is breached.
+- Treat a single API key or service account shared across multiple tools or integrations as HIGH — it cannot be rotated or revoked without an outage, and a leak compromises every consumer.
+- Treat any long-lived API key or OAuth grant with no rotation schedule and no expiry as HIGH — a leaked non-expiring credential is valid until someone notices.
+- Treat a connected app, integration, or token tied to a departed employee, ended vendor engagement, or decommissioned tool that still holds a live grant as HIGH — stale credentials are unattended attack surface.
+- Treat a CRM or marketing-automation integration credentialed with an admin or owner role when an API-only or limited integration role exists as HIGH — privilege beyond function violates least privilege.
+- Treat a connected app or API key with no named human or team owner as HIGH — unowned credentials are never reviewed and never revoked.
+- Flag marketing user seats holding bulk-export or full-database-export permission beyond the few who need it as MEDIUM — bulk export is the exfiltration path.
+- Flag the absence of a recurring access-review cadence for connected apps and integration credentials as MEDIUM.
+- Flag OAuth grants that include offline-access / refresh-token scope where only short-lived interactive access is needed as MEDIUM.
+- Flag credentials transmitted or stored in plaintext (in tag managers, spreadsheets, shared docs, or automation tools) as HIGH.
+- Do not recommend revoking a grant without naming the integration it powers and the marketing workflow that breaks.
+- Label every finding with evidence basis: inventory provided, role matrix provided, documentation-based, or inference from missing config.
+
+## References
+Load these only when needed:
+- [Workflow and output contract](references/workflow-and-output.md) — use when executing the full review or formatting the final answer.
+
+## Response minimum
+Return, at minimum:
+- OAuth scope blast-radius findings (connected apps over-scoped vs function)
+- Shared / non-rotating credential findings
+- Stale grant findings (departed users, ended vendors, dead tools)
+- Integration role assessment (admin used where limited role exists)
+- Ownership and access-review cadence gaps
+- Bulk-export permission distribution assessment
+- Severity-labelled finding list (critical / high / medium / low)
+- Safe next actions

package/skills/marketing/martech-access-governance-review/metadata.json

@@ -0,0 +1,21 @@
+{
+  "id": "martech-access-governance-review",
+  "name": "Martech Access Governance Review",
+  "type": "skill",
+  "provider": "marketing",
+  "harnesses": ["codex", "claude-code", "cursor", "gemini", "kiro", "other"],
+  "summary": "Review access governance across a marketing technology stack — OAuth connected apps, API keys, CRM and marketing-automation roles, and integration scopes — for least-privilege violations, shared and stale credentials, and missing ownership.",
+  "source_type": "original",
+  "official_docs": [
+    "https://datatracker.ietf.org/doc/html/rfc6749",
+    "https://oauth.net/2/scope/",
+    "https://csrc.nist.gov/glossary/term/least_privilege",
+    "https://owasp.org/www-project-top-ten/",
+    "https://csrc.nist.gov/pubs/sp/800/207/final"
+  ],
+  "security_notes": "A marketing technology stack holds the full customer database and accumulates OAuth grants, API keys, and seats faster than it deprovisions them. Over-broad connector scopes, shared non-rotating credentials, and stale grants from departed staff or ended vendors are a heavily exploited SaaS breach path. Review works from sanitized inventories only; never request, collect, or echo credential values, tokens, or secrets.",
+  "last_verified": "2026-05-17",
+  "path": "skills/marketing/martech-access-governance-review",
+  "author": "github: Raishin",
+  "version": "0.1.0"
+}

package/skills/marketing/martech-access-governance-review/references/workflow-and-output.md

@@ -0,0 +1,116 @@
+# Workflow and Output Contract
+
+## Workflow
+
+### Step 1 — Collect inputs
+
+Ask the user to provide one or more of the following as sanitized inventories (redact every credential value — names and scopes only, never the secret itself):
+- Connected-app / OAuth grant inventory for the CRM and marketing automation platform (app name, scopes granted, grant date, owner)
+- API-key inventory (key name/label, the tool it authenticates, scope, rotation history — never the key value)
+- CRM and marketing-automation role matrix (roles, permissions, which integrations and users hold each)
+- The list of marketing tools in the stack and how each authenticates
+- Offboarding process for departed employees and ended vendor engagements, if documented
+
+If the user provides only a partial set, note which sections are absent and scope findings accordingly. If a user pastes an actual credential value, stop, tell them not to, and ask them to treat it as compromised and rotate it.
+
+### Step 2 — Build the integration map
+
+For each integration, record: what it is, what marketing function it performs, what data it touches, and the minimum scope that function requires. This "needed scope" baseline is what every granted scope is measured against.
+
+### Step 3 — OAuth scope blast-radius audit
+
+For every connected app, compare granted scope to needed scope.
+
+```text
+# HIGH — a form/survey tool granted full read-write over all CRM contacts
+App: SurveyTool
+Granted: crm.objects.contacts.read, crm.objects.contacts.write, crm.objects.deals.read
+Needed:  crm.objects.contacts.write  (it only creates contacts from form fills)
+
+# CORRECT — scope matches function
+App: SurveyTool
+Granted: crm.objects.contacts.write
+```
+
+Flag every scope granted beyond function as HIGH. The blast radius of any connected app is the data its scope can reach if that vendor is breached — and SaaS supply-chain breaches routinely pivot through exactly these grants.
+
+### Step 4 — Credential-sharing and rotation audit
+
+- A single API key or service account used by more than one tool or integration is HIGH — it cannot be rotated or revoked for one consumer without breaking the others, and a single leak compromises all of them.
+- Any key or grant with no rotation schedule and no expiry is HIGH.
+- A "personal" API key issued under an individual employee's account, rather than a dedicated integration identity, is MEDIUM — it breaks when they leave and carries their full personal permissions.
+
+### Step 5 — Stale-grant audit
+
+Identify grants that should no longer exist:
+- Connected apps or tokens owned by departed employees.
+- Grants from vendor engagements or trials that have ended.
+- Credentials for tools that were decommissioned but never disconnected.
+- OAuth refresh tokens that are still valid because nothing ever revoked them.
+
+Every live stale grant is HIGH — it is access nobody is watching.
+
+### Step 6 — Integration role audit
+
+Check the role each integration authenticates with:
+- An integration using an admin or owner role when an API-only or limited integration role exists is HIGH.
+- An integration that can change other users' permissions, billing, or security settings, when it only needs to read or write records, is HIGH.
+
+### Step 7 — Ownership and review-cadence audit
+
+- Every connected app and integration credential must have a named human or team owner. Unowned credentials are HIGH — nobody will ever review or revoke them.
+- There must be a recurring access-review cadence (for example, quarterly) covering connected apps and integration credentials. Its absence is MEDIUM.
+
+### Step 8 — Bulk-export and credential-storage audit
+
+- Identify which marketing seats hold full-database or bulk-export permission. This is the exfiltration path; it should be held by the few who need it. Broad distribution is MEDIUM.
+- Identify where credentials are stored. Credentials in spreadsheets, shared docs, tag-manager variables, or automation-tool fields in plaintext are HIGH. They belong in a secrets manager.
+
+### Step 9 — Produce the output
+
+Format findings using the Output section below.
+
+---
+
+## Output
+
+Return findings in this structure:
+
+```
+## Verdict
+<one sentence: pass / needs work / critical issues found>
+
+## Evidence level
+<inventory provided | role matrix provided | documentation-based | inference>
+
+## Findings
+
+### CRITICAL
+- [C1] <finding title>: <description> — <remediation>
+
+### HIGH
+- [H1] <finding title>: <description> — <remediation>
+
+### MEDIUM
+- [M1] <finding title>: <description> — <remediation>
+
+### LOW
+- [L1] <finding title>: <description> — <remediation>
+
+## Safe next actions
+1. <action>
+2. <action>
+
+## Open questions
+- <question requiring user clarification>
+```
+
+---
+
+## Security and scope notes
+
+- This is a static review. Never request, collect, store, or echo credential values, API keys, tokens, or secrets. Work from inventories of names and scopes only.
+- If the user pastes a real credential, treat it as compromised: tell them, and recommend immediate rotation.
+- Apply least privilege and zero-trust assumptions: every integration should hold the narrowest scope, the shortest-lived token, and a named owner.
+- Never recommend revoking a grant without naming the integration it powers and the marketing workflow that breaks — propose the scoped-down replacement grant alongside the revocation.
+- When evidence is partial, scope each finding to what was provided and state the assumption explicitly.

package/skills/marketing/programmatic-supply-chain-integrity-review/SKILL.md

@@ -0,0 +1,43 @@
+---
+name: programmatic-supply-chain-integrity-review
+description: Use this skill when reviewing ads.txt, app-ads.txt, and sellers.json files for a publisher or advertiser's programmatic supply chain to detect unauthorized resellers, domain-spoofing exposure, and SupplyChain Object gaps. Trigger when a user provides an ads.txt file, an app-ads.txt file, a sellers.json endpoint response, or asks whether their programmatic supply chain has unauthorized intermediaries, IVT exposure, domain-spoofing risk, or whether their supply chain declaration satisfies IAB Tech Lab, MRC, or DSP procurement requirements.
+allowed-tools: Read Grep Glob
+metadata:
+  author: "github: Raishin"
+  version: "0.1.0"
+  updated: "2026-05-17"
+  category: finops
+  lifecycle: experimental
+---
+
+# Programmatic Supply Chain Integrity Review
+
+## Purpose
+This skill reviews ads.txt, app-ads.txt, and sellers.json declarations for a publisher's or advertiser's programmatic supply chain to detect unauthorized resellers, domain-spoofing exposure, SupplyChain Object gaps, and IVT-exposure vectors. Ads.txt (IAB Tech Lab v1.1) and app-ads.txt are the publisher's machine-readable authorization of which exchanges and resellers may sell their inventory; sellers.json (IAB Tech Lab v1.0) is the exchange's machine-readable disclosure of which sellers it represents. When these files are inconsistent — an ads.txt RESELLER entry that no exchange discloses in sellers.json, a DIRECT entry that resolves as `is_confidential:1`, or a whitelisted domain whose ads.txt is absent — the supply chain is opaque to buyers, exposing them to unauthorized intermediary fees and exposing publishers to domain spoofing. The SupplyChain Object (OpenRTB extension) enables bid-time audit of the complete reseller path; gaps in the declared path are treated as invalid traffic by MRC-compliant measurement vendors and many DSP procurement teams. The review works from the raw text of the artifact files pasted as input and produces severity-labelled findings with remediation.
+
+## Lean operating rules
+- Treat ads.txt RESELLER entries for exchange accounts that do not appear in any sellers.json file for that exchange as HIGH — these are undisclosed intermediaries whose presence in the resale chain cannot be verified by buyers, constituting unauthorized supply path opacity under IAB Tech Lab ads.txt 1.1.
+- Treat a whitelisted publisher domain whose ads.txt file is entirely absent as HIGH — the absence means buyers cannot verify any authorized seller relationship; the domain is categorically IVT-exposed per MRC Invalid Traffic Detection guidelines and most DSP whitelisting criteria.
+- Treat a DIRECT entry in ads.txt where the corresponding seller account in sellers.json carries `is_confidential:1` as HIGH — a DIRECT relationship by definition requires transparent publisher identity; confidential resolution contradicts the DIRECT classification and is a domain-spoofing risk vector.
+- Treat ads.txt entries that reference exchange account IDs not present in the exchange's sellers.json at all (orphaned account IDs) as HIGH — the account cannot be verified as a legitimate seller, which is a signal of domain spoofing or stale declarations.
+- Treat a `seller_type: INTERMEDIARY` entry in sellers.json that has no corresponding ads.txt RESELLER entry on the publisher domain as MEDIUM — the intermediary is declared by the exchange but not authorized by the publisher, creating a supply path discrepancy.
+- Treat SupplyChain Object declarations with incomplete node chains (missing `asi`, `sid`, or `rid` fields in intermediate nodes) as MEDIUM — incomplete chains reduce bid-time auditability and may cause DSP procurement filters to reject the bid.
+- Flag MEDIUM when the ads.txt file has not been updated within twelve months and active exchange relationships are known to have changed — stale declarations expose revenue to unauthorized resellers who retain old account relationships.
+- Flag the absence of app-ads.txt for a mobile app publisher as MEDIUM when the publisher's ads.txt covers only web inventory — app inventory without app-ads.txt is unprotected by IAB Tech Lab supply-chain controls.
+- Do not recommend removing a RESELLER entry without first confirming whether it represents a legitimate revenue path that can be replaced with a DIRECT relationship or a disclosed intermediary.
+- Label every finding with evidence basis: ads.txt provided, sellers.json provided, documentation-based, or inference from absent file.
+
+## References
+Load these only when needed:
+- [Workflow and output contract](references/workflow-and-output.md) — use when executing the full review or formatting the final answer.
+
+## Response minimum
+Return, at minimum:
+- RESELLER-to-sellers.json consistency assessment (unauthorized intermediaries)
+- DIRECT-entry confidentiality conflict assessment (domain-spoofing risk)
+- Orphaned account ID assessment (account IDs in ads.txt not in sellers.json)
+- Absent ads.txt / app-ads.txt assessment for whitelisted domains
+- SupplyChain Object completeness assessment
+- Stale declaration assessment
+- Severity-labelled finding list (critical / high / medium / low)
+- Safe next actions

package/skills/marketing/programmatic-supply-chain-integrity-review/metadata.json

@@ -0,0 +1,22 @@
+{
+  "id": "programmatic-supply-chain-integrity-review",
+  "name": "Programmatic Supply Chain Integrity Review",
+  "type": "skill",
+  "provider": "marketing",
+  "harnesses": ["codex", "claude-code", "cursor", "gemini", "kiro", "other"],
+  "summary": "Review ads.txt, app-ads.txt, and sellers.json files for a publisher or advertiser's programmatic supply chain to detect unauthorized resellers, domain-spoofing exposure, and SupplyChain Object gaps.",
+  "source_type": "original",
+  "official_docs": [
+    "https://iabtechlab.com/ads-txt/",
+    "https://iabtechlab.com/sellers-json/",
+    "https://iabtechlab.com/supplychain-object/",
+    "https://mediaratingcouncil.org/sites/default/files/Standards/MRC%20Invalid%20Traffic%20Detection%20and%20Filtration%20Guidelines%20Addendum.pdf",
+    "https://iabtechlab.com/app-ads-txt/"
+  ],
+  "security_notes": "Supply chain integrity reviews work from the raw text of ads.txt, app-ads.txt, and sellers.json files pasted as input. Never request DSP credentials, exchange account tokens, or bid-stream logs. ads.txt and sellers.json are publicly resolvable files; the artifact is the publisher's or exchange's own exported text, not a live crawl of production endpoints.",
+  "last_verified": "2026-05-17",
+  "path": "skills/marketing/programmatic-supply-chain-integrity-review",
+  "author": "github: Raishin",
+  "version": "0.1.0",
+  "lifecycle": "experimental"
+}