mail-addr-creator

create one or many ordinary mailbox addresses in a cloudflare temporary mail system through the /admin/new_address admin api and return structured results. u...

Security Scan

The skill appears to do what it says — it runs a local Python script to call a specific admin API to create mailboxes and requests appropriate admin credentials for that purpose.

Purpose & Capability

The name/description (create mailbox addresses via the admin API) matches the included script and references. The script posts to the documented backend endpoint and accepts admin credentials and optional tokens that are required to perform the stated operation.

Instruction Scope

SKILL.md instructs the agent to run the shipped script and to supply or read admin credentials from the environment; the script only reads names (CLI, CSV/file), validates them, calls the API, and optionally writes CSV/JSON output. There are no instructions to read unrelated system files or send data to unexpected endpoints beyond the configurable API URL.

Install Mechanism

There is no install spec; this is an instruction-only skill with a bundled Python script. No external downloads or package installs are performed by the skill, lowering installation risk. It expects a Python runtime to execute the script.

Credentials

The runtime needs sensitive admin credentials (CLOUDFLARE_MAIL_ADMIN_AUTH) and optionally bearer/user tokens — these are proportionate for calling an admin create-address API. Minor inconsistency: the registry metadata lists no required environment variables, while SKILL.md and the script explicitly rely on specific CLOUDFLARE_MAIL_* env vars; you should supply a dedicated, least-privilege admin credential for this task.

Persistence & Privilege

always is false and the skill does not request persistent system privileges or modify other skills or global agent configs. It only runs the provided script when invoked.

Assessment

This package appears internally consistent: it runs the included Python script to POST to the documented admin endpoint and requires an admin auth token. Before installing, verify you trust the target API host (default: mail-api.suilong.online), review the included scripts yourself, and provide a dedicated, least-privilege admin credential (do not reuse unrelated keys). Note the registry metadata did not declare required env vars even though the SKILL.md and script expect them — make sure you supply the correct CLOUDFLARE_MAIL_ADMIN_AUTH (or pass it via CLI) and consider running the script in a sandboxed environment if you are unsure.

Cloudflare Mail Address Creator

Use this skill to create ordinary mailbox addresses through https://mail-api.suilong.online/admin/new_address.

Workflow

1. Collect or infer name, domain, and enablePrefix.
2. Default enablePrefix to true when the user does not specify it.
3. If the user gives a full address such as [e-mail], split it into name=t2 and domain=suilong.online.
4. Never hardcode real credentials in the skill. Read them from runtime environment variables or pass them as CLI flags.
5. Run python3 scripts/create_address.py for single or batch creation.
6. Return the script's JSON output directly unless the user asks for a reformatted summary.
7. Preserve the normalized statuses: created, already_exists, auth_error, error.
8. If local validation fails, fix the input before attempting the API call again.
9. Use --output-format csv and optionally --output-file <path> when the user asks for exportable results.

Commands

Single address:

python3 scripts/create_address.py \
  --name t2 \
  --domain suilong.online \
  --admin-auth "$CLOUDFLARE_MAIL_ADMIN_AUTH"

Single full address:

python3 scripts/create_address.py \
  --name [e-mail] \
  --admin-auth "$CLOUDFLARE_MAIL_ADMIN_AUTH"

Batch addresses from a comma-separated list:

python3 scripts/create_address.py \
  --names alice,bob,charlie \
  --domain suilong.online \
  --enable-prefix true \
  --admin-auth "$CLOUDFLARE_MAIL_ADMIN_AUTH"

Batch addresses from a file:

python3 scripts/create_address.py \
  --names-file ./names.txt \
  --domain suilong.online \
  --admin-auth "$CLOUDFLARE_MAIL_ADMIN_AUTH"

Export batch results as CSV:

python3 scripts/create_address.py \
  --names alice,bob,charlie \
  --domain suilong.online \
  --output-format csv \
  --output-file ./created-addresses.csv \
  --admin-auth "$CLOUDFLARE_MAIL_ADMIN_AUTH"

Runtime Environment

Prefer environment variables for secrets:

• CLOUDFLARE_MAIL_ADMIN_AUTH
• CLOUDFLARE_MAIL_BEARER_TOKEN
• CLOUDFLARE_MAIL_FINGERPRINT
• CLOUDFLARE_MAIL_LANG
• CLOUDFLARE_MAIL_USER_TOKEN
• CLOUDFLARE_MAIL_API_URL

Supporting Files

• Read references/api.md for the endpoint contract and error mapping.
• Read references/examples.md for example prompts and outputs.

OpenClaw Install Notes

Install this skill into an OpenClaw workspace under skills/cloudflare-mail-address-creator/, or globally under ~/.moltbot/skills/cloudflare-mail-address-creator/.

This package intentionally keeps only the OpenClaw-compatible skill files: SKILL.md, scripts/, and references/.