Agent skill

Sol Cloudflare Deploy

by mizchi in mizchi/luna.mbt

A skill your agent uses when deploying solapp (or any sol-built MoonBit SSR worker) to Cloudflare Workers, debugging error 10021, or extending sol/examples/solapp/scripts/patch-cloudflare-globals.mjs.

No licenceAuto-check passedDevelopment

Install Sol Cloudflare Deploy

skills CLI
$ npx skills add mizchi/luna.mbt --skill sol-cloudflare-deploy -a claude-code

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

GitHub CLI
$ gh skill install mizchi/luna.mbt sol-cloudflare-deploy --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/mizchi/luna.mbt.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.claude/skills/sol-cloudflare-deploy .claude/skills/sol-cloudflare-deploy && 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
sol-cloudflare-deploy
GitHub stars
173
Token cost
~2k tokens
SKILL.md length
899 words
Files
1
Skills in repo
5
Repo updated
First seen
Licence
None found

At a glance

A skill your agent uses when deploying solapp (or any sol-built MoonBit SSR worker) to Cloudflare Workers, debugging error 10021, or extending sol/examples/solapp/scripts/patch-cloudflare-globals.mjs.

  • Works in 5 steps: Always dry-run first → Three global-scope I/O traps to patch → wrangler ASSETS binding maps directory… → …
  • Deploying solapp (or any sol-built MoonBit SSR worker) to Cloudflare Workers
  • SKILL.md covers Purpose, When to use, Workflow and Pitfalls, plus 1 more section
  • Calls curl, wrangler and pnpm; reaches sol-examples.mizchi.workers.dev

What it does

Sol Cloudflare Deploy is an agent skill from mizchi/luna.mbt. Use when deploying solapp (or any sol-built MoonBit SSR worker) to Cloudflare Workers, debugging error 10021, or extending sol/examples/solapp/scripts/patch-cloudflare-globals.mjs. Captures the global-scope I/O traps in MoonBit core + sol's generated bundle and the wrangler ASSETS binding URL layout.

Its SKILL.md is about 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 Development. It works with Cloudflare and Cloudflare Workers. The repository describes itself as: Experimental: Declarative UI Framework for Moonbit.

When your agent uses it

  • Deploying solapp (or any sol-built MoonBit SSR worker) to Cloudflare Workers
  • Debugging error 10021
  • Extending sol/examples/solapp/scripts/patch-cloudflare-globals.mjs

Example prompts

  • “/sol-cloudflare-deploy”

Workflow steps

5 steps, taken from the step headings in SKILL.md.

  1. Always dry-run first
  2. Three global-scope I/O traps to patch
  3. wrangler ASSETS binding maps directory verbatim
  4. Initial deploy must not poison browser caches
  5. Verify with all three layers

What it can do on your machine

Read from SKILL.md and the folder at commit 874f0f3. 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

    Shell commands in SKILL.md call:

    • curl
    • wrangler
    • pnpm

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

  • Network

    Hosts in commands or code, which the agent is likely to contact:

    • sol-examples.mizchi.workers.dev

    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

Sol Cloudflare Deploy loads about 2k tokens when it runs. Until then it costs about 81 tokens; SKILL.md has 899 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~81
When it runs · the whole SKILL.md, loaded when a task matches
~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 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

Without a licence we can't republish the file, so here is its outline and opening line. It has 899 words (~1,994 tokens).

“Deploying sol/examples/sol_app (or another sol-generated SSR bundle) to Cloudflare Workers triggers three independent global-scope I/O violations and one ASSETS binding URL mismatch. Each one only surfaces after the previous one is fixed, so naive iteration burns one deploy cycle per…”

— opening of SKILL.md by mizchi
name
sol-cloudflare-deploy

Read the full SKILL.md on GitHub

Files

Just SKILL.md in .claude/skills/sol-cloudflare-deploy of mizchi/luna.mbt.

Open the folder on GitHubat commit 874f0f3

Compare with similar skills

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

Sol Cloudflare Deploy compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Sol Cloudflare Deploy this skillmizchi/luna.mbt173—~2kAutomated safety check: PassNone
Cf Compatibility Checkelliothux/open-compute1.7k—~3.5kAutomated safety check: PassApache-2.0
Update Workerd Upstreamelliothux/open-compute1.7k—~922Automated safety check: PassApache-2.0
Tanstack Startsecondsky/claude-skills227—~1.6kAutomated safety check: NotesMIT
Workers Code Reviewtry-works/role-model118—~2.5kAutomated safety check: PassCustom licence
Cloudflare Workflowssecondsky/claude-skills227—~4.2kAutomated safety check: PassMIT

Similar skills

  • Cf Compatibility Check

    elliothux/open-compute

    Review branch and working-tree implementation changes for conformance with open-compute's Cloudflare Workers runtime target under explicit single-machine self-host exclusions.

    1.7k GitHub stars~3.5k tokensUpdated today
    DevelopmentAuto-check passed
  • Update Workerd Upstream

    elliothux/open-compute

    Update open-compute's workerd fork onto current Cloudflare upstream, minimize fork-owned code, regroup fork commits by capability, and coordinate the submodule, pin, tests, and docs.

    1.7k GitHub stars~922 tokensUpdated today
    DevelopmentAuto-check passed
  • Tanstack Start

    secondsky/claude-skills

    TanStack Start (RC) full-stack React with server functions, SSR, Cloudflare Workers.

    227 GitHub stars~1.6k tokensUpdated 10 days ago
    DevelopmentAuto-check: notes
  • Workers Code Review

    try-works/role-model

    Reviews Workers and Cloudflare Developer Platform code for type correctness, API usage, and configuration validity.

    118 GitHub stars~2.5k tokensUpdated yesterday
    DevelopmentAuto-check passed
  • Cloudflare Workflows

    secondsky/claude-skills

    Cloudflare Workflows for durable long-running execution. An agent skill from secondsky/claude-skills.

    227 GitHub stars~4.2k tokensUpdated 10 days ago
    Agent WorkflowsAuto-check passed
  • Blueprint Cloudflare Scaffold

    receptron/mulmoterminal

    Lay out a Worker with D1 and static Vue assets, with tests that run inside the Workers runtime.

    236 GitHub stars~782 tokensUpdated today
    Agent WorkflowsAuto-check passed

More from mizchi/luna.mbt

  • Luna

    mizchi/luna.mbt

    A skill your agent uses whenever working with mizchi/luna in the luna.mbt repo — writing CSR examples, fixing reactivity bugs (effects re-running on unrelated signal changes), adding new luna…

    173 GitHub stars~897 tokensUpdated 22 days ago
    Auto-check passed
  • Creating Luna App

    mizchi/luna.mbt

    A skill your agent uses when scaffolding a new standalone CSR app that uses luna (@lunaui/luna) outside the luna.mbt monorepo — running npx @lunaui/luna new, choosing TSX vs MoonBit, or fixing a…

    173 GitHub stars~1.4k tokensUpdated 22 days ago
    Auto-check passed
  • A skill your agent uses when running Playwright tests in this repo (luna.mbt) and either the test fails to discover specs ("did not expect test.describe()" / "two different versions of…

    173 GitHub stars~1.2k tokensUpdated 22 days ago
    Auto-check passed
  • Sol Bootstrap

    mizchi/luna.mbt

    A skill your agent uses when running sol new for the first time, when sol <subcommand fails with failed to resolve path mizchi/sol/cmd/soljs / Run this command inside a MoonBit project that depends…

    173 GitHub stars~3.6k tokensUpdated 22 days ago
    Auto-check passed

Categories

Questions about Sol Cloudflare Deploy

What does Sol Cloudflare Deploy do?

A skill your agent uses when deploying solapp (or any sol-built MoonBit SSR worker) to Cloudflare Workers, debugging error 10021, or extending sol/examples/solapp/scripts/patch-cloudflare-globals.mjs. mbt.mjs.

When should I use Sol Cloudflare Deploy?

Sol Cloudflare Deploy fits situations like: deploying solapp (or any sol-built MoonBit SSR worker) to Cloudflare Workers; debugging error 10021; extending sol/examples/solapp/scripts/patch-cloudflare-globals.mjs.

How do I install Sol Cloudflare Deploy in Claude Code?

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

How do I install Sol Cloudflare Deploy in Codex?

Run `npx skills add mizchi/luna.mbt --skill sol-cloudflare-deploy -a codex`. Or copy the skill folder (.claude/skills/sol-cloudflare-deploy in mizchi/luna.mbt) into .agents/skills/sol-cloudflare-deploy in your project. Codex loads it when a task matches its description.

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

What does Sol Cloudflare Deploy need to run?

Going by SKILL.md and its folder, Sol Cloudflare Deploy needs the command-line tools its instructions call (curl, wrangler and pnpm).

Does Sol Cloudflare Deploy access the network?

SKILL.md names 1 domain. In commands or code: sol-examples.mizchi.workers.dev; the agent is likely to contact it when it follows the instructions. This is read from the text; nothing was executed.

Is Sol Cloudflare Deploy 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 Sol Cloudflare Deploy use?

No licence was found for Sol Cloudflare Deploy or its repository. Without one, default copyright applies: ask the author before reusing or redistributing it.

How many tokens does Sol Cloudflare Deploy use?

About 2k tokens (SKILL.md is roughly 8k 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 Sol Cloudflare Deploy?

Skills that share tags, products or a category with Sol Cloudflare Deploy: Cf Compatibility Check (elliothux/open-compute, 1.7k stars), Update Workerd Upstream (elliothux/open-compute, 1.7k stars), Tanstack Start (secondsky/claude-skills, 227 stars) and Workers Code Review (try-works/role-model, 118 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Sol Cloudflare Deploy?

mizchi (a GitHub user) maintains it in mizchi/luna.mbt, which has 173 GitHub stars. The repository holds 5 skills in this directory. The repository was last updated on September 16, 2026.

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