skills/cloudflare-dns/SKILL.md
Manage Cloudflare DNS records via the API — add, update, or delete subdomains (A, AAAA, CNAME, TXT, MX). Use when user wants to add a subdomain, point a DNS record, create/update/delete DNS entries on Cloudflare, or set up a custom domain for a hosted app (Fly, Vercel, Render, etc.).
npx skillsauth add RonanCodes/ronan-skills cloudflare-dnsInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
Manage DNS records on Cloudflare via the API v4. Typical use: pointing a subdomain at a Fly.io / Vercel / Render hostname.
/ro:cloudflare-dns add api.myapp.com CNAME myapp.fly.dev --proxied
/ro:cloudflare-dns list myapp.com
/ro:cloudflare-dns update <record-id> <zone-id> --content new-target.fly.dev
/ro:cloudflare-dns delete api.myapp.com
Check in order for CLOUDFLARE_API_TOKEN (required) and optionally CLOUDFLARE_ZONE_ID, CLOUDFLARE_ACCOUNT_ID:
${CLAUDE_PLUGIN_DATA}/.env (preferred — plugin-wide, survives updates)~/.config/ro/.env.envExpected shape:
CLOUDFLARE_API_TOKEN=... # required
CLOUDFLARE_ZONE_ID=... # optional: skips lookup in step 2
CLOUDFLARE_ACCOUNT_ID=... # optional: needed for tunnels/workers
If token missing: direct user to https://dash.cloudflare.com/profile/api-tokens → Create Token → template "Edit zone DNS" (scopes: Zone:DNS:Edit, Zone:Zone:Read; add Tunnel:Edit if you also plan to use tunnels). Save:
mkdir -p "$CLAUDE_PLUGIN_DATA" && chmod 700 "$CLAUDE_PLUGIN_DATA"
cat >> "$CLAUDE_PLUGIN_DATA/.env" <<'EOF'
CLOUDFLARE_API_TOKEN=...
CLOUDFLARE_ZONE_ID=...
CLOUDFLARE_ACCOUNT_ID=...
EOF
chmod 600 "$CLAUDE_PLUGIN_DATA/.env"
If CLOUDFLARE_ZONE_ID is already in the env and matches the apex of the record you're editing, skip the lookup. Otherwise resolve it:
ZONE_ID=$(curl -s "https://api.cloudflare.com/client/v4/zones?name=myapp.com" \
-H "Authorization: Bearer $CLOUDFLARE_API_TOKEN" | jq -r '.result[0].id')
Quick sanity check when using the env zone ID:
curl -s "https://api.cloudflare.com/client/v4/zones/$CLOUDFLARE_ZONE_ID" \
-H "Authorization: Bearer $CLOUDFLARE_API_TOKEN" | jq -r '.result.name'
If null: the domain isn't on Cloudflare or the token lacks Zone:Zone:Read. Stop and tell the user.
Base URL: https://api.cloudflare.com/client/v4/zones/$ZONE_ID/dns_records
Add (POST):
curl -s -X POST "$BASE" \
-H "Authorization: Bearer $CLOUDFLARE_API_TOKEN" \
-H "Content-Type: application/json" \
-d '{"type":"CNAME","name":"api","content":"myapp.fly.dev","ttl":1,"proxied":true}'
ttl: 1 = autoproxied: true = orange cloud (Cloudflare in front). Use false for Fly.io custom domains that need direct TLS termination on Fly.List (GET): curl -s "$BASE?name=api.myapp.com" -H "Authorization: Bearer $CLOUDFLARE_API_TOKEN" — returns record id + current values.
Update (PATCH $BASE/<record_id>): send only changed fields.
Delete (DELETE $BASE/<record_id>): always confirm with the user first — deleting DNS can drop production traffic.
After a write, re-fetch the record and show the user the final name, type, content, proxied, ttl. Mention propagation: Cloudflare is fast (~seconds) but downstream resolvers may cache for up to TTL.
When chaining with /ro:fly-deploy:
flyctl certs create api.myapp.com -a <app> → fly returns required DNS records_acme-challenge.api.myapp.com → <app>.fly.dev) with proxied: falseapi.myapp.com record as either:
<app>.fly.dev (proxied: false — let Fly terminate TLS), ORflyctl ips list -a <app> (proxied: true OK)flyctl certs show api.myapp.com -a <app> — wait for Issued statusZone:DNS:Edit scopeerrors[].code: 81057: Record already exists — list first, then PATCH instead of POSTerrors[].code: 1004: Bad DNS content (e.g. CNAME pointing to raw IP)success: false: Surface the errors[] array verbatim to the userCLOUDFLARE_API_TOKEN valuetesting
--- name: linear-pipeline description: The Fable orchestrator for a single dispatched Linear ticket. Holds almost no context itself; it receives `--issue <ID> --detached`, decides the stage sequence, and fans out a sub-agent per stage, passing forward only each stage's artifact (never re-derived, never inlined into its own context). Step zero, before any planning or stage routing, is a boundary triage against `canon/security-boundary.md` (#199): a match tags Ronan Connolly and stops the run, no
development
--- name: in-your-face description: Capture a chat-only answer into a durable artifact (markdown + HTML, PDF when cheap) and launch it automatically so the user cannot miss it. Use when user says "in your face", "don't let me lose this", "save that answer", "make that durable", or right after answering a substantive side question (a recipe, comparison, how-to, or generated prompt) that would otherwise die with the context. category: workflow argument-hint: [--no-open] [--vault <short>] [hint of
tools
One-shot headless OpenAI Codex CLI calls for background/admin AI tasks — summaries, classification, extraction, admin glue. The default engine for anything that runs AI constantly in the background (daemon-driven, per-event), because it bills the flat ChatGPT subscription instead of Claude usage or per-token API spend, and it keeps working while Claude is rate-limited. NEVER for coding — coding stays Claude. Use when a skill or daemon needs a cheap always-on AI call, when the user says "use codex", "ask codex", "codex as backup", or when building a background summarizer/classifier into a listener or loop. Reads auth from ~/.codex/auth.json (ChatGPT account, no API key).
research
Turn a warranty rejection, repair quote, or RMA email into a cited decision brief — legal read (NL/EU consumer law), is the part user-serviceable, live part and new-unit prices, repair-vs-DIY-vs-new economics, before-you-send-it checklist, deadlines. Use when the user pastes or screenshots a repair quote, warranty rejection, "not covered" email, onderzoekskosten fee, or asks "should I repair or replace this".