aiskillstore/marketplace / skills/aaron-he-zhu/email-render-builder
email-render-builder
VerifiedUse 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/响应式邮件/暗色模式渲染
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 13.4 KB |
| references/client-render-matrix.md | markdown | 2.2 KB |
| references/email-render-specs.md | markdown | 3.5 KB |
| skill-report.json | config | 52.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
}
]
}
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| rea-analysis-optimizationmorluto/reaOptimize REA providers and shared analysis workflows for agent context, latency, CPU, and memory while preserving correctness and Evidence. Use for analysis bottlenecks and cache or query design; CI/test-suite optimization belongs to rea-ci-tests-audit. | Stars: 472k | Updated | Claude CodeCodex | Verified | Install |
| rea-ci-tests-auditmorluto/reaAudit REA CI and test suites for correctness, fixture drift, false passes, and measured performance; use for suite or workflow investigations and efficiency changes, rather than ordinary feature testing or a single test failure. | Stars: 472k | Updated | Claude CodeCodex | Verified | Install |
| rea-tool-designmorluto/reaAudit, investigate, design, or change REA investigation tools, CLI/MCP contracts, provider capabilities, and Evidence semantics. | Stars: 472k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-auditDietrichGebert/ponytailQuality audit of the whole repo: bugs, security, real load, missing tests, speed, and what to delete. Most important first. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |