Agent skill

Golem Skill Harness

by golemcloud in golemcloud/golem

Developing, testing, and running Golem skill scenarios with the TypeScript skill harness.

Custom licenceAuto-check passedDevelopment

Install Golem Skill Harness

skills CLI
$ npx skills add golemcloud/golem --skill golem-skill-harness -a claude-code

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

GitHub CLI
$ gh skill install golemcloud/golem golem-skill-harness --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/golemcloud/golem.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/golem-skill-harness .claude/skills/golem-skill-harness && 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
golem-skill-harness
GitHub stars
1.5k
Token cost
~3.3k tokens
SKILL.md length
1,258 words
Files
1
Skills in repo
289
Repo updated
First seen
Licence
Custom licence

At a glance

Developing, testing, and running Golem skill scenarios with the TypeScript skill harness.

  • Works in 7 steps: Run --dry-run --scenario to catch… → Run one agent/language/scenario with… → Distinguish step timeout from idle… → …
  • Creating Golem skills
  • SKILL.md covers Skills and generated…, Prerequisites and limitations, Install and fast checks and Run scenarios, plus 6 more sections
  • Calls npm, cargo and npx

What it does

Golem Skill Harness is an agent skill from golemcloud/golem. Developing, testing, and running Golem skill scenarios with the TypeScript skill harness. Use when creating Golem skills, authoring scenario YAML, running agent matrices, or debugging skill activation and behavior failures.

Its SKILL.md is about 3.3k 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 TypeScript, Model Context Protocol and Rust. The repository describes itself as: Golem Cloud is the agent-native platform for building AI agents and distributed applications that never lose state, never duplicate work, and never require you to build…

When your agent uses it

  • Creating Golem skills
  • Authoring scenario YAML
  • Running agent matrices
  • Debugging skill activation and behavior failures

Example prompts

  • “/golem-skill-harness”

Requirements

  • Node.js
  • Docker

Workflow steps

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

  1. Run --dry-run --scenario to catch current-schema and regex errors.
  2. Run one agent/language/scenario with explicit timeouts; inspect the retained workspace and per-step JSON.
  3. Distinguish step timeout from idle timeout. Whole-scenario retry occurs only for idle timeout; per-step retry handles any step failure.
  4. For missed activation, check native tool events first, then .agents/skills, atime behavior, and Linux inotifywait. Do not restore stale…
  5. For stale skill behavior, confirm which release/debug golem was selected and rebuild it.
  6. For Golem failures, verify the selected ports are free and inspect server output. For service failures, inspect Docker…
  7. For Scala, reproduce the composite action's Java/sbt/WIT/base-image/local-publish preparation before blaming the scenario.

What it can do on your machine

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

    • npm
    • cargo
    • npx

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

  • Network

    No URLs in SKILL.md. Its commands use npm and npx, 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

Golem Skill Harness loads about 3.3k tokens when it runs. Until then it costs about 61 tokens; SKILL.md has 1,258 words of instructions outside code blocks.

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

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 1,258 words (~3,337 tokens).

“The harness in golem-skills/tests/harness/ runs coding agents against current-schema YAML scenarios. Treat src/executor.ts, src/assertions.ts, src/driver/, src/workspace.ts, and src/services.ts as the source of truth; do not add legacy fields or compatibility shims to new scenarios.”

— opening of SKILL.md by golemcloud, Custom licence
name
golem-skill-harness

Read the full SKILL.md on GitHub

Files

Just SKILL.md in .agents/skills/golem-skill-harness of golemcloud/golem.

Open the folder on GitHubat commit c6a3029

Compare with similar skills

Golem Skill Harness 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.

Golem Skill Harness compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Golem Skill Harness this skillgolemcloud/golem1.5k—~3.3kAutomated safety check: PassCustom licence
Agentbro PR Mergeshirenchuang/agentbro203—~648Automated safety check: PassApache-2.0
Pump Build Releasenirholas/pump-fun-sdk133—~620Automated safety check: PassCustom licence
Cdesktopcdesktop-ai/cdesktop157—~697Automated safety check: PassApache-2.0
MCP SDK Tier Auditmodelcontextprotocol/conformance129—~4.4kAutomated safety check: PassCustom licence
Composio Byodrewnekota/cetus146—~627Automated safety check: PassMIT

Similar skills

  • Agentbro PR Merge

    shirenchuang/agentbro

    A skill your agent uses when reviewing, fixing CI for, approving workflows for, or merging AgentBro pull requests into dev/main, especially external contributor PRs where contributor attribution…

    203 GitHub stars~648 tokensUpdated 7 days ago
    DevelopmentAuto-check passed
  • Pump Build Release

    nirholas/pump-fun-sdk

    Build and release pipeline for the Pump SDK — tsup TypeScript builds, Cargo release profiles, semantic release with commitizen, npm publishing, linting, Makefile targets, Vercel deployment, and MCP…

    133 GitHub stars~620 tokensUpdated 20 days ago
    DevelopmentAuto-check passed
  • Cdesktop

    cdesktop-ai/cdesktop

    Operate the cdesktop coding-session environment — agent teams, session management, file conventions.

    157 GitHub stars~697 tokensUpdated 4 mo ago
    Backend & APIsAuto-check passed
  • MCP SDK Tier Audit

    modelcontextprotocol/conformance

    Official

    Comprehensive tier assessment for an MCP SDK repository against SEP-1730.

    129 GitHub stars~4.4k tokensUpdated 3 days ago
    MobileAuto-check passed
  • Composio Byo

    drewnekota/cetus

    Connect and use a user-owned Composio MCP server in Cetus. An agent skill from drewnekota/cetus.

    146 GitHub stars~627 tokensUpdated 3 days ago
    Productivity & AutomationAuto-check passed
  • Tenuo Denial Triage

    tenuo-ai/tenuo

    Diagnose a denied Tenuo call and make the legitimate call work with the smallest change to authority.

    102 GitHub stars~2.3k tokensUpdated today
    SecurityAuto-check passed

More from golemcloud/golem

All 289 skills in this repo
  • Moonbit C Binding

    golemcloud/golem

    Guide for writing MoonBit bindings to C libraries using native FFI.

    1.5k GitHub stars~3k tokensUpdated today
    Auto-check passed
  • Adding Dependencies

    golemcloud/golem

    Adding or updating crate dependencies in the Golem workspace.

    1.5k GitHub stars~1k tokensUpdated today
    Auto-check passed
  • Analysing CI Failures

    golemcloud/golem

    Analysing GitHub Actions CI failures from a run URL. An agent skill from golemcloud/golem.

    1.5k GitHub stars~862 tokensUpdated today
    Auto-check passed
  • Adds a built-in WASM plugin that is externally released and provisioned by the registry service.

    1.5k GitHub stars~1.1k tokensUpdated today
    Auto-check passed
  • DB Migration Scripts

    golemcloud/golem

    Writing database migration SQL scripts. An agent skill from golemcloud/golem.

    1.5k GitHub stars~1.5k tokensUpdated today
    Auto-check passed
  • Debugging Hanging Tests

    golemcloud/golem

    Diagnosing and fixing hanging worker executor or integration tests.

    1.5k GitHub stars~879 tokensUpdated today
    Auto-check passed

Categories

Questions about Golem Skill Harness

What does Golem Skill Harness do?

Developing, testing, and running Golem skill scenarios with the TypeScript skill harness. Golem Skill Harness is an agent skill from golemcloud/golem. Developing, testing, and running Golem skill scenarios with the TypeScript skill harness.

When should I use Golem Skill Harness?

Golem Skill Harness fits situations like: creating Golem skills; authoring scenario YAML; running agent matrices; debugging skill activation and behavior failures.

How do I install Golem Skill Harness in Claude Code?

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

How do I install Golem Skill Harness in Codex?

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

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

What does Golem Skill Harness need to run?

Going by SKILL.md and its folder, Golem Skill Harness needs the command-line tools its instructions call (npm, cargo and npx). Our summary lists: Node.js; Docker.

Does Golem Skill Harness access the network?

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

Is Golem Skill Harness 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 Golem Skill Harness use?

Golem Skill Harness 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 Golem Skill Harness use?

About 3.3k tokens (SKILL.md is roughly 13k 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 Golem Skill Harness?

Skills that share tags, products or a category with Golem Skill Harness: Agentbro PR Merge (shirenchuang/agentbro, 203 stars), Pump Build Release (nirholas/pump-fun-sdk, 133 stars), Cdesktop (cdesktop-ai/cdesktop, 157 stars) and MCP SDK Tier Audit (modelcontextprotocol/conformance, 129 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Golem Skill Harness?

golemcloud (a GitHub organization) maintains it in golemcloud/golem, which has 1,507 GitHub stars. The repository holds 289 skills in this directory. The repository was last updated on October 8, 2026.

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