Agent skill

Smithers Chain

by smithersai in smithersai/smithers

Maintain the existing @smthrs/chain runner, journal replay, catalog handlers, or sandbox boundary.

MITAuto-check passedAgent Workflows

Install Smithers Chain

skills CLI
$ npx skills add smithersai/smithers --skill smithers-chain -a claude-code

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

GitHub CLI
$ gh skill install smithersai/smithers smithers-chain --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/smithersai/smithers.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/smithers-chain .claude/skills/smithers-chain && 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
smithers-chain
GitHub stars
430
Token cost
~299 tokens
SKILL.md length
149 words
Files
1
Skills in repo
9
Repo updated
First seen
Licence
MIT

At a glance

Maintain the existing @smthrs/chain runner, journal replay, catalog handlers, or sandbox boundary.

  • Agent Workflows work in your project
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Smithers Chain is an agent skill from smithersai/smithers. Maintain the existing @smthrs/chain runner, journal replay, catalog handlers, or sandbox boundary.

Its SKILL.md is about 300 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. The repository describes itself as: Smithers is an agentic workflow framework for defining workflows in simple TypeScript configuration files and executing them quickly, durably, and reliably. The licence is MIT.

When your agent uses it

  • Agent Workflows work in your project

Example prompts

  • “/smithers-chain”

What it can do on your machine

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

Smithers Chain loads about 299 tokens when it runs. Until then it costs about 28 tokens; SKILL.md has 149 words of instructions outside code blocks.

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

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 smithersai/smithers at commit b7f0898, republished under its MIT licence (© smithersai). 149 words, ~299 tokens.

Download SKILL.mdSave it as .claude/skills/smithers-chain/SKILL.md (or your agent's skills folder).
name
smithers-chain
description
Maintain the existing @smthrs/chain runner, journal replay, catalog handlers, or sandbox boundary.

Existing chain package

Read the chain README and its tests before changing this package. Keep the main product's single Agent.Service loop and @smthrs/flow authoring model; this skill is for the existing chain implementation, not a reason to add a second loop or graph API.

QuickJsRunner.layer() creates a sealed QuickJS realm per link with memory, stack, and step limits and no host globals. ScriptRunner.layerInProcess has no isolation and belongs only in trusted fixtures; a script there can reach process globals and dynamic imports.

The journal is the state authority. A matching settled call replays once, but a handler may execute again if it succeeded before CallSettled was recorded. Make external effects idempotent or give them an external durable key from the stable catalog call slot (chain, link, ordinal). Preserve the declaration/script identity checks that fail on replay divergence. Verify a crash after handler success and before settle when changing recovery.

© smithersai, 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 .agents/skills/smithers-chain of smithersai/smithers.

Open the folder on GitHubat commit b7f0898

Compare with similar skills

Smithers Chain 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.

Smithers Chain compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Smithers Chain this skillsmithersai/smithers430—~299Automated safety check: PassMIT
MCP Server Builderanthropics/skills180k63 repos~2.3kAutomated safety check: PassApache-2.0
Hook Development for Claude Code Pluginsanthropics/claude-plugins-official38k10 repos~4.1kAutomated safety check: NotesApache-2.0
Using Superpowersfarm-fe/farm5.6k35 repos~1.4kAutomated safety check: PassMIT
Executing Plans Inlineobra/superpowers297k2 repos~5.1kAutomated safety check: PassMIT
Skill CreatorAzure/azqr79689 repos~8.2kAutomated safety check: PassApache-2.0

Similar skills

  • MCP Server Builder

    anthropics/skills

    Official

    Guides the design and implementation of Model Context Protocol servers in TypeScript or Python, from tool naming and error messages to evaluation.

    180k GitHub starsUsed in 63 repos~2.3k tokens
    Agent WorkflowsAuto-check passed
  • Hook Development for Claude Code Plugins

    anthropics/claude-plugins-official

    Official

    Explains how to write Claude Code plugin hooks, both prompt-based checks and bash commands, for events such as PreToolUse, Stop and SessionStart.

    38k GitHub starsUsed in 10 repos~4.1k tokens
    Agent WorkflowsAuto-check: notes
  • Using Superpowers

    farm-fe/farm

    A skill your agent uses when starting any conversation - establishes how to find and use skills, requiring Skill tool invocation before ANY response including clarifying questions

    5.6k GitHub starsUsed in 35 repos~1.4k tokens
    Agent WorkflowsAuto-check passed
  • Executing Plans Inline

    obra/superpowers

    Has the agent carry out an implementation plan itself, task by task in the current session, keeping a ledger, proving each step with a test and ending with one whole-branch review.

    297k GitHub starsUsed in 2 repos~5.1k tokens
    Agent WorkflowsAuto-check passed
  • Skill Creator

    Azure/azqr

    Official

    Create new skills, modify and improve existing skills, and measure skill performance.

    796 GitHub starsUsed in 89 repos~8.2k tokens
    Agent WorkflowsAuto-check passed
  • Claude Code Agent Development

    anthropics/claude-plugins-official

    Official

    Explains how to write agents for Claude Code plugins: the markdown file with YAML frontmatter, trigger descriptions, model and color settings, and system prompt design.

    38k GitHub starsUsed in 7 repos~2.8k tokens
    Agent WorkflowsAuto-check passed

More from smithersai/smithers

All 9 skills in this repo
  • Smithers Durable Flow Driver

    smithersai/smithers

    Runs or authors Smithers TypeScript flows for ordered agent stages with retries, approvals, bounded loops and crash-safe recovery, built from Flow.make, Action.make and Effect.

    430 GitHub stars~3k tokensUpdated today
    Auto-check passed
  • Smithers Agent Runtime

    smithersai/smithers

    Guides changes to the Smithers agent loop's host wiring: credentialed model seats, budget accounting, sandbox limits and flow-call authorization.

    430 GitHub stars~765 tokensUpdated today
    Auto-check passed
  • Documents how Smithers discovers and registers workflow flow files, so catalog listings stay metadata-only while running a flow loads its full body and action layers.

    430 GitHub stars~432 tokensUpdated today
    Auto-check passed
  • Points agents to the right sources when changing the Smithers workspace graph, generated docs, benchmark and eval evidence, or durable flows in the Smithers repository.

    430 GitHub stars~2.3k tokensUpdated today
    Auto-check passed
  • flows-jj ABI Maintenance

    smithersai/smithers

    Procedure for changing or verifying the flows-jj native and WASM ABI, its committed artifact and its reproducibility campaign in the Smithers repository.

    430 GitHub stars~299 tokensUpdated today
    Auto-check passed
  • Smithers Harness Detect

    smithersai/smithers

    Change local coding-harness discovery, account status, model flag detection, or version probes.

    430 GitHub stars~260 tokensUpdated today
    Auto-check passed

Categories

Questions about Smithers Chain

What does Smithers Chain do?

Maintain the existing @smthrs/chain runner, journal replay, catalog handlers, or sandbox boundary. Smithers Chain is an agent skill from smithersai/smithers. Maintain the existing @smthrs/chain runner, journal replay, catalog handlers, or sandbox boundary.

When should I use Smithers Chain?

Smithers Chain fits situations like: agent Workflows work in your project.

How do I install Smithers Chain in Claude Code?

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

How do I install Smithers Chain in Codex?

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

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

What does Smithers Chain need to run?

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

Does Smithers Chain 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 Smithers Chain 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 Smithers Chain use?

Smithers Chain is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Smithers Chain use?

About 299 tokens (SKILL.md is roughly 1.2k 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 Smithers Chain?

Skills that share tags, products or a category with Smithers Chain: MCP Server Builder (anthropics/skills, 180k stars), Hook Development for Claude Code Plugins (anthropics/claude-plugins-official, 38k stars), Using Superpowers (farm-fe/farm, 5.6k stars) and Executing Plans Inline (obra/superpowers, 297k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Smithers Chain?

smithersai (a GitHub organization) maintains it in smithersai/smithers, which has 430 GitHub stars. The repository holds 9 skills in this directory. The repository was last updated on October 10, 2026.

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