Agent skill

Weft Updating

by WeaveMindAI in WeaveMindAI/weft

Read when the user asks to update or upgrade weft, or when something broke right after one: locating the checkout, the git pull plus setup.sh walk, what setup.sh rebuilds and what it preserves, and…

Custom licenceAuto-check passedDevelopment

Install Weft Updating

skills CLI
$ npx skills add WeaveMindAI/weft --skill weft-updating -a claude-code

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

GitHub CLI
$ gh skill install WeaveMindAI/weft weft-updating --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/WeaveMindAI/weft.git skills-src && mkdir -p .claude/skills && cp -r skills-src/tangle/cline/.cline/skills/weft-updating .claude/skills/weft-updating && 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
weft-updating
GitHub stars
2k
Token cost
~1.5k tokens
SKILL.md length
905 words
Files
1
Skills in repo
36
Repo updated
First seen
Licence
Custom licence

At a glance

Read when the user asks to update or upgrade weft, or when something broke right after one: locating the checkout, the git pull plus setup.sh walk, what setup.sh rebuilds and what it preserves, and…

  • Works in 5 steps: Look before pulling. git -C status… → Pull. git -C pull. On conflicts you show… → Run setup. cd && ./setup.sh. The default… → …
  • Something broke right after one: locating the checkout
  • SKILL.md covers Finding the checkout, The walk, What an update never does and When the update breaks
  • Calls git

What it does

Weft Updating is an agent skill from WeaveMindAI/weft. Read when the user asks to update or upgrade weft, or when something broke right after one: locating the checkout, the git pull plus setup.sh walk, what setup.sh rebuilds and what it preserves, and fixing a failed update.

Its SKILL.md is about 1.5k 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, covering Git workflow. It works with Git. The repository describes itself as: A programming language for AI orchestrations.

When your agent uses it

  • Something broke right after one: locating the checkout
  • The git pull plus setup.sh walk
  • What setup.sh rebuilds and what it preserves
  • Fixing a failed update

Example prompts

  • “/weft-updating”

Workflow steps

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

  1. Look before pulling. git -C status --short and git -C log --oneline -3. Local changes force [the compile path], and a pull over them can…
  2. Pull. git -C pull. On conflicts you show the user the conflicted files, resolve with their input, then re-run the pull. If you catch…
  3. Run setup. cd && ./setup.sh. The default refreshes the CLI, the daemon (its images rebuilt when they changed, weft's runtime restarted or…
  4. Verify. weft --version (the new number), weft daemon status (running). If the daemon is not coming up, you read weft daemon logs --tail…
  5. Per project, after the update. weft catalog update syncs this project's stdlib copy to the new weft (a diagnostic naming the catalog or a…

What it can do on your machine

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

Weft Updating loads about 1.5k tokens when it runs. Until then it costs about 59 tokens; SKILL.md has 905 words of instructions outside code blocks.

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

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

Its licence (Custom licence) doesn't allow us to republish the file, so here is its outline and opening line. It has 905 words (~1,498 tokens).

“[the checkout] is the git clone of weft on the user's machine; ./setup.sh in it is what installed weft. An update is git pull in [the checkout], then ./setup.sh, then one command per project. An update never edits a file…”

— opening of SKILL.md by WeaveMindAI, Custom licence
name
weft-updating

Read the full SKILL.md on GitHub

Files

Just SKILL.md in tangle/cline/.cline/skills/weft-updating of WeaveMindAI/weft.

Open the folder on GitHubat commit 6e28f31

Compare with similar skills

Weft Updating 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.

Weft Updating compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Weft Updating this skillWeaveMindAI/weft2k—~1.5kAutomated safety check: PassCustom licence
Finishing a Development Branchobra/superpowers296k5 repos~1.9kAutomated safety check: PassMIT
Code Design Rationale Investigatorcursor/plugins10k9 repos~2.6kAutomated safety check: PassNone
Contributor-First PR MergeHKUDS/OpenHarness16k1 repos~847Automated safety check: PassMIT
Migrate Internal Package into GhostTryGhost/Ghost55k—~3.8kAutomated safety check: PassMIT
Create Pull Requestcline/cline70k1 repos~1.6kAutomated safety check: PassApache-2.0

Similar skills

  • Walks the last step of a branch: confirm tests pass, detect the git environment, ask how to integrate, carry out your choice and clean up the worktree.

    296k GitHub starsUsed in 5 repos~1.9k tokens
    DevelopmentAuto-check passed
  • Official

    Digs into why code is shaped the way it is by checking git history, pull requests and connected tools in parallel, then reporting a cited read on the tradeoffs.

    10k GitHub starsUsed in 9 repos~2.6k tokens
    DevelopmentAuto-check passed
  • Merges external GitHub pull requests while keeping the original author credited, and fixes conflicts after the merge instead of rewriting the contribution.

    16k GitHub starsUsed in 1 repo~847 tokens
    DevelopmentAuto-check passed
  • Moves a package from another TryGhost repository into Ghost as an internal workspace package while keeping its Git history, with checkpoints for the steps that need an administrator.

    55k GitHub stars~3.8k tokensUpdated today
    DevelopmentAuto-check passed
  • Opens a GitHub pull request from your current branch with the gh CLI, after reviewing the commits and diff and gathering the details the PR needs.

    70k GitHub starsUsed in 1 repo~1.6k tokens
    DevelopmentAuto-check passed
  • Git Merge Conflict Resolver

    tailcallhq/forgecode

    Resolves Git merge conflicts with a plan-first workflow that keeps both sides' intent, regenerates lock files and backs up deleted-but-modified files.

    7.6k GitHub starsUsed in 1 repo~4.5k tokens
    DevelopmentAuto-check passed

More from WeaveMindAI/weft

All 36 skills in this repo
  • Weft Cloud Install

    WeaveMindAI/weft

    Read when the user wants weft itself on their Google Cloud for the first time, or to upgrade or resize the weft already there: getting the user's GitHub and Google Cloud accounts and CLIs ready, the…

    2k GitHub stars~2.4k tokensUpdated 2 days ago
    Auto-check passed
  • Weft Consumers

    WeaveMindAI/weft

    Read when the user wants their own website, app, bot or extension to list, show, answer, skip or cancel what a program is waiting on, fetch a file it carries, or show what one of its nodes is…

    2k GitHub stars~3.8k tokensUpdated 2 days ago
    Auto-check passed
  • Weft Deploying

    WeaveMindAI/weft

    Read when the user wants weft or a program live for real people on their cloud, asks about prod, a target, --on, a domain or GCP, or a deploy failed: targets and logging in, domains, the deploy…

    2k GitHub stars~4.2k tokensUpdated 2 days ago
    Auto-check: notes
  • Weft Metering

    WeaveMindAI/weft

    Read when the user asks what a run costs, or when a node is wired to a paid API weft does not already price: the three pieces of a custom paid service, a meter to copy, and the rules that keep a…

    2k GitHub stars~4k tokensUpdated 2 days ago
    Auto-check passed
  • Weft Sdp

    WeaveMindAI/weft

    Read when growing a program stage by stage: carving a run, supplying starting values, baking a trigger and firing it without activating, reusing completed work with a seed, freezing an accepted…

    2k GitHub stars~4k tokensUpdated 2 days ago
    Auto-check passed
  • Weft Frontend

    WeaveMindAI/weft

    Read when the user wants a page, app or site for the program, and before dispatching the frontend-builder: the verified scaffold commands, the default stack (pnpm, SvelteKit, PostgreSQL, BetterAuth…

    2k GitHub stars~8k tokensUpdated 2 days ago
    Auto-check: notes

Works with

Categories

Questions about Weft Updating

What does Weft Updating do?

Read when the user asks to update or upgrade weft, or when something broke right after one: locating the checkout, the git pull plus setup.sh walk, what setup.sh rebuilds and what it preserves, and…. Weft Updating is an agent skill from WeaveMindAI/weft.sh rebuilds and what it preserves, and fixing a failed update.

When should I use Weft Updating?

Weft Updating fits situations like: something broke right after one: locating the checkout; the git pull plus setup.sh walk; what setup.sh rebuilds and what it preserves; fixing a failed update.

How do I install Weft Updating in Claude Code?

Run `npx skills add WeaveMindAI/weft --skill weft-updating -a claude-code`. Or copy the skill folder (tangle/cline/.cline/skills/weft-updating in WeaveMindAI/weft) into .claude/skills/weft-updating in your project. Claude Code loads it when a task matches its description.

How do I install Weft Updating in Codex?

Run `npx skills add WeaveMindAI/weft --skill weft-updating -a codex`. Or copy the skill folder (tangle/cline/.cline/skills/weft-updating in WeaveMindAI/weft) into .agents/skills/weft-updating in your project. Codex loads it when a task matches its description.

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

What does Weft Updating need to run?

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

Does Weft Updating 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 Weft Updating 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 Weft Updating use?

Weft Updating has a licence file (the repository's licence) that doesn't match a standard licence. Read it on GitHub before reusing the skill.

How many tokens does Weft Updating use?

About 1.5k tokens (SKILL.md is roughly 6k 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 Weft Updating?

Skills that share tags, products or a category with Weft Updating: Finishing a Development Branch (obra/superpowers, 296k stars), Code Design Rationale Investigator (cursor/plugins, 10k stars), Contributor-First PR Merge (HKUDS/OpenHarness, 16k stars) and Migrate Internal Package into Ghost (TryGhost/Ghost, 55k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Weft Updating?

WeaveMindAI (a GitHub organization) maintains it in WeaveMindAI/weft, which has 1,995 GitHub stars. The repository holds 36 skills in this directory. The repository was last updated on October 6, 2026.

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