Agent skill

Cloudflare

by popmechanic in popmechanic/VibesOS

Self-contained deploy automation — invoke directly, do not decompose.

MITAuto-check: notesAgent Workflows

Install Cloudflare

skills CLI
$ npx skills add popmechanic/VibesOS --skill cloudflare -a claude-code

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

GitHub CLI
$ gh skill install popmechanic/VibesOS cloudflare --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/popmechanic/VibesOS.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/cloudflare .claude/skills/cloudflare && 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
cloudflare
GitHub stars
135
Token cost
~1.2k tokens
SKILL.md length
472 words
Files
1
Skills in repo
7
Repo updated
First seen
Licence
MIT

At a glance

Self-contained deploy automation — invoke directly, do not decompose.

  • Works in 2 steps: Assembled HTML file (from /vibes:vibes… → Vibes account (browser login on first…
  • Pushing to production
  • Calls bun
  • Hosting on the edge

What it does

Cloudflare is an agent skill from popmechanic/VibesOS. Self-contained deploy automation — invoke directly, do not decompose. Deploys a Vibes app to Cloudflare Workers via the Deploy API. Use when deploying, publishing, going live, pushing to production, or hosting on the edge.

Its SKILL.md is about 1.2k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Agent Workflows, covering Deployment. It works with Cloudflare and Cloudflare Workers. The repository describes itself as: A GUI for Claude Code that makes it easy to vibe code simple, un-hackable apps. The licence is MIT.

When your agent uses it

  • Pushing to production
  • Hosting on the edge

Example prompts

  • “/cloudflare”

Requirements

  • Pre-approved tools (allowed-tools): Bash, Read, Glob, AskUserQuestion, Write

Workflow steps

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

  1. Assembled HTML file (from /vibes:vibes or /vibes:factory)
  2. Vibes account (browser login on first deploy)

What it can do on your machine

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

  • Tool permissions

    Pre-approves these tools, so the agent can use them without asking each time:

    • Bash
    • Read
    • Glob
    • AskUserQuestion
    • Write

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • bun

    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 no API keys, tokens, secrets or passwords.

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

Context cost

Cloudflare loads about 1.2k tokens when it runs. Until then it costs about 58 tokens; SKILL.md has 472 words of instructions outside code blocks.

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

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: notes

The automated check noted patterns worth knowing about, such as sudo or a known installer.

  • NotePre-approves every shell command (allowed-tools: Bash)SKILL.md
    allowed-tools: Bash, Read, Glob, AskUserQuestion, Write

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 popmechanic/VibesOS at commit 5baf8a2, republished under its MIT licence (© popmechanic). 472 words, ~1,215 tokens.

Download SKILL.mdSave it as .claude/skills/cloudflare/SKILL.md (or your agent's skills folder).
name
cloudflare
description
Self-contained deploy automation — invoke directly, do not decompose. Deploys a Vibes app to Cloudflare Workers via the Deploy API. Use when deploying, publishing, going live, pushing to production, or hosting on the edge.
allowed-tools
Bash, Read, Glob, AskUserQuestion, Write
license
MIT
metadata.author
Marcus Estes

Plan mode: If you are planning work, this entire skill is ONE plan step: "Invoke /vibes:cloudflare". Do not decompose the steps below into separate plan tasks.

  ╔═══════════════════════════════════════════════╗
  ║   ☁️  CLOUDFLARE WORKERS DEPLOY               ║
  ║   Deploy API · Pocket ID · Edge Functions      ║
  ╚═══════════════════════════════════════════════╝

Deploy to Cloudflare

Deploy your Vibes app to Cloudflare Workers via the Deploy API.

Prerequisites
  1. Assembled HTML file (from /vibes:vibes or /vibes:factory)
  2. Vibes account (browser login on first deploy)

No Cloudflare account or wrangler CLI needed — the Deploy API handles infrastructure.

Quick Deploy
bash
VIBES_ROOT="${CLAUDE_PLUGIN_ROOT:-$(dirname "$(dirname "${CLAUDE_SKILL_DIR}")")}"
bun "$VIBES_ROOT/scripts/deploy-cloudflare.js" --name myapp --file index.html

On first run, a browser window opens for Pocket ID authentication. Tokens are cached for subsequent deploys.

Static Assets: Place images, fonts, or other static files in an assets/ directory next to the app file. The deploy script auto-discovers and includes them (binary files are base64-encoded). Reference in code with absolute paths like /assets/logo.png.

Deploy with AI enabled
bash
VIBES_ROOT="${CLAUDE_PLUGIN_ROOT:-$(dirname "$(dirname "${CLAUDE_SKILL_DIR}")")}"
bun "$VIBES_ROOT/scripts/deploy-cloudflare.js" --name myapp --file index.html --ai-key "sk-or-v1-your-key"

The --ai-key flag configures the OpenRouter API key for the useAI() hook. Without it, /api/ai/chat returns {"error": "AI not configured"}.

Endpoints
EndpointMethodDescription
/registry.jsonGETPublic registry read
/check/:subdomainGETCheck subdomain availability
/claimPOSTClaim a subdomain (auth required)
/api/ai/chatPOSTAI proxy to OpenRouter (requires AI key)
Important: Custom Domain Required for Subdomains

Workers.dev domains only support one subdomain level for SSL. For multi-tenant apps with subdomains (tenant.myapp.workers.dev), you MUST use a custom domain.

Won't work: tenant.myapp.username.workers.dev (SSL error) Will work: tenant.myapp.com (with custom domain)

On workers.dev, use the ?subdomain= query parameter for testing:

  • myapp.username.workers.dev → landing page
  • myapp.username.workers.dev?subdomain=tenant → tenant app
  • myapp.username.workers.dev?subdomain=admin → admin dashboard
Custom Domain Setup
  1. Add domain to Cloudflare (get nameservers from Cloudflare DNS dashboard)
  2. Point registrar nameservers to Cloudflare's assigned nameservers
  3. Delete conflicting DNS records for the apex domain (A, AAAA, CNAME)
  4. Add Custom Domain in Workers & Pages → your worker → Settings → Domains & Routes → Add → Custom Domain (apex: yourdomain.com)
  5. Add wildcard CNAME in DNS: Name: *, Target: <worker-name>.<username>.workers.dev (Proxied: ON)
  6. Add Route in Workers & Pages → your worker → Settings → Domains & Routes → Add → Route: *.yourdomain.com/*

After setup:

  • yourdomain.com → landing page
  • tenant.yourdomain.com → tenant app
  • admin.yourdomain.com → admin dashboard
Show full SKILL.md (150 more words)Show less
Troubleshooting
ProblemCauseFix
Browser doesn't open for authHeadless environmentCopy the printed URL and open manually
Deploy API returns 401Expired or invalid tokenDelete ~/.vibes/auth.json and retry
404 on subdomain URLWorkers.dev doesn't support nested subdomainsSet up a custom domain (see Custom Domain Setup above)
/api/ai/chat returns "AI not configured"Missing OpenRouter keyRedeploy with --ai-key
Stale content after redeployBrowser cacheHard refresh (Cmd+Shift+R) or clear cache
What's Next?

After successful deployment, present these options:

AskUserQuestion: question: "Your app is deployed! What would you like to do next?" header: "Next steps" options: - label: "Set up custom domain" description: "Configure DNS for subdomain routing (required for multi-tenant)" - label: "Enable AI features" description: "Add OpenRouter API key for the useAI() hook" - label: "Add auth & SaaS features" description: "Transform into SaaS with /vibes:factory, then redeploy" - label: "Open in browser" description: "Visit the deployed URL to verify everything works"

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

Files

Just SKILL.md in skills/cloudflare of popmechanic/VibesOS.

Open the folder on GitHubat commit 5baf8a2

Compare with similar skills

Cloudflare 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.

Cloudflare compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Cloudflare this skillpopmechanic/VibesOS135—~1.2kAutomated safety check: NotesMIT
Nextjs On Cloudflarecloudflare/skills3k2 repos~678Automated safety check: PassApache-2.0
Prepare Cloudflare Production DeploymentLubomirGeorgiev/cloudflare-workers-nextjs-saas-template786—~5.9kAutomated safety check: NotesMIT
Deploy Microfeedmicrofeed/microfeed4.1k—~6.6kAutomated safety check: PassAGPL-3.0
Cloudflare Temporary DeployLuciole-Studio/Misaka-Agent1582 repos~1.9kAutomated safety check: PassMIT
Wranglercloudflare/skills3k2 repos~2.8kAutomated safety check: PassApache-2.0

Similar skills

  • Nextjs On Cloudflare

    cloudflare/skills

    Official

    Build, migrate, and deploy Next.js apps on Cloudflare Workers with vinext.

    3k GitHub starsUsed in 2 repos~678 tokens
    DevOps & CloudAuto-check passed
  • Prepare Cloudflare Production Deployment

    LubomirGeorgiev/cloudflare-workers-nextjs-saas-template

    Source-of-truth runbook for preparing this Vinext Cloudflare Workers SaaS template for production deployment.

    786 GitHub stars~5.9k tokensUpdated 2 days ago
    DevOps & CloudAuto-check: notes
  • Deploy Microfeed

    microfeed/microfeed

    Deploy and administer microfeed through the source-code-free @microfeed/cli launcher or the project-owned yarn manage CLI.

    4.1k GitHub stars~6.6k tokensUpdated yesterday
    DevOps & CloudAuto-check passed
  • Cloudflare Temporary Deploy

    Luciole-Studio/Misaka-Agent

    Deploy a Worker live, no account, via wrangler --temporary. An agent skill from Luciole-Studio/Misaka-Agent.

    158 GitHub starsUsed in 2 repos~1.9k tokens
    DevOps & CloudAuto-check passed
  • Wrangler

    cloudflare/skills

    Official

    Run or troubleshoot Wrangler CLI commands and configure Worker projects for local development, Previews, deployment, and Cloudflare resource management.

    3k GitHub starsUsed in 2 repos~2.8k tokens
    DevOps & CloudAuto-check passed
  • Cloudflare Deploy

    JetBrains/skills

    Official

    Deploy applications and infrastructure to Cloudflare using Workers, Pages, and related platform services.

    366 GitHub starsUsed in 6 repos~1.8k tokens
    DevOps & CloudAuto-check passed

More from popmechanic/VibesOS

  • Factory

    popmechanic/VibesOS

    Self-contained SaaS pipeline — invoke directly, do not decompose.

    135 GitHub stars~3.1k tokensUpdated 2 mo ago
    Auto-check: notes
  • Vibes

    popmechanic/VibesOS

    Self-contained app generator — invoke this skill directly, do not decompose into sub-steps.

    135 GitHub stars~2.6k tokensUpdated 2 mo ago
    Auto-check: notes
  • Design

    popmechanic/VibesOS

    Self-contained design transformer — invoke directly, do not decompose.

    135 GitHub stars~2.5k tokensUpdated 2 mo ago
    Auto-check: notes
  • Launch

    popmechanic/VibesOS

    Self-contained SaaS pipeline — invoke directly, do not decompose.

    135 GitHub stars~3k tokensUpdated 2 mo ago
    Auto-check: notes
  • Riff

    popmechanic/VibesOS

    Self-contained parallel generator — invoke directly, do not decompose.

    135 GitHub stars~2k tokensUpdated 2 mo ago
    Auto-check: notes
  • Vibes Brainstorm

    popmechanic/VibesOS

    Lightweight requirements gathering before app generation. An agent skill from popmechanic/VibesOS.

    135 GitHub stars~2.2k tokensUpdated 2 mo ago
    Auto-check passed

Categories

Questions about Cloudflare

What does Cloudflare do?

Self-contained deploy automation — invoke directly, do not decompose. Cloudflare is an agent skill from popmechanic/VibesOS. Self-contained deploy automation — invoke directly, do not decompose.

When should I use Cloudflare?

Cloudflare fits situations like: pushing to production; hosting on the edge.

How do I install Cloudflare in Claude Code?

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

How do I install Cloudflare in Codex?

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

Can I use Cloudflare 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 popmechanic/VibesOS --skill cloudflare -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/cloudflare, .gemini/skills/cloudflare, .github/skills/cloudflare and .opencode/skills/cloudflare in your project.

What does Cloudflare need to run?

Going by SKILL.md and its folder, Cloudflare needs the command-line tools its instructions call (bun). Its frontmatter pre-approves these tools: Bash, Read, Glob, AskUserQuestion, Write.

Does Cloudflare 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 Cloudflare safe to install?

Our automated static check of SKILL.md found notes only (pre-approves every shell command (allowed-tools: bash)), nothing it rates as a warning. It is not a guarantee. Review the folder before installing.

What licence does Cloudflare use?

Cloudflare is published under the MIT licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Cloudflare use?

About 1.2k tokens (SKILL.md is roughly 4.9k 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 Cloudflare?

Skills that share tags, products or a category with Cloudflare: Nextjs On Cloudflare (cloudflare/skills, 3k stars), Prepare Cloudflare Production Deployment (LubomirGeorgiev/cloudflare-workers-nextjs-saas-template, 786 stars), Deploy Microfeed (microfeed/microfeed, 4.1k stars) and Cloudflare Temporary Deploy (Luciole-Studio/Misaka-Agent, 158 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Cloudflare?

popmechanic (a GitHub user) maintains it in popmechanic/VibesOS, which has 135 GitHub stars. The repository holds 7 skills in this directory. The repository was last updated on July 27, 2026.

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