Skip to content

aiskillstore/marketplace / skills/aaron-he-zhu/email-render-builder

email-render-builder

Verified

Use when the user asks to "build the email HTML", "make this email responsive", "fix dark-mode rendering", or "QA the email across clients"; produces the coded HTML build — a responsive table layout, dark-mode + accessibility pass, a client-render matrix, image-block fallbacks, and a plain-text parity check. Not for writing the copy — use email-creative-builder; not for scoring the email or computing EQS — use email-quality-auditor. 邮件HTML/响应式邮件/暗色模式渲染

FileKindSize
SKILL.mdskill md13.4 KB
references/client-render-matrix.mdmarkdown2.2 KB
references/email-render-specs.mdmarkdown3.5 KB
skill-report.jsonconfig52.0 KB

skill-report.json

View on GitHub
{
  "schema_version": "2.0",
  "meta": {
    "generated_at": "2026-07-26T10:17:01.997Z",
    "slug": "aaron-he-zhu-email-render-builder",
    "source_url": "https://github.com/aaron-he-zhu/aaron-marketing-skills/tree/main/email/engage/email-render-builder",
    "source_ref": "main",
    "model": "claude",
    "analysis_version": "3.0.0",
    "source_type": "community",
    "content_hash": "6691ea41eb4c8be469761a7c68bbc78a900ab519231ec2a61500e7e4b07ec135",
    "tree_hash": "54686c8bfd4fd09dbf774299498db66425b452222537e8d1a85c5eb1b943aa7b",
    "provenance": {
      "model_effective": "claude",
      "fallback_chain": [
        {
          "agent": "codex",
          "outcome": "failed",
          "error": "2026-07-26T10:17:02.094334Z ERROR codex_models_manager::manager: failed to refresh available models: Missing environment variable: `HELM_API_KEY`.\n2026-07-26T10:17:02.128929Z 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": "email-render-builder",
    "description": "Build responsive email HTML and produce render QA guidance for dark mode, accessibility, image-off behavior, and common email clients.",
    "summary": "Create responsive email builds with practical render and accessibility checks.",
    "icon": "📦",
    "version": "19.0.0",
    "author": "aaron-he-zhu",
    "license": "Apache-2.0",
    "tags": [
      "email-html",
      "responsive-email",
      "email-accessibility",
      "dark-mode",
      "render-qa"
    ],
    "supported_tools": [
      "claude",
      "codex",
      "claude-code"
    ],
    "risk_factors": [
      "filesystem",
      "external_commands",
      "network"
    ],
    "category": "design"
  },
  "security_audit": {
    "risk_level": "safe",
    "is_blocked": false,
    "safe_to_publish": true,
    "analysis_status": "ok",
    "summary": "Most static matches are false positives caused by Markdown fences, relative documentation links, and email-client terminology. Two operational behaviors remain: an optional live render-test email command and a user-confirmed local result save; neither shows malicious intent, but both require confirmation and path validation.",
    "remediation": [
      {
        "issue": "Optional live render-test sends can create an external side effect.",
        "suggestion": "Require explicit confirmation immediately before any command using --live, display the sender and recipient inboxes, and enforce an allowlist of user-owned test recipients.",
        "severity": "medium"
      },
      {
        "issue": "The save path includes a subject-derived filename.",
        "suggestion": "Normalize the subject to a safe slug, reject path separators and traversal sequences, and resolve the final path within the designated memory directory before writing.",
        "severity": "high"
      }
    ],
    "risk_factor_evidence": [
      {
        "factor": "filesystem",
        "evidence": [
          {
            "file": "references/email-render-specs.md",
            "line_start": 3,
            "line_end": 3
          },
          {
            "file": "references/email-render-specs.md",
            "line_start": 56,
            "line_end": 56
          },
          {
            "file": "SKILL.md",
            "line_start": 20,
            "line_end": 20
          },
          {
            "file": "SKILL.md",
            "line_start": 40,
            "line_end": 40
          },
          {
            "file": "SKILL.md",
            "line_start": 44,
            "line_end": 44
          },
          {
            "file": "SKILL.md",
            "line_start": 48,
            "line_end": 48
          },
          {
            "file": "SKILL.md",
            "line_start": 52,
            "line_end": 52
          },
          {
            "file": "SKILL.md",
            "line_start": 54,
            "line_end": 54
          },
          {
            "file": "SKILL.md",
            "line_start": 58,
            "line_end": 58
          },
          {
            "file": "SKILL.md",
            "line_start": 68,
            "line_end": 68
          },
          {
            "file": "SKILL.md",
            "line_start": 69,
            "line_end": 69
          },
          {
            "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": 93,
            "line_end": 93
          },
          {
            "file": "SKILL.md",
            "line_start": 94,
            "line_end": 94
          },
          {
            "file": "SKILL.md",
            "line_start": 95,
            "line_end": 95
          },
          {
            "file": "SKILL.md",
            "line_start": 96,
            "line_end": 96
          },
          {
            "file": "SKILL.md",
            "line_start": 97,
            "line_end": 97
          }
        ]
      },
      {
        "factor": "external_commands",
        "evidence": [
          {
            "file": "SKILL.md",
            "line_start": 18,
            "line_end": 18
          },
          {
            "file": "SKILL.md",
            "line_start": 24,
            "line_end": 26
          },
          {
            "file": "SKILL.md",
            "line_start": 26,
            "line_end": 28
          },
          {
            "file": "SKILL.md",
            "line_start": 28,
            "line_end": 30
          },
          {
            "file": "SKILL.md",
            "line_start": 30,
            "line_end": 32
          },
          {
            "file": "SKILL.md",
            "line_start": 32,
            "line_end": 34
          },
          {
            "file": "SKILL.md",
            "line_start": 34,
            "line_end": 38
          },
          {
            "file": "SKILL.md",
            "line_start": 38,
            "line_end": 42
          },
          {
            "file": "SKILL.md",
            "line_start": 42,
            "line_end": 42
          },
          {
            "file": "SKILL.md",
            "line_start": 52,
            "line_end": 52
          },
          {
            "file": "SKILL.md",
            "line_start": 54,
            "line_end": 54
          },
          {
            "file": "SKILL.md",
            "line_start": 64,
            "line_end": 64
          },
          {
            "file": "SKILL.md",
            "line_start": 66,
            "line_end": 66
          },
          {
            "file": "SKILL.md",
            "line_start": 67,
            "line_end": 82
          },
          {
            "file": "SKILL.md",
            "line_start": 82,
            "line_end": 87
          },
          {
            "file": "SKILL.md",
            "line_start": 87,
            "line_end": 97
          }
        ]
      },
      {
        "factor": "network",
        "evidence": [
          {
            "file": "SKILL.md",
            "line_start": 10,
            "line_end": 10
          },
          {
            "file": "SKILL.md",
            "line_start": 13,
            "line_end": 13
          }
        ]
      }
    ],
    "static_findings": [
      {
        "id": "blocker:references/client-render-matrix.md:7:system-reconnaissance",
        "category": "blocker",
        "severity": "low",
        "pattern": "System reconnaissance",
        "file": "references/client-render-matrix.md",
        "line_start": 7,
        "line_end": 7,
        "snippet": "Gmail (app + web), Outlook (desktop Word-engine + web/new Outlook), Apple Mail, iOS Mail, Android (G"
      },
      {
        "id": "blocker:references/client-render-matrix.md:16:system-reconnaissance",
        "category": "blocker",
        "severity": "low",
        "pattern": "System reconnaissance",
        "file": "references/client-render-matrix.md",
        "line_start": 16,
        "line_end": 16,
        "snippet": "| **Android (Gmail/Samsung)** | mixed dark-mode handling; smaller tap targets | reflow gaps, sub-44p"
      },
      {
        "id": "blocker:references/client-render-matrix.md:29:system-reconnaissance",
        "category": "blocker",
        "severity": "low",
        "pattern": "System reconnaissance",
        "file": "references/client-render-matrix.md",
        "line_start": 29,
        "line_end": 29,
        "snippet": "| Android | | | | | |"
      },
      {
        "id": "filesystem:references/email-render-specs.md:3:path-traversal-sequence",
        "category": "filesystem",
        "severity": "high",
        "pattern": "Path traversal sequence",
        "file": "references/email-render-specs.md",
        "line_start": 3,
        "line_end": 3,
        "snippet": "Build patterns and QA checklists for `email-render-builder`. The layout carries the approved copy fr"
      },
      {
        "id": "filesystem:references/email-render-specs.md:56:path-traversal-sequence",
        "category": "filesystem",
        "severity": "high",
        "pattern": "Path traversal sequence",
        "file": "references/email-render-specs.md",
        "line_start": 56,
        "line_end": 56,
        "snippet": "The `text/plain` alternate must carry the same core message, the same primary CTA, and the same dest"
      },
      {
        "id": "blocker:references/email-render-specs.md:16:system-reconnaissance",
        "category": "blocker",
        "severity": "low",
        "pattern": "System reconnaissance",
        "file": "references/email-render-specs.md",
        "line_start": 16,
        "line_end": 16,
        "snippet": "| **Fluid / hybrid** | percentage widths + `max-width` + `mso` ghost tables | widest — works even wh"
      },
      {
        "id": "blocker:references/email-render-specs.md:19:system-reconnaissance",
        "category": "blocker",
        "severity": "low",
        "pattern": "System reconnaissance",
        "file": "references/email-render-specs.md",
        "line_start": 19,
        "line_end": 19,
        "snippet": "Default to fluid/hybrid for a broad target set; note the choice. Tap targets ≥44px; body font ≥14px "
      },
      {
        "id": "blocker:references/email-render-specs.md:26:system-reconnaissance",
        "category": "blocker",
        "severity": "low",
        "pattern": "System reconnaissance",
        "file": "references/email-render-specs.md",
        "line_start": 26,
        "line_end": 26,
        "snippet": "- [ ] Logos / dark-on-transparent images have a padded solid backing or a dark-mode variant."
      },
      {
        "id": "blocker:references/email-render-specs.md:43:system-reconnaissance",
        "category": "blocker",
        "severity": "low",
        "pattern": "System reconnaissance",
        "file": "references/email-render-specs.md",
        "line_start": 43,
        "line_end": 43,
        "snippet": "- Background images carry a solid `bgcolor` fallback."
      },
      {
        "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": "Builds and QAs the coded HTML for a single email — a responsive table-based layout, a dark-mode + ac"
      },
      {
        "id": "external_commands:SKILL.md:24:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 24,
        "line_end": 26,
        "snippet": "```"
      },
      {
        "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": 28,
        "snippet": "```"
      },
      {
        "id": "external_commands:SKILL.md:28:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 28,
        "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": 32,
        "snippet": "```"
      },
      {
        "id": "external_commands:SKILL.md:32:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 32,
        "line_end": 34,
        "snippet": "```"
      },
      {
        "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": 38,
        "snippet": "```"
      },
      {
        "id": "external_commands:SKILL.md:38:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 38,
        "line_end": 42,
        "snippet": "**Expected output**: one email HTML build plus a render-QA report — inline-styled table layout, dark"
      },
      {
        "id": "external_commands:SKILL.md:42:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 42,
        "line_end": 42,
        "snippet": "- **Promotes**: confirmed render blockers (a client that breaks the layout, an image-only block with"
      },
      {
        "id": "external_commands:SKILL.md:52:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 52,
        "line_end": 52,
        "snippet": "This skill is build-and-QA, not analytics — its primary inputs are the approved creative and any raw"
      },
      {
        "id": "external_commands:SKILL.md:54:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 54,
        "line_end": 54,
        "snippet": "**Zero-dependency render-test send (when Resend is the ESP)**: `python3 \"${CLAUDE_PLUGIN_ROOT}/scrip"
      },
      {
        "id": "external_commands:SKILL.md:64:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 64,
        "line_end": 64,
        "snippet": "5. **Run the accessibility pass** — semantic reading order, a meaningful `alt` on every image (empty"
      },
      {
        "id": "external_commands:SKILL.md:66:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 66,
        "line_end": 66,
        "snippet": "7. **Build the client-render matrix** — for each target (Gmail app + web, Outlook desktop Word-engin"
      },
      {
        "id": "external_commands:SKILL.md:67:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 67,
        "line_end": 82,
        "snippet": "8. **Check plain-text parity** — the `text/plain` alternate must carry the same core message, the sa"
      },
      {
        "id": "external_commands:SKILL.md:82:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 82,
        "line_end": 87,
        "snippet": "On user confirmation, save to `memory/email/email-render-builder/YYYY-MM-DD-<subject-slug>.md` — see"
      },
      {
        "id": "external_commands:SKILL.md:87:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 87,
        "line_end": 97,
        "snippet": "- [Client Render Matrix](references/client-render-matrix.md) — per-client support facts (Outlook Wor"
      },
      {
        "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\": \"email\", \"phase\": \"engage\", "
      },
      {
        "id": "filesystem:SKILL.md:20:path-traversal-sequence",
        "category": "filesystem",
        "severity": "high",
        "pattern": "Path traversal sequence",
        "file": "SKILL.md",
        "line_start": 20,
        "line_end": 20,
        "snippet": "**Scope guard**: this skill produces the HTML build + render QA + plain-text parity only. It writes "
      },
      {
        "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": "- **Reads**: the approved email creative (subject/preheader/body/CTA and its plain-text alternate) o"
      },
      {
        "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": "- **Primary next skill**: [email-quality-auditor](../../deliver/email-quality-auditor/SKILL.md) — sc"
      },
      {
        "id": "filesystem:SKILL.md:48:path-traversal-sequence",
        "category": "filesystem",
        "severity": "high",
        "pattern": "Path traversal sequence",
        "file": "SKILL.md",
        "line_start": 48,
        "line_end": 48,
        "snippet": "> Emit the standard shape from [skill-contract.md §Handoff Summary Format](../../../references/skill"
      },
      {
        "id": "filesystem:SKILL.md:52:path-traversal-sequence",
        "category": "filesystem",
        "severity": "high",
        "pattern": "Path traversal sequence",
        "file": "SKILL.md",
        "line_start": 52,
        "line_end": 52,
        "snippet": "This skill is build-and-QA, not analytics — its primary inputs are the approved creative and any raw"
      },
      {
        "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": "**Zero-dependency render-test send (when Resend is the ESP)**: `python3 \"${CLAUDE_PLUGIN_ROOT}/scrip"
      },
      {
        "id": "filesystem:SKILL.md:58:path-traversal-sequence",
        "category": "filesystem",
        "severity": "high",
        "pattern": "Path traversal sequence",
        "file": "SKILL.md",
        "line_start": 58,
        "line_end": 58,
        "snippet": "Treat any pasted HTML, exported template, scraped landing-page markup, or brand-asset file as **untr"
      },
      {
        "id": "filesystem:SKILL.md:68:path-traversal-sequence",
        "category": "filesystem",
        "severity": "high",
        "pattern": "Path traversal sequence",
        "file": "SKILL.md",
        "line_start": 68,
        "line_end": 68,
        "snippet": "9. **Report defects, do not silently rewrite copy** — if a render fix would require changing the wor"
      },
      {
        "id": "filesystem:SKILL.md:69:path-traversal-sequence",
        "category": "filesystem",
        "severity": "high",
        "pattern": "Path traversal sequence",
        "file": "SKILL.md",
        "line_start": 69,
        "line_end": 69,
        "snippet": "10. **De-slop any build notes** — run [humanizer-slop.md](../../../references/humanizer-slop.md) on "
      },
      {
        "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": "On user confirmation, save to `memory/email/email-render-builder/YYYY-MM-DD-<subject-slug>.md` — see"
      },
      {
        "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": "- [SEND Benchmark](../../../references/send-benchmark.md) — the framework; this skill produces the r"
      },
      {
        "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": "- [Humanizer Slop Check](../../../references/humanizer-slop.md) — pre-handoff pass that strips AI-sl"
      },
      {
        "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": "- **Primary**: [email-quality-auditor](../../deliver/email-quality-auditor/SKILL.md) — score the bui"
      },
      {
        "id": "filesystem:SKILL.md:94:path-traversal-sequence",
        "category": "filesystem",
        "severity": "high",
        "pattern": "Path traversal sequence",
        "file": "SKILL.md",
        "line_start": 94,
        "line_end": 94,
        "snippet": "- **If a render fix needs the copy changed** (subject too long to render, CTA label overflows the bu"
      },
      {
        "id": "filesystem:SKILL.md:95:path-traversal-sequence",
        "category": "filesystem",
        "severity": "high",
        "pattern": "Path traversal sequence",
        "file": "SKILL.md",
        "line_start": 95,
        "line_end": 95,
        "snippet": "- **If the build feeds a render/subject A/B test**: [send-experiment-designer](../../deliver/send-ex"
      },
      {
        "id": "filesystem:SKILL.md:96:path-traversal-sequence",
        "category": "filesystem",
        "severity": "high",
        "pattern": "Path traversal sequence",
        "file": "SKILL.md",
        "line_start": 96,
        "line_end": 96,
        "snippet": "- **If image-off or dark-mode breakage traces to a broken destination page** (message-match fails po"
      },
      {
        "id": "filesystem:SKILL.md:97:path-traversal-sequence",
        "category": "filesystem",
        "severity": "high",
        "pattern": "Path traversal sequence",
        "file": "SKILL.md",
        "line_start": 97,
        "line_end": 97,
        "snippet": "- Global visited-set / max-depth (`max-depth: 3`) termination contract from [skill-contract.md](../."
      },
      {
        "id": "blocker:SKILL.md:52:system-reconnaissance",
        "category": "blocker",
        "severity": "low",
        "pattern": "System reconnaissance",
        "file": "SKILL.md",
        "line_start": 52,
        "line_end": 52,
        "snippet": "This skill is build-and-QA, not analytics — its primary inputs are the approved creative and any raw"
      },
      {
        "id": "blocker:SKILL.md:62:system-reconnaissance",
        "category": "blocker",
        "severity": "low",
        "pattern": "System reconnaissance",
        "file": "SKILL.md",
        "line_start": 62,
        "line_end": 62,
        "snippet": "3. **Make it responsive** — the single column reflows on narrow viewports; tap targets stay ≥44px; f"
      },
      {
        "id": "blocker:SKILL.md:65:system-reconnaissance",
        "category": "blocker",
        "severity": "low",
        "pattern": "System reconnaissance",
        "file": "SKILL.md",
        "line_start": 65,
        "line_end": 65,
        "snippet": "6. **Specify image-off fallbacks** — the email must carry its message with images blocked (many clie"
      },
      {
        "id": "blocker:SKILL.md:71:system-reconnaissance",
        "category": "blocker",
        "severity": "low",
        "pattern": "System reconnaissance",
        "file": "SKILL.md",
        "line_start": 71,
        "line_end": 71,
        "snippet": "Never claim a client renders correctly without a basis — mark any render result you did not verify w"
      },
      {
        "id": "blocker:SKILL.md:78:system-reconnaissance",
        "category": "blocker",
        "severity": "low",
        "pattern": "System reconnaissance",
        "file": "SKILL.md",
        "line_start": 78,
        "line_end": 78,
        "snippet": "- **Continue silently** — target client list unspecified (default to the standard set: Gmail, Outloo"
      }
    ],
    "finding_verdicts": [
      {
        "id": "blocker:references/client-render-matrix.md:7:system-reconnaissance",
        "verdict": "false_positive",
        "confidence": 0.98,
        "reason": "This describes supported email clients, rendering behavior, or product defaults. It does not collect host information or perform system reconnaissance."
      },
      {
        "id": "blocker:references/client-render-matrix.md:16:system-reconnaissance",
        "verdict": "false_positive",
        "confidence": 0.98,
        "reason": "This describes supported email clients, rendering behavior, or product defaults. It does not collect host information or perform system reconnaissance."
      },
      {
        "id": "blocker:references/client-render-matrix.md:29:system-reconnaissance",
        "verdict": "false_positive",
        "confidence": 0.98,
        "reason": "This describes supported email clients, rendering behavior, or product defaults. It does not collect host information or perform system reconnaissance."
      },
      {
        "id": "filesystem:references/email-render-specs.md:3:path-traversal-sequence",
        "verdict": "false_positive",
        "confidence": 0.95,
        "reason": "This is documentation navigation or a scoped file reference, not a filesystem operation using attacker-controlled traversal. No evidence of arbitrary file access or path resolution outside the skill context was found."
      },
      {
        "id": "filesystem:references/email-render-specs.md:56:path-traversal-sequence",
        "verdict": "false_positive",
        "confidence": 0.95,
        "reason": "This is documentation navigation or a scoped file reference, not a filesystem operation using attacker-controlled traversal. No evidence of arbitrary file access or path resolution outside the skill context was found."
      },
      {
        "id": "blocker:references/email-render-specs.md:16:system-reconnaissance",
        "verdict": "false_positive",
        "confidence": 0.98,
        "reason": "This describes supported email clients, rendering behavior, or product defaults. It does not collect host information or perform system reconnaissance."
      },
      {
        "id": "blocker:references/email-render-specs.md:19:system-reconnaissance",
        "verdict": "false_positive",
        "confidence": 0.98,
        "reason": "This describes supported email clients, rendering behavior, or product defaults. It does not collect host information or perform system reconnaissance."
      },
      {
        "id": "blocker:references/email-render-specs.md:26:system-reconnaissance",
        "verdict": "false_positive",
        "confidence": 0.98,
        "reason": "This describes supported email clients, rendering behavior, or product defaults. It does not collect host information or perform system reconnaissance."
      },
      {
        "id": "blocker:references/email-render-specs.md:43:system-reconnaissance",
        "verdict": "false_positive",
        "confidence": 0.98,
        "reason": "This describes supported email clients, rendering behavior, or product defaults. It does not collect host information or perform system reconnaissance."
      },
      {
        "id": "external_commands:SKILL.md:18:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.98,
        "reason": "The matched characters are Markdown code fences or inline code terminology, not Ruby or shell backtick execution. No executable shell or Ruby backtick expression appears at this location."
      },
      {
        "id": "external_commands:SKILL.md:24:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.98,
        "reason": "The matched characters are Markdown code fences or inline code terminology, not Ruby or shell backtick execution. No executable shell or Ruby backtick expression appears at this location."
      },
      {
        "id": "external_commands:SKILL.md:26:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.98,
        "reason": "The matched characters are Markdown code fences or inline code terminology, not Ruby or shell backtick execution. No executable shell or Ruby backtick expression appears at this location."
      },
      {
        "id": "external_commands:SKILL.md:28:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.98,
        "reason": "The matched characters are Markdown code fences or inline code terminology, not Ruby or shell backtick execution. No executable shell or Ruby backtick expression appears at this location."
      },
      {
        "id": "external_commands:SKILL.md:30:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.98,
        "reason": "The matched characters are Markdown code fences or inline code terminology, not Ruby or shell backtick execution. No executable shell or Ruby backtick expression appears at this location."
      },
      {
        "id": "external_commands:SKILL.md:32:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.98,
        "reason": "The matched characters are Markdown code fences or inline code terminology, not Ruby or shell backtick execution. No executable shell or Ruby backtick expression appears at this location."
      },
      {
        "id": "external_commands:SKILL.md:34:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.98,
        "reason": "The matched characters are Markdown code fences or inline code terminology, not Ruby or shell backtick execution. No executable shell or Ruby backtick expression appears at this location."
      },
      {
        "id": "external_commands:SKILL.md:38:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.98,
        "reason": "The matched characters are Markdown code fences or inline code terminology, not Ruby or shell backtick execution. No executable shell or Ruby backtick expression appears at this location."
      },
      {
        "id": "external_commands:SKILL.md:42:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.98,
        "reason": "The matched characters are Markdown code fences or inline code terminology, not Ruby or shell backtick execution. No executable shell or Ruby backtick expression appears at this location."
      },
      {
        "id": "external_commands:SKILL.md:52:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.98,
        "reason": "The matched characters are Markdown code fences or inline code terminology, not Ruby or shell backtick execution. No executable shell or Ruby backtick expression appears at this location."
      },
      {
        "id": "external_commands:SKILL.md:54:ruby-shell-backtick-execution",
        "verdict": "confirmed",
        "confidence": 0.78,
        "reason": "The documented Python command can deliver email when invoked with --live. It is limited to a verified sender and the user's own test inboxes, but it remains an external side effect that requires explicit confirmation.",
        "severity": "medium"
      },
      {
        "id": "external_commands:SKILL.md:64:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.98,
        "reason": "The matched characters are Markdown code fences or inline code terminology, not Ruby or shell backtick execution. No executable shell or Ruby backtick expression appears at this location."
      },
      {
        "id": "external_commands:SKILL.md:66:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.98,
        "reason": "The matched characters are Markdown code fences or inline code terminology, not Ruby or shell backtick execution. No executable shell or Ruby backtick expression appears at this location."
      },
      {
        "id": "external_commands:SKILL.md:67:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.98,
        "reason": "The matched characters are Markdown code fences or inline code terminology, not Ruby or shell backtick execution. No executable shell or Ruby backtick expression appears at this location."
      },
      {
        "id": "external_commands:SKILL.md:82:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.98,
        "reason": "The matched characters are Markdown code fences or inline code terminology, not Ruby or shell backtick execution. No executable shell or Ruby backtick expression appears at this location."
      },
      {
        "id": "external_commands:SKILL.md:87:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.98,
        "reason": "The matched characters are Markdown code fences or inline code terminology, not Ruby or shell backtick execution. No executable shell or Ruby backtick expression appears at this location."
      },
      {
        "id": "network:SKILL.md:10:hardcoded-url",
        "verdict": "false_positive",
        "confidence": 0.99,
        "reason": "This is a repository homepage or metadata URL, not a network request. No data transmission or automatic remote fetch is specified at this location."
      },
      {
        "id": "network:SKILL.md:13:hardcoded-url",
        "verdict": "false_positive",
        "confidence": 0.99,
        "reason": "This is a repository homepage or metadata URL, not a network request. No data transmission or automatic remote fetch is specified at this location."
      },
      {
        "id": "filesystem:SKILL.md:20:path-traversal-sequence",
        "verdict": "false_positive",
        "confidence": 0.95,
        "reason": "This is documentation navigation or a scoped file reference, not a filesystem operation using attacker-controlled traversal. No evidence of arbitrary file access or path resolution outside the skill context was found."
      },
      {
        "id": "filesystem:SKILL.md:40:path-traversal-sequence",
        "verdict": "false_positive",
        "confidence": 0.95,
        "reason": "This is documentation navigation or a scoped file reference, not a filesystem operation using attacker-controlled traversal. No evidence of arbitrary file access or path resolution outside the skill context was found."
      },
      {
        "id": "filesystem:SKILL.md:44:path-traversal-sequence",
        "verdict": "false_positive",
        "confidence": 0.95,
        "reason": "This is documentation navigation or a scoped file reference, not a filesystem operation using attacker-controlled traversal. No evidence of arbitrary file access or path resolution outside the skill context was found."
      },
      {
        "id": "filesystem:SKILL.md:48:path-traversal-sequence",
        "verdict": "false_positive",
        "confidence": 0.95,
        "reason": "This is documentation navigation or a scoped file reference, not a filesystem operation using attacker-controlled traversal. No evidence of arbitrary file access or path resolution outside the skill context was found."
      },
      {
        "id": "filesystem:SKILL.md:52:path-traversal-sequence",
        "verdict": "false_positive",
        "confidence": 0.95,
        "reason": "This is documentation navigation or a scoped file reference, not a filesystem operation using attacker-controlled traversal. No evidence of arbitrary file access or path resolution outside the skill context was found."
      },
      {
        "id": "filesystem:SKILL.md:54:path-traversal-sequence",
        "verdict": "false_positive",
        "confidence": 0.95,
        "reason": "This is documentation navigation or a scoped file reference, not a filesystem operation using attacker-controlled traversal. No evidence of arbitrary file access or path resolution outside the skill context was found."
      },
      {
        "id": "filesystem:SKILL.md:58:path-traversal-sequence",
        "verdict": "false_positive",
        "confidence": 0.95,
        "reason": "This is documentation navigation or a scoped file reference, not a filesystem operation using attacker-controlled traversal. No evidence of arbitrary file access or path resolution outside the skill context was found."
      },
      {
        "id": "filesystem:SKILL.md:68:path-traversal-sequence",
        "verdict": "false_positive",
        "confidence": 0.95,
        "reason": "This is documentation navigation or a scoped file reference, not a filesystem operation using attacker-controlled traversal. No evidence of arbitrary file access or path resolution outside the skill context was found."
      },
      {
        "id": "filesystem:SKILL.md:69:path-traversal-sequence",
        "verdict": "false_positive",
        "confidence": 0.95,
        "reason": "This is documentation navigation or a scoped file reference, not a filesystem operation using attacker-controlled traversal. No evidence of arbitrary file access or path resolution outside the skill context was found."
      },
      {
        "id": "filesystem:SKILL.md:82:path-traversal-sequence",
        "verdict": "confirmed",
        "confidence": 0.52,
        "reason": "The skill instructs an agent to save a result under a memory path after user confirmation. The intended operation is bounded, but the subject-derived filename must be sanitized to prevent an unsafe path.",
        "severity": "high"
      },
      {
        "id": "filesystem:SKILL.md:88:path-traversal-sequence",
        "verdict": "false_positive",
        "confidence": 0.95,
        "reason": "This is documentation navigation or a scoped file reference, not a filesystem operation using attacker-controlled traversal. No evidence of arbitrary file access or path resolution outside the skill context was found."
      },
      {
        "id": "filesystem:SKILL.md:89:path-traversal-sequence",
        "verdict": "false_positive",
        "confidence": 0.95,
        "reason": "This is documentation navigation or a scoped file reference, not a filesystem operation using attacker-controlled traversal. No evidence of arbitrary file access or path resolution outside the skill context was found."
      },
      {
        "id": "filesystem:SKILL.md:93:path-traversal-sequence",
        "verdict": "false_positive",
        "confidence": 0.95,
        "reason": "This is documentation navigation or a scoped file reference, not a filesystem operation using attacker-controlled traversal. No evidence of arbitrary file access or path resolution outside the skill context was found."
      },
      {
        "id": "filesystem:SKILL.md:94:path-traversal-sequence",
        "verdict": "false_positive",
        "confidence": 0.95,
        "reason": "This is documentation navigation or a scoped file reference, not a filesystem operation using attacker-controlled traversal. No evidence of arbitrary file access or path resolution outside the skill context was found."
      },
      {
        "id": "filesystem:SKILL.md:95:path-traversal-sequence",
        "verdict": "false_positive",
        "confidence": 0.95,
        "reason": "This is documentation navigation or a scoped file reference, not a filesystem operation using attacker-controlled traversal. No evidence of arbitrary file access or path resolution outside the skill context was found."
      },
      {
        "id": "filesystem:SKILL.md:96:path-traversal-sequence",
        "verdict": "false_positive",
        "confidence": 0.95,
        "reason": "This is documentation navigation or a scoped file reference, not a filesystem operation using attacker-controlled traversal. No evidence of arbitrary file access or path resolution outside the skill context was found."
      },
      {
        "id": "filesystem:SKILL.md:97:path-traversal-sequence",
        "verdict": "false_positive",
        "confidence": 0.95,
        "reason": "This is documentation navigation or a scoped file reference, not a filesystem operation using attacker-controlled traversal. No evidence of arbitrary file access or path resolution outside the skill context was found."
      },
      {
        "id": "blocker:SKILL.md:52:system-reconnaissance",
        "verdict": "false_positive",
        "confidence": 0.98,
        "reason": "This describes supported email clients, rendering behavior, or product defaults. It does not collect host information or perform system reconnaissance."
      },
      {
        "id": "blocker:SKILL.md:62:system-reconnaissance",
        "verdict": "false_positive",
        "confidence": 0.98,
        "reason": "This describes supported email clients, rendering behavior, or product defaults. It does not collect host information or perform system reconnaissance."
      },
      {
        "id": "blocker:SKILL.md:65:system-reconnaissance",
        "verdict": "false_positive",
        "confidence": 0.98,
        "reason": "This describes supported email clients, rendering behavior, or product defaults. It does not collect host information or perform system reconnaissance."
      },
      {
        "id": "blocker:SKILL.md:71:system-reconnaissance",
        "verdict": "false_positive",
        "confidence": 0.98,
        "reason": "This describes supported email clients, rendering behavior, or product defaults. It does not collect host information or perform system reconnaissance."
      },
      {
        "id": "blocker:SKILL.md:78:system-reconnaissance",
        "verdict": "false_positive",
        "confidence": 0.98,
        "reason": "This describes supported email clients, rendering behavior, or product defaults. It does not collect host information or perform system reconnaissance."
      }
    ],
    "semantic_findings": [],
    "critical_findings": [],
    "high_findings": [
      {
        "title": "Path traversal sequence",
        "description": "On user confirmation, save to `memory/email/email-render-builder/YYYY-MM-DD-<subject-slug>.md` — see",
        "locations": [
          {
            "file": "SKILL.md",
            "line_start": 82,
            "line_end": 82
          }
        ],
        "review_kind": "capability",
        "source_category": "filesystem",
        "source_severity": "high",
        "confidence": 0.52,
        "confidence_reasoning": "The skill instructs an agent to save a result under a memory path after user confirmation. The intended operation is bounded, but the subject-derived filename must be sanitized to prevent an unsafe path."
      }
    ],
    "medium_findings": [
      {
        "title": "Ruby/shell backtick execution",
        "description": "**Zero-dependency render-test send (when Resend is the ESP)**: `python3 \"${CLAUDE_PLUGIN_ROOT}/scrip",
        "locations": [
          {
            "file": "SKILL.md",
            "line_start": 54,
            "line_end": 54
          }
        ],
        "review_kind": "capability",
        "source_category": "external_commands",
        "source_severity": "medium",
        "confidence": 0.78,
        "confidence_reasoning": "The documented Python command can deliver email when invoked with --live. It is limited to a verified sender and the user's own test inboxes, but it remains an external side effect that requires explicit confirmation."
      }
    ],
    "low_findings": [],
    "dangerous_patterns": [],
    "files_scanned": 3,
    "total_lines": 192,
    "audit_model": "claude",
    "audited_at": "2026-07-26T10:17:01.997Z",
    "agent_auto_install_policy": "allowed",
    "manual_install_policy": "allowed"
  },
  "content": {
    "user_title": "Build responsive email HTML with render QA",
    "value_statement": "Email HTML can fail across clients, dark mode, and image-off settings. This skill creates table-based builds and documents rendering, accessibility, and plain-text checks.",
    "seo_keywords": [
      "Claude",
      "Codex",
      "Claude Code",
      "email HTML",
      "responsive email",
      "email render QA",
      "Outlook email",
      "dark mode email",
      "email accessibility",
      "bulletproof buttons"
    ],
    "actual_capabilities": [
      "Creates single-column, table-based email HTML from approved creative.",
      "Recommends responsive layout patterns for Gmail, Outlook, Apple Mail, and mobile clients.",
      "Checks dark-mode color pairs, image-off fallbacks, and bulletproof CTA requirements.",
      "Produces an accessibility checklist for alt text, reading order, language, contrast, and mobile font size.",
      "Builds a client-render matrix that distinguishes estimated results from measured tests.",
      "Compares HTML and plain-text content for message, CTA, and destination parity."
    ],
    "limitations": [
      "It does not write or revise email marketing copy.",
      "It cannot claim measured rendering without a real seed or preview test.",
      "It does not replace ESP-specific validation or paid rendering-preview services.",
      "Live render-test sends require an approved sender, user-owned test inboxes, and explicit confirmation."
    ],
    "use_cases": [
      {
        "title": "Build a promotion email",
        "description": "Turn approved campaign copy into a responsive table-based email with a clear CTA and image-off fallbacks.",
        "target_user": "Email marketer"
      },
      {
        "title": "Repair an Outlook layout",
        "description": "Review supplied email HTML and identify table, dark-mode, or image fallback changes for Outlook and other target clients.",
        "target_user": "Email developer"
      },
      {
        "title": "Prepare a newsletter handoff",
        "description": "Create a render matrix, accessibility checklist, and plain-text parity notes before ESP delivery.",
        "target_user": "Lifecycle marketing team"
      }
    ],
    "prompt_templates": [
      {
        "title": "Create a basic email build",
        "scenario": "Beginner",
        "prompt": "Build responsive email HTML from this approved subject, preheader, body, CTA, and destination URL: [paste creative]. Use a single-column table layout."
      },
      {
        "title": "Check client rendering",
        "scenario": "Intermediate",
        "prompt": "QA this email HTML for Gmail, Outlook desktop and web, Apple Mail, iOS, and Android. List dark-mode, image-off, and responsive risks as Estimated unless tested: [paste HTML]."
      },
      {
        "title": "Fix a rendering issue",
        "scenario": "Advanced",
        "prompt": "This email breaks in Outlook and loses meaning when images are off. Revise the supplied HTML with table-safe structure, bulletproof CTAs, and fallbacks. Keep the approved copy unchanged: [paste HTML]."
      },
      {
        "title": "Prepare an audited handoff",
        "scenario": "Advanced",
        "prompt": "Build and QA this newsletter from the approved creative. Return HTML, a client-render matrix, accessibility results, image-off notes, and a plain-text alternate with matching CTA and destination: [paste creative]."
      }
    ],
    "output_examples": [
      {
        "input": "Approved promotion copy, CTA, destination URL, and brand colors.",
        "output": [
          "Responsive table-based email build",
          "Dark-mode and image-off fallback notes",
          "Accessibility checklist and client-render matrix",
          "Plain-text alternate with matching CTA and URL"
        ]
      },
      {
        "input": "Existing email HTML that fails in Outlook.",
        "output": [
          "Outlook-specific layout findings",
          "Recommended table and button corrections",
          "Estimated rendering status for each requested client"
        ]
      },
      {
        "input": "Newsletter HTML without a plain-text version.",
        "output": [
          "Plain-text alternate that preserves the core message",
          "Parity check for the primary CTA and destination URL"
        ]
      }
    ],
    "best_practices": [
      "Provide approved copy, the destination URL, target clients, and brand constraints before requesting a build.",
      "Treat untested client behavior as estimated and verify critical sends with user-owned seed inboxes.",
      "Keep the plain-text message, CTA, and destination aligned with the HTML version."
    ],
    "anti_patterns": [
      "Do not use image-only offers or CTA buttons that disappear when images are blocked.",
      "Do not present support-matrix expectations as measured rendering results.",
      "Do not ask this skill to rewrite approved marketing copy or score campaign quality."
    ],
    "faq": [
      {
        "question": "Does this skill write email copy?",
        "answer": "No. It uses approved copy to build and QA the HTML email."
      },
      {
        "question": "Which email clients does it cover?",
        "answer": "It supports QA guidance for Gmail, Outlook, Apple Mail, iOS Mail, and Android clients."
      },
      {
        "question": "Can it verify real rendering?",
        "answer": "Only with a real seed or preview test. Otherwise it labels results as estimated."
      },
      {
        "question": "Does it handle dark mode?",
        "answer": "Yes. It checks foreground and background colors and documents dark-mode rendering risks."
      },
      {
        "question": "Can it send a test email?",
        "answer": "It can document an optional render-test command for supported ESP setups. A live send needs explicit confirmation and user-owned test inboxes."
      },
      {
        "question": "Does it create a plain-text version?",
        "answer": "Yes. It can produce or compare a plain-text alternate for message, CTA, and destination parity."
      }
    ]
  },
  "file_structure": [
    {
      "name": "references",
      "type": "dir",
      "path": "references",
      "children": [
        {
          "name": "client-render-matrix.md",
          "type": "file",
          "path": "references/client-render-matrix.md",
          "lines": 37
        },
        {
          "name": "email-render-specs.md",
          "type": "file",
          "path": "references/email-render-specs.md",
          "lines": 57
        }
      ]
    },
    {
      "name": "SKILL.md",
      "type": "file",
      "path": "SKILL.md",
      "lines": 98
    }
  ]
}
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