Agent skill

Loom

by valkor-ai in valkor-ai/loom

Mandatory routing skill. An agent skill from valkor-ai/loom.

Apache-2.0Auto-check passedGame Development

Install Loom

skills CLI
$ npx skills add valkor-ai/loom --skill loom -a claude-code

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

GitHub CLI
$ gh skill install valkor-ai/loom loom --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/valkor-ai/loom.git skills-src && mkdir -p .claude/skills && cp -r skills-src/plugins/codex/skills/loom .claude/skills/loom && 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
loom
GitHub stars
1.2k
Token cost
~1.4k tokens
SKILL.md length
736 words
Files
1
Skills in repo
17
Repo updated
First seen
Licence
Apache-2.0

At a glance

Mandatory routing skill. An agent skill from valkor-ai/loom.

  • Explicitly invokes @loom
  • SKILL.md covers Route, Follow Results, Read, Write, Verify and Reference Loading
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md
  • Call the matching Loom MCP route before any repository work

What it does

Loom is an agent skill from valkor-ai/loom. Mandatory routing skill. When the user explicitly invokes @loom, call the matching Loom MCP route before any repository work; plain delivery requests must start with loom.plan.

Its SKILL.md is about 1.4k 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 Game Development. It works with Model Context Protocol. The repository describes itself as: Loop engineering for agentic software delivery. The licence is Apache-2.0.

When your agent uses it

  • Explicitly invokes @loom
  • Call the matching Loom MCP route before any repository work
  • Plain delivery requests must start with loom.plan

Example prompts

  • “/loom”

What it can do on your machine

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

    No scripts in the folder and no shell commands in SKILL.md.

    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

Loom loads about 1.4k tokens when it runs. Until then it costs about 45 tokens; SKILL.md has 736 words of instructions outside code blocks.

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

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 valkor-ai/loom at commit a30a7e6, republished under its Apache-2.0 licence (© valkor-ai). 736 words, ~1,369 tokens.

Download SKILL.mdSave it as .claude/skills/loom/SKILL.md (or your agent's skills folder).
name
loom
description
Mandatory routing skill. When the user explicitly invokes @loom, call the matching Loom MCP route before any repository work; plain delivery requests must start with loom.plan.

loom

Use Loom MCP as the workflow authority. Do not inspect .loom directly, invent a workflow in chat, or touch repository files before the route below returns.

This is the mandatory routing entrypoint. When a user invokes @loom, resolve the Loom route before any repository work. For @loom <request> or @loom plan <request>, call mcp__loom__plan when it is available. If deferred loading hides that tool, make one targeted search for Loom plan software delivery @loom, then call the returned plan tool. Do not search for deploy, inspect, or generic skills, and do not call exec_command, apply_patch, or other repository tools before the plan call returns.

Route

Use the current workspace as projectRoot.

  • @loom <request>: call loom.plan with { projectRoot, requestText: "<full request>" }.
  • @loom plan <request>: same call with <request>.
  • @loom continue|resume|proceed|next: call loom.continue.
  • @loom verify, @loom status, @loom knowledge ..., and @loom deploy ...: call the matching Loom tool directly.
  • If the plan tool is deferred, make one targeted search for Loom plan software delivery @loom, then call the returned plan tool. Do not do other discovery first.
  • For a plan-conflict gate, present its choices exactly and resolve it with loom.planConflictResolve; never call loom.plan again.

Follow Results

  • auto_runnable: perform the returned next action immediately.
  • active_operation: use only the named observation tools.
  • user_gate: follow preResponseContract in order before replying. For Brainstorm, read the applicable groups, run every required knowledge step, present the current question, then wait for the user. A phase continuation is an active clarification, not an optional next step.
  • repairable_error: inspect the request, read every required group, change only the returned target, and use its resubmit tool. Do not ask the user to repeat a confirmation.
  • V-SEFM onboarding: wait for the user's choice, then call loom.verify with decision=required or decision=deferred.
  • done, blocked, or failed: stop and report it. Do not stop while a result is auto-runnable or stopAllowed=false.

Read, Write, Verify

When a result has requestRef, use loom.inspectRequest and only the declared loom.readFieldGroup groups. requestReadPlan.groups is the only read contract. The request is the source of schemas, read boundaries, and submit parameters; do not request individual fields or infer inputs from old artifacts.

Write only returned writeTargets, then submit with the returned tool. For execution, respect edit boundaries, run the required checks, write the TaskResult, and submit it before saying work is complete. If an operation fails, inspect and repair it in the same Loom action.

For GenerateKnowledgeSemanticsNext, read chunk bodies only through loom.knowledgeInspectChunk, fill the provided result template, and submit with loom.knowledgeSemanticSubmitFile. Continue pack by pack until the build publishes, blocks, or reaches a real user gate.

For RunLoomToolNext, inspect the requestRef, read only the returned readGroups, call the returned Loom MCP tool, then retry the returned retryTool before reporting completion.

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

Reference Loading

The current MCP request/result remains the authority. Load no reference by default; load references only when the current action selects a reference profile.

Protocol:

  • After reading the current request group, choose references only from the profiles selected by that request.
  • Read reference files only from referenceLoadPlan arrays in the current MCP request/result.
  • Treat selected group fields as semantic labels for scope and evidence, not as path mappings.
  • If a referenced file is not selected by the MCP contract and is not needed by the current action, leave it unread.
  • In quality self-checks, report the exact referencePlanFilesChecked paths from the selected load plan; do not paste reference prose or template bodies.

Reference profiles:

  • Each referenceLoadPlan entry contains refId, path, and reason. Resolve path under the installed Loom skill's references/ directory. Do not resolve it against the project workspace or source checkout. Before reading, verify the resolved file directly.
  • Load exactly the listed paths for the current action. Do not derive paths from group names, scan reference directories, or load external language, API, architecture, or UI skills.
  • Treat token template paths as merge baselines for project files, not as text to copy into Loom artifacts.

Reference discipline:

  • Do not load unselected references to compensate for weak planning; ask Loom to repair the contract only when the selected referenceLoadPlan is insufficient.
  • In TaskPlan, Execution, Review, and Repair requests without a selected load plan, use the provided quality refs, requirements, evidence, and review signals without reading raw references.
  • Do not paste tech reference text into artifacts, source files, or user-facing UI. Use references to produce concrete decisions, interface contracts, NFRs, risks, and evidence.

Keep user-facing responses compact. Do not paste raw artifacts, request payloads, or logs unless asked.

© valkor-ai, 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

Just SKILL.md in plugins/codex/skills/loom of valkor-ai/loom.

Open the folder on GitHubat commit a30a7e6

Compare with similar skills

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

Loom compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Loom this skillvalkor-ai/loom1.2k—~1.4kAutomated safety check: PassApache-2.0
Sprite Genaldegad/sprite-gen2.6k—~4.8kAutomated safety check: PassApache-2.0
Blockbench Pluginsjasonjgardner/blockbench-mcp-plugin495—~2.8kAutomated safety check: PassGPL-3.0
Unreal Blueprint Authoringflopperam/unreal-engine-mcp1.1k—~1.6kAutomated safety check: PassNone
Locus Unity BridgeMisaka-Mikoto-Tech/agent-skills278—~4kAutomated safety check: PassMIT
Assets Shader List AllIvanMurzak/Unity-MCP4.4k—~435Automated safety check: PassApache-2.0

Similar skills

  • Sprite Gen

    aldegad/sprite-gen

    Generates images and game sprites through GPT or Grok with guided provider choices, separate saved defaults, automatic cleanup and optional curation.

    2.6k GitHub stars~4.8k tokensUpdated today
    Game DevelopmentAuto-check passed
  • Blockbench Plugins

    jasonjgardner/blockbench-mcp-plugin

    Blockbench plugin/extension development for the 3D modeling tool.

    495 GitHub stars~2.8k tokensUpdated 8 days ago
    Game DevelopmentAuto-check passed
  • Unreal Blueprint Authoring

    flopperam/unreal-engine-mcp

    Walks an agent through creating and editing Unreal Engine Blueprints with the Flopperam MCP's bp_* tools, from inspection to commit and verification.

    1.1k GitHub stars~1.6k tokensUpdated 3 mo ago
    Game DevelopmentAuto-check passed
  • Locus Unity Bridge

    Misaka-Mikoto-Tech/agent-skills

    A skill your agent uses when an agent needs to inspect or control a real Unity Editor through Locus, especially when Unity MCP is unavailable, named-pipe discovery is needed, C must be executed, or…

    278 GitHub stars~4k tokensUpdated 18 days ago
    Game DevelopmentAuto-check passed
  • Assets Shader List All

    IvanMurzak/Unity-MCP

    List all shaders available in the project assets and packages, sorted by name.

    4.4k GitHub stars~435 tokensUpdated 5 days ago
    Game DevelopmentAuto-check passed
  • Unreal Material and VFX Workflow

    flopperam/unreal-engine-mcp

    Walks an Unreal Engine MCP agent through building materials, Niagara particle systems, Chaos destruction, and curve assets with inspect-then-edit steps.

    1.1k GitHub stars~927 tokensUpdated 3 mo ago
    Game DevelopmentAuto-check passed

More from valkor-ai/loom

All 17 skills in this repo
  • Build and iterate playable Three.js game systems: starter scaffold, architecture, design briefs, core loops, level and encounter design, entities, input, camera, collision and physics, scoring…

    1.2k GitHub starsUsed in 1 repo~1.4k tokens
    Auto-check passed
  • Threejs 3D Generator

    valkor-ai/loom

    Generate, texture, rig, animate, stylize, convert, and download 3D assets for Three.js games via the Tripo API.

    1.2k GitHub starsUsed in 1 repo~2.6k tokens
    Auto-check passed
  • Generate and edit 2D image assets for Three.js games with Google's Gemini image API: concept sheets, image-to-3D inputs, texture and material references, sky and background plates, decals, logos…

    1.2k GitHub starsUsed in 1 repo~1.4k tokens
    Auto-check passed
  • Threejs Game Director

    valkor-ai/loom

    Entrypoint for building, upgrading, and finishing Three.js browser games.

    1.2k GitHub stars~2.3k tokensUpdated 3 days ago
    Auto-check passed
  • Generate, convert, clean, and integrate audio for Three.js browser games with ElevenLabs: sound effects, looping ambience, UI sounds, impact/weapon/vehicle audio, creature and boss stingers…

    1.2k GitHub starsUsed in 1 repo~1.3k tokens
    Auto-check passed
  • Threejs QA Release

    valkor-ai/loom

    Verify and release Three.js browser games: playtest QA, automated bot playtests, mobile and responsive checks, production builds, static-hosting base paths, debug gating, bundle review, screenshots…

    1.2k GitHub starsUsed in 1 repo~1.3k tokens
    Auto-check passed

Questions about Loom

What does Loom do?

Mandatory routing skill. An agent skill from valkor-ai/loom. Loom is an agent skill from valkor-ai/loom. Mandatory routing skill.

When should I use Loom?

Loom fits situations like: explicitly invokes @loom; call the matching Loom MCP route before any repository work; plain delivery requests must start with loom.plan.

How do I install Loom in Claude Code?

Run `npx skills add valkor-ai/loom --skill loom -a claude-code`. Or copy the skill folder (plugins/codex/skills/loom in valkor-ai/loom) into .claude/skills/loom in your project. Claude Code loads it when a task matches its description.

How do I install Loom in Codex?

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

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

What does Loom need to run?

SKILL.md names no scripts, command-line tools or credentials: Loom is instructions for the agent only.

Does Loom 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 Loom 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 Loom use?

Loom 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 Loom use?

About 1.4k tokens (SKILL.md is roughly 5.5k 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 Loom?

Skills that share tags, products or a category with Loom: Sprite Gen (aldegad/sprite-gen, 2.6k stars), Blockbench Plugins (jasonjgardner/blockbench-mcp-plugin, 495 stars), Unreal Blueprint Authoring (flopperam/unreal-engine-mcp, 1.1k stars) and Locus Unity Bridge (Misaka-Mikoto-Tech/agent-skills, 278 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Loom?

valkor-ai (a GitHub organization) maintains it in valkor-ai/loom, which has 1,211 GitHub stars. The repository holds 17 skills in this directory. The repository was last updated on October 6, 2026.

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