Agent skill

Update Workerd Upstream

by elliothux in 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.

Apache-2.0Auto-check passedDevelopment

Install Update Workerd Upstream

skills CLI
$ npx skills add elliothux/open-compute --skill update-workerd-upstream -a claude-code

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

GitHub CLI
$ gh skill install elliothux/open-compute update-workerd-upstream --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/elliothux/open-compute.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/update-workerd-upstream .claude/skills/update-workerd-upstream && 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
update-workerd-upstream
GitHub stars
1.6k
Token cost
~922 tokens
SKILL.md length
451 words
Files
2
Skills in repo
7
Repo updated
First seen
Licence
Apache-2.0

At a glance

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.

  • Works in 5 steps: Drop code fully covered by upstream and… → Adapt the smallest remaining… → Keep fork-specific files separate where… → …
  • Explicitly requests $update-workerd-upstream
  • SKILL.md covers Establish the exact state, Minimize and regroup the fork and Validate and coordinate
  • Calls git

What it does

Update Workerd Upstream is an agent skill from 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. Invoke only when the user explicitly requests $update-workerd-upstream.

Its SKILL.md is about 920 tokens, which your agent loads only when the skill is triggered. The skill folder holds 2 other files (for example `agents/openai.yaml`).

It sits in Development. It works with Cloudflare Workers and Cloudflare. The repository describes itself as: Self-hosted Cloudflare Workers-compatible platform with Workers、KV、D1、R2、DO、Queues、Workflows、Cron、Cache、Images、Vectorize、AI Search、Artifacts、Static Assets、Service… The licence is Apache-2.0.

When your agent uses it

  • Explicitly requests $update-workerd-upstream

Example prompts

  • “/update-workerd-upstream”

Workflow steps

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

  1. Drop code fully covered by upstream and use the upstream API directly.
  2. Adapt the smallest remaining open-compute seam to current upstream ownership and conventions.
  3. Keep fork-specific files separate where doing so avoids recurring merge conflicts; touch upstream files only for the narrow registration…
  4. Remove superseded helpers, flags, tests, and compatibility branches in the same rewrite.
  5. Preserve security, capability, lifecycle, and resource-limit behavior; never resolve conflicts by weakening validation or silently…

What it can do on your machine

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

    • git

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

  • Network

    No URLs in SKILL.md. Its commands use git, which can reach the network depending on how they are called.

    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

Update Workerd Upstream loads about 922 tokens when it runs. Until then it costs about 70 tokens; SKILL.md has 451 words of instructions outside code blocks.

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

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 elliothux/open-compute at commit efee6a9, republished under its Apache-2.0 licence (© elliothux). 451 words, ~922 tokens.

Download SKILL.mdSave it as .claude/skills/update-workerd-upstream/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
name
update-workerd-upstream
description
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. Invoke only when the user explicitly requests `$update-workerd-upstream`.

Update workerd upstream

Update third_party/workerd without preserving obsolete fork implementations. Keep upstream behavior wherever it now satisfies open-compute, and keep every remaining fork seam narrow and reviewable.

Establish the exact state

Read the root and applicable workerd AGENTS.md files, docs/workerd/README.md, the active workerd design, and packages/runtime/workerd.lock.json. Confirm the parent and submodule worktrees are safe before rewriting history.

Fetch Cloudflare main into a dedicated local upstream ref and refresh the fork remote. Record the old fork head, upstream head, merge base, divergence, fork-only commits, changed paths, and parent gitlink. Do not treat commit subjects or git cherry alone as proof that upstream covers a fork feature: trace the upstream source and tests for the same behavior.

Minimize and regroup the fork

Rebase the current Day1 implementation onto the fetched upstream head. For each fork capability:

  1. Drop code fully covered by upstream and use the upstream API directly.
  2. Adapt the smallest remaining open-compute seam to current upstream ownership and conventions.
  3. Keep fork-specific files separate where doing so avoids recurring merge conflicts; touch upstream files only for the narrow registration or call site that must connect them.
  4. Remove superseded helpers, flags, tests, and compatibility branches in the same rewrite.
  5. Preserve security, capability, lifecycle, and resource-limit behavior; never resolve conflicts by weakening validation or silently ignoring configuration.

Produce one compileable commit per coherent open-compute capability. Fold tests into the capability they prove. Avoid merge, fixup, formatting-only, and historical compatibility commits. Rewrite the fork branch only when the user explicitly authorized it, and publish with --force-with-lease, never unguarded --force.

Show full SKILL.md (192 more words)Show less

Validate and coordinate

Run focused formatting/build/tests while resolving each capability. Do not download runtimes implicitly. Before final acceptance, update the parent gitlink and the workerd source identity in docs. Change the formal multi-platform binary pin only as a coordinated pin update with verified archives, digests, version output, runtime config, and required product evidence.

Open Compute's formal workerd builds and FD-passing tests use --//:io_backend=cxx. Keep --@rules_rust//:extra_exec_rustc_flag=-Cstrip=none on macOS release builds: stripping the exec-configuration Rust proc-macro dylibs can produce a malformed Mach-O before C++ compilation begins. Treat these as recorded build inputs, not as generic upstream defaults, and do not use them to mask an unrelated compiler or linker failure.

Before the product Gate, explicitly build //src/workerd/server:host-extension-test-provider with the same C++ I/O backend and set OPEN_COMPUTE_TEST_HOST_EXTENSION_PROVIDER to its absolute executable path. The fixture is test-only and must not be added to the release pin or production artifact.

Run the repository's required static checks, coverage, and final Gate once after source freeze. Use $cf-compatibility-check after implementation and fix its actionable findings before the final Gate. Report any platform build or formal-pin evidence that remains unavailable rather than substituting a development binary or a stock runtime.

© elliothux, Apache-2.0. 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 .agents/skills/update-workerd-upstream of elliothux/open-compute.

  • SKILL.md
  • agents/openai.yaml

Open the folder on GitHubat commit efee6a9

Compare with similar skills

Update Workerd Upstream 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.

Update Workerd Upstream compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Update Workerd Upstream this skillelliothux/open-compute1.6k—~922Automated safety check: PassApache-2.0
Sol Cloudflare Deploymizchi/luna.mbt173—~2kAutomated safety check: PassNone
Tanstack Startsecondsky/claude-skills227—~1.6kAutomated safety check: NotesMIT
Workers Code Reviewtry-works/role-model117—~2.5kAutomated safety check: PassCustom licence
Cloudflare Workflowssecondsky/claude-skills227—~4.2kAutomated safety check: PassMIT
Blueprint Cloudflare Scaffoldreceptron/mulmoterminal236—~782Automated safety check: PassMIT

Similar skills

  • Sol Cloudflare Deploy

    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.

    173 GitHub stars~2k tokensUpdated 21 days ago
    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 9 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.

    117 GitHub stars~2.5k tokensUpdated today
    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 9 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
    Backend & APIsAuto-check passed
  • Cloudflare Browser Rendering

    cloudflare/moltworker

    Official

    Drives headless Chrome through Cloudflare Browser Rendering over a CDP WebSocket to take screenshots, navigate and scrape pages, and record multi-page videos.

    9.9k GitHub stars~742 tokensUpdated 5 mo ago
    Productivity & AutomationAuto-check passed

More from elliothux/open-compute

  • Kumo Design

    elliothux/open-compute

    Cloudflare product design guidance. An agent skill from elliothux/open-compute.

    1.6k GitHub stars~1.6k tokensUpdated yesterday
    Auto-check passed
  • Grok Executor

    elliothux/open-compute

    Delegate a concrete, locally authorized implementation or read-only web research task from Codex to the official Grok Build CLI.

    1.6k GitHub stars~1.8k tokensUpdated yesterday
    Auto-check: warnings
  • 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.6k GitHub stars~3.5k tokensUpdated yesterday
    Auto-check passed
  • Anti Cheating

    elliothux/open-compute

    Audit the current Lynx branch and working tree for test-, fixture-, demo-, page-, domain-, or scenario-tuned production logic.

    1.6k GitHub stars~1.1k tokensUpdated yesterday
    Auto-check passed
  • Simplify

    elliothux/open-compute

    Simplify recently modified Lynx business code while preserving behavior.

    1.6k GitHub stars~984 tokensUpdated yesterday
    Auto-check passed
  • Product Surface Check

    elliothux/open-compute

    Manually review changed open-compute behavior for drift across maintained user, operator, API, SDK, configuration, deployment, capability, CLI, Dashboard, and release surfaces.

    1.6k GitHub stars~2.4k tokensUpdated yesterday
    Auto-check passed

Categories

Questions about Update Workerd Upstream

What does Update Workerd Upstream do?

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. Update Workerd Upstream is an agent skill from 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.

When should I use Update Workerd Upstream?

Update Workerd Upstream fits situations like: explicitly requests $update-workerd-upstream.

How do I install Update Workerd Upstream in Claude Code?

Run `npx skills add elliothux/open-compute --skill update-workerd-upstream -a claude-code`. Or copy the skill folder (.agents/skills/update-workerd-upstream in elliothux/open-compute) into .claude/skills/update-workerd-upstream in your project. Claude Code loads it when a task matches its description.

How do I install Update Workerd Upstream in Codex?

Run `npx skills add elliothux/open-compute --skill update-workerd-upstream -a codex`. Or copy the skill folder (.agents/skills/update-workerd-upstream in elliothux/open-compute) into .agents/skills/update-workerd-upstream in your project. Codex loads it when a task matches its description.

Can I use Update Workerd Upstream 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 elliothux/open-compute --skill update-workerd-upstream -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/update-workerd-upstream, .gemini/skills/update-workerd-upstream, .github/skills/update-workerd-upstream and .opencode/skills/update-workerd-upstream in your project.

What does Update Workerd Upstream need to run?

Going by SKILL.md and its folder, Update Workerd Upstream needs the command-line tools its instructions call (git).

Does Update Workerd Upstream access the network?

SKILL.md contains no URLs. Its commands use git, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Update Workerd Upstream 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 Update Workerd Upstream use?

Update Workerd Upstream is published under the Apache-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Update Workerd Upstream use?

About 922 tokens (SKILL.md is roughly 3.7k 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 Update Workerd Upstream?

Skills that share tags, products or a category with Update Workerd Upstream: Sol Cloudflare Deploy (mizchi/luna.mbt, 173 stars), Tanstack Start (secondsky/claude-skills, 227 stars), Workers Code Review (try-works/role-model, 117 stars) and Cloudflare Workflows (secondsky/claude-skills, 227 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Update Workerd Upstream?

elliothux (a GitHub user) maintains it in elliothux/open-compute, which has 1,591 GitHub stars. The repository holds 7 skills in this directory. The repository was last updated on October 6, 2026.

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