Agent skill

Mailchimp

by HybridAIOne in HybridAIOne/hybridclaw

Operate Mailchimp Marketing audiences, campaigns, reports, automations, journeys, and Mailchimp Transactional/Mandrill email through SecretRef-backed helper requests.

MITAuto-check passedMarketing & SEO

Install Mailchimp

skills CLI
$ npx skills add HybridAIOne/hybridclaw --skill mailchimp -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install HybridAIOne/hybridclaw mailchimp --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/HybridAIOne/hybridclaw.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/mailchimp .claude/skills/mailchimp && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
mailchimp
GitHub stars
158
Token cost
~3.6k tokens
SKILL.md length
747 words
Files
2
Skills in repo
71
Repo updated
First seen
Licence
MIT

At a glance

Operate Mailchimp Marketing audiences, campaigns, reports, automations, journeys, and Mailchimp Transactional/Mandrill email through SecretRef-backed helper requests.

  • Works in 7 steps: Start with credential-check when setup… → Use mailchimp.cjs noun/verb commands for… → Treat MAILCHIMP_MARKETING_BASIC_AUTH,… → …
  • Tasks that involve Email marketing
  • SKILL.md covers Default Workflow, Command Contract, Approval And Safety Boundaries and Credential Notes, plus 1 more section
  • Runs JavaScript scripts from its folder; calls node; needs MAILCHIMP_MARKETING_OAUTH_TOKEN and MANDRILL_API_KEY

What it does

Mailchimp is an agent skill from HybridAIOne/hybridclaw. Operate Mailchimp Marketing audiences, campaigns, reports, automations, journeys, and Mailchimp Transactional/Mandrill email through SecretRef-backed helper requests.

Its SKILL.md is about 3.6k tokens, which your agent loads only when the skill is triggered. The skill folder holds 1 other file.

It sits in Marketing & SEO, covering Email marketing. It works with Mailchimp. The repository describes itself as: Enterprise-ready self-hosted AI assistant runtime with sandboxed execution, secure credentials, approvals, and memory. The licence is MIT.

When your agent uses it

  • Tasks that involve Email marketing

Example prompts

  • “/mailchimp”

Requirements

  • A credential in MAILCHIMP_MARKETING_OAUTH_TOKEN
  • A credential in MANDRILL_API_KEY

Workflow steps

7 steps, taken from the first numbered list in SKILL.md.

  1. Start with credential-check when setup is uncertain. The helper emits
  2. Use mailchimp.cjs noun/verb commands for live work. Normal commands send
  3. Treat MAILCHIMP_MARKETING_BASIC_AUTH, MAILCHIMP_MARKETING_OAUTH_TOKEN,
  4. For audience writes, bulk subscriber plans, campaign draft/content writes,
  5. For 401 or 403, stop after the first failure and ask the operator to verify
  6. For 429, report rate-limit guidance from Retry-After or Mailchimp
  7. Minimize subscriber PII in summaries. Prefer subscriber hashes for lookup and

What it can do on your machine

Read from SKILL.md and the folder at commit 3624072. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Ships script files (JavaScript), which the agent can run.

    Shell commands in SKILL.md call:

    • node

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names these keys or tokens, usually read from environment variables:

    • MAILCHIMP_MARKETING_OAUTH_TOKEN
    • MANDRILL_API_KEY

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Mailchimp loads about 3.6k tokens when it runs. Until then it costs about 44 tokens; SKILL.md has 747 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~44
When it runs · the whole SKILL.md, loaded when a task matches
~3.6k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from HybridAIOne/hybridclaw at commit 3624072, republished under its MIT licence (© HybridAIOne). 747 words, ~3,614 tokens.

Download SKILL.mdSave it as .claude/skills/mailchimp/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
name
mailchimp
description
Operate Mailchimp Marketing audiences, campaigns, reports, automations, journeys, and Mailchimp Transactional/Mandrill email through SecretRef-backed helper requests.
user-invocable
true
requires.bins
node

Mailchimp

Use this skill for Mailchimp Marketing and Mailchimp Transactional work: audience/list inspection, subscriber lookup and controlled mutations, tags, merge fields, campaign draft operations, campaign content, scheduling/sending, campaign reports, automation and journey readouts, and Mandrill transactional message lookup or sends.

Default Workflow

  1. Start with credential-check when setup is uncertain. The helper emits gateway-resolved <env:...> and <secret:...> placeholders; it does not read runtime env or secret values itself. Missing MAILCHIMP_SERVER_PREFIX, MAILCHIMP_MARKETING_BASIC_AUTH, MAILCHIMP_MARKETING_OAUTH_TOKEN, or MANDRILL_API_KEY is surfaced by the gateway placeholder resolver or by a 401/403 upstream response. Do not run hybridclaw secret list, hybridclaw env list, grep, or local file inspection from the agent sandbox to decide whether Mailchimp values are configured; those checks can see the wrong runtime surface. For stored OAuth access tokens, use oauth metadata --auth oauth to retrieve the account-specific API endpoint and set MAILCHIMP_SERVER_PREFIX from the returned API endpoint host.
  2. Use mailchimp.cjs noun/verb commands for live work. Normal commands send the helper-built request through the HybridClaw gateway /api/http/request path, so the gateway resolves <env:...> and <secret:...> placeholders server-side. Use --request only for dry-run/debug output; do not normally reconstruct or relay httpRequest objects with the built-in http_request tool.
  3. Treat MAILCHIMP_MARKETING_BASIC_AUTH, MAILCHIMP_MARKETING_OAUTH_TOKEN, and MANDRILL_API_KEY as SecretRefs only. Never ask the operator to paste tokens into chat, never print raw Authorization headers, and never include Mandrill keys in --body-json.
  4. For audience writes, bulk subscriber plans, campaign draft/content writes, campaign schedule/send, and Mandrill sends, first run approval-plan, show the preview, and stop. After explicit operator approval for the named audience, campaign, or message target, run the approved helper command unchanged.
  5. For 401 or 403, stop after the first failure and ask the operator to verify the token, user role, Transactional provisioning, and data-center prefix. Do not retry with broader permissions.
  6. For 429, report rate-limit guidance from Retry-After or Mailchimp rate-limit headers when present. Do not start retry loops.
  7. Minimize subscriber PII in summaries. Prefer subscriber hashes for lookup and archive/tag operations. Include email addresses only when required to create or update a member.

Command Contract

Use the standard helper shape:

text
node skills/mailchimp/mailchimp.cjs [--format json|pretty] [--request] <resource> <action> [flags]
node skills/mailchimp/mailchimp.cjs [--format json|pretty] approval-plan <resource> <action> [flags]
bash
node skills/mailchimp/mailchimp.cjs --help
node skills/mailchimp/mailchimp.cjs --format json credential-check
node skills/mailchimp/mailchimp.cjs --format json oauth metadata --auth oauth
node skills/mailchimp/mailchimp.cjs --format json --request oauth metadata --auth oauth

Run Marketing reads:

bash
node skills/mailchimp/mailchimp.cjs --format json marketing root
node skills/mailchimp/mailchimp.cjs --format json audience list --count 25
node skills/mailchimp/mailchimp.cjs --format json audience members --list-id <list-id> --status subscribed
node skills/mailchimp/mailchimp.cjs --format json audience member --list-id <list-id> --email user@example.com
node skills/mailchimp/mailchimp.cjs --format json audience merge-fields --list-id <list-id>

Run guarded audience mutations only after approval:

bash
node skills/mailchimp/mailchimp.cjs --format json approval-plan audience member-upsert \
  --list-id <list-id> --email user@example.com --status-if-new pending \
  --merge-fields-json '{"FNAME":"Ada"}' --tag customer:active

node skills/mailchimp/mailchimp.cjs --format json approval-plan audience tags-update \
  --list-id <list-id> --email user@example.com --tag vip:active --tag stale:inactive

node skills/mailchimp/mailchimp.cjs --format json approval-plan audience member-archive \
  --list-id <list-id> --email user@example.com

node skills/mailchimp/mailchimp.cjs --format json approval-plan audience bulk-plan \
  --list-id <list-id> --operation member-upsert --count 2500 \
  --source-label imports/2026-06-newsletter.csv \
  --sample-json '{"email":"user@example.com","status_if_new":"pending","FNAME":"Ada"}'

Run campaign requests:

bash
node skills/mailchimp/mailchimp.cjs --format json campaign list --status save
node skills/mailchimp/mailchimp.cjs --format json approval-plan campaign create --body-json '{"type":"regular","recipients":{"list_id":"<list-id>"},"settings":{"subject_line":"Subject","title":"Draft","from_name":"Team","reply_to":"team@example.com"}}'
node skills/mailchimp/mailchimp.cjs --format json approval-plan campaign content-set --campaign-id <campaign-id> --body-json '{"html":"<p>Hello</p>"}'
node skills/mailchimp/mailchimp.cjs --format json approval-plan campaign schedule --campaign-id <campaign-id> --schedule-time 2026-06-01T09:00:00+00:00
node skills/mailchimp/mailchimp.cjs --format json approval-plan campaign send --campaign-id <campaign-id>

Run report and read-only automation/journey requests:

bash
node skills/mailchimp/mailchimp.cjs --format json campaign report --campaign-id <campaign-id> --kind overview
node skills/mailchimp/mailchimp.cjs --format json campaign report --campaign-id <campaign-id> --kind bounces
node skills/mailchimp/mailchimp.cjs --format json campaign report --campaign-id <campaign-id> --kind opens
node skills/mailchimp/mailchimp.cjs --format json campaign report --campaign-id <campaign-id> --kind clicks
node skills/mailchimp/mailchimp.cjs --format json campaign report --campaign-id <campaign-id> --kind email-activity
node skills/mailchimp/mailchimp.cjs --format json automation list
node skills/mailchimp/mailchimp.cjs --format json journey list

Run Mandrill transactional requests:

bash
node skills/mailchimp/mailchimp.cjs --format json mandrill message-info --id <message-id>
node skills/mailchimp/mailchimp.cjs --format json approval-plan mandrill send --body-json '{"message":{"from_email":"ops@example.com","to":[{"email":"user@example.com","type":"to"}],"subject":"Receipt","text":"Thanks"}}'
node skills/mailchimp/mailchimp.cjs --format json approval-plan mandrill send-template --body-json '{"template_name":"receipt","template_content":[],"message":{"to":[{"email":"user@example.com","type":"to"}],"merge":true}}'

Classify a saved or live error:

bash
node skills/mailchimp/mailchimp.cjs --format json classify-response --status 401 --body-json '{"title":"API Key Invalid"}'
node skills/mailchimp/mailchimp.cjs --format json classify-response --gateway-error 'Stored secret MAILCHIMP_MARKETING_BASIC_AUTH is not set.'
Show full SKILL.md (371 more words)Show less

Approval And Safety Boundaries

Green operations are read-only inventory, lookup, report, automation, journey, and message-status calls. Amber operations mutate external Mailchimp state but do not send mail by themselves. Red operations can send or schedule external email and require explicit operator approval for the named campaign or message target.

--operator-grant is an approval-workflow marker for this helper, not an access-control boundary. The gateway approval policy, network policy, and credential resolver remain the actual enforcement layers for external writes and sends.

Bulk member mutation is intentionally exposed as a preview/approval boundary, not as a direct batch execution command. For more than one subscriber, run approval-plan audience bulk-plan with the target list, operation, source label, count, and a redacted sample row. After approval, generate exact per-member helper commands and run them with --operator-grant. Do not call Mailchimp batch endpoints from this skill.

Unsupported destructive operations include permanent member deletion, campaign delete, audience delete, and Mandrill scheduled-message cancel/reschedule. The helper exposes archive and tag changes, not irreversible data deletion.

Credential Notes

Mailchimp Marketing uses https://<dc>.api.mailchimp.com/3.0, where <dc> is the data-center subdomain for the account. API keys usually include this as the suffix after the last hyphen. The helper defaults to --auth api-key, which uses Authorization: Basic <secret:MAILCHIMP_MARKETING_BASIC_AUTH> and https://<env:MAILCHIMP_SERVER_PREFIX>.api.mailchimp.com/3.0/... so the gateway resolves both values server-side. Store the secret value as the base64 encoding of anystring:<api-key>, not the raw API key in prompt text.

OAuth access tokens are supported with --auth oauth and Authorization: OAuth <secret:MAILCHIMP_MARKETING_OAUTH_TOKEN>. This skill uses an already stored OAuth access token; it does not perform the browser OAuth authorization flow itself. Use oauth metadata --auth oauth to read the OAuth token metadata endpoint and derive the account-specific data-center prefix before calling Marketing API endpoints.

Mandrill requests place key: "<secret:MANDRILL_API_KEY>" in the JSON body so the gateway performs placeholder replacement server-side. Do not include a key field in --body-json; the helper rejects it.

Result Handling

Base answers on successful live API results only. For setup failures, report which layer failed: missing MAILCHIMP_SERVER_PREFIX, gateway missing runtime secret, gateway policy denial, outbound network failure, Mailchimp 401/403, Mailchimp 429, or upstream validation error. Do not infer stale gateway state or network isolation without checking hybridclaw gateway status, logs, and the returned helper/gateway error body.

© HybridAIOne, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 1 other file in skills/mailchimp of HybridAIOne/hybridclaw.

  • SKILL.md
  • mailchimp.cjs

Open the folder on GitHubat commit 3624072

Compare with similar skills

Mailchimp next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Mailchimp compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Mailchimp this skillHybridAIOne/hybridclaw158—~3.6kAutomated safety check: PassMIT
Mailchimp Integrationhewi333/Mom-n-Pop-Skills122—~2kAutomated safety check: PassMIT
CLI Anything MailchimpHKUDS/CLI-Anything52k—~2.4kAutomated safety check: PassApache-2.0
14 Email Marketing Globalminhnv0807/ai-business-skills610—~2.4kAutomated safety check: PassMIT
Ecommerce Email Marketing BuilderLeoYeAI/openclaw-master-skills2.2k1 repos~6.2kAutomated safety check: PassMIT
Connectindranilbanerjee/digital-marketing-pro8591 repos~2kAutomated safety check: PassMIT

Similar skills

  • Mailchimp Integration

    hewi333/Mom-n-Pop-Skills

    A skill your agent uses when integrating with Mailchimp for audience management, campaigns, and automation.

    122 GitHub stars~2k tokensUpdated 28 days ago
    Marketing & SEOAuto-check passed
  • CLI Anything Mailchimp

    HKUDS/CLI-Anything

    CLI harness for the Mailchimp Marketing API v3.0 — 303 commands across 30 resource groups (lists, campaigns, reports, automations, ecommerce, templates, and more).

    52k GitHub stars~2.4k tokensUpdated 18 days ago
    Marketing & SEOAuto-check passed
  • 14 Email Marketing Global

    minhnv0807/ai-business-skills

    A skill your agent uses when the user needs email or lifecycle automation — welcome series, nurture, abandoned cart, re-engagement, broadcast, and transactional flows with subject lines…

    610 GitHub stars~2.4k tokensUpdated 27 days ago
    Marketing & SEOAuto-check passed
  • Ecommerce Email Marketing Builder

    LeoYeAI/openclaw-master-skills

    E-commerce email marketing system builder. An agent skill from LeoYeAI/openclaw-master-skills.

    2.2k GitHub starsUsed in 1 repo~6.2k tokens
    Marketing & SEOAuto-check passed
  • Connect

    indranilbanerjee/digital-marketing-pro

    Guide the connection of a known MCP integration to the plugin — looks up the connector registry via connector-status.py, checks current status, and returns transport-specific setup steps (OAuth for…

    859 GitHub starsUsed in 1 repo~2k tokens
    Marketing & SEOAuto-check passed
  • Marketing Automation

    indranilbanerjee/digital-marketing-pro

    Design marketing automation programs — end-to-end workflow architecture, lead scoring models with MQL/SQL thresholds, nurture and drip sequences, behavioral triggers, lifecycle stage frameworks…

    859 GitHub starsUsed in 1 repo~4.7k tokens
    Marketing & SEOAuto-check passed

More from HybridAIOne/hybridclaw

All 71 skills in this repo
  • Hermes3000 Writing

    HybridAIOne/hybridclaw

    Use Hermes3000 to plan, draft, revise, save, check consistency, and export long-form manuscripts through the Hermes3000 AI writing portal API.

    158 GitHub stars~2.7k tokensUpdated today
    Auto-check passed
  • Manim Video

    HybridAIOne/hybridclaw

    Plan, script, render, and stitch Manim Community Edition videos in Python.

    158 GitHub stars~4.7k tokensUpdated today
    Auto-check: notes
  • Skill Creator

    HybridAIOne/hybridclaw

    Create and update SKILL.md-based skills with strong trigger metadata, lean docs, and reliable init, validate, package, and publish workflows.

    158 GitHub stars~2k tokensUpdated today
    Auto-check passed
  • XLSX

    HybridAIOne/hybridclaw

    Create, edit, inspect, and analyze .xlsx spreadsheets and Excel workbooks.

    158 GitHub stars~1.6k tokensUpdated today
    Auto-check passed
  • Excalidraw

    HybridAIOne/hybridclaw

    Create and revise editable .excalidraw diagrams as Excalidraw JSON for architecture diagrams, flowcharts, sequence diagrams, concept maps, and other hand-drawn explainers.

    158 GitHub stars~1.2k tokensUpdated today
    Auto-check passed
  • Google Ads

    HybridAIOne/hybridclaw

    Manage Google Ads accounts with safe GAQL reporting, campaign planning, guarded mutations, and gateway-proxied REST API calls.

    158 GitHub stars~4k tokensUpdated today
    Auto-check passed

Works with

Categories

Questions about Mailchimp

What does Mailchimp do?

Operate Mailchimp Marketing audiences, campaigns, reports, automations, journeys, and Mailchimp Transactional/Mandrill email through SecretRef-backed helper requests. Mailchimp is an agent skill from HybridAIOne/hybridclaw. Operate Mailchimp Marketing audiences, campaigns, reports, automations, journeys, and Mailchimp Transactional/Mandrill email through SecretRef-backed helper requests.

When should I use Mailchimp?

Mailchimp fits situations like: tasks that involve Email marketing.

How do I install Mailchimp in Claude Code?

Run `npx skills add HybridAIOne/hybridclaw --skill mailchimp -a claude-code`. Or copy the skill folder (skills/mailchimp in HybridAIOne/hybridclaw) into .claude/skills/mailchimp in your project. Claude Code loads it when a task matches its description.

How do I install Mailchimp in Codex?

Run `npx skills add HybridAIOne/hybridclaw --skill mailchimp -a codex`. Or copy the skill folder (skills/mailchimp in HybridAIOne/hybridclaw) into .agents/skills/mailchimp in your project. Codex loads it when a task matches its description.

Can I use Mailchimp in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add HybridAIOne/hybridclaw --skill mailchimp -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/mailchimp, .gemini/skills/mailchimp, .github/skills/mailchimp and .opencode/skills/mailchimp in your project.

What does Mailchimp need to run?

Going by SKILL.md and its folder, Mailchimp needs JavaScript for the scripts in its folder, the command-line tools its instructions call (node) and credentials named MAILCHIMP_MARKETING_OAUTH_TOKEN and MANDRILL_API_KEY. Our summary lists: A credential in MAILCHIMP_MARKETING_OAUTH_TOKEN; A credential in MANDRILL_API_KEY.

Does Mailchimp access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Mailchimp safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Mailchimp use?

Mailchimp is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Mailchimp use?

About 3.6k tokens (SKILL.md is roughly 14k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Mailchimp?

Skills that share tags, products or a category with Mailchimp: Mailchimp Integration (hewi333/Mom-n-Pop-Skills, 122 stars), CLI Anything Mailchimp (HKUDS/CLI-Anything, 52k stars), 14 Email Marketing Global (minhnv0807/ai-business-skills, 610 stars) and Ecommerce Email Marketing Builder (LeoYeAI/openclaw-master-skills, 2.2k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Mailchimp?

HybridAIOne (a GitHub organization) maintains it in HybridAIOne/hybridclaw, which has 158 GitHub stars. The repository holds 71 skills in this directory. The repository was last updated on October 9, 2026.

Source: HybridAIOne/hybridclaw on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.