New: 98,000+ skills indexed from GitHub repos with 100+ stars · every skill safety-checkedBrowse top skillsTop skills
Esc to closeBrowse all skills
Submit a skillBrowse skills
Submit a skillBrowse skills

Agent skill

Generate Harness Dsl

by QoderAI in QoderAI/better-harness

Generate, revise, or review complete Harness as Code .harness files when a coding-agent workflow, agent role, skill, tool contract, MCP connection, runtime, or deployment must be compiler-valid and…

MITAuto-check passedAgent Workflows

Install Generate Harness Dsl

skills CLI
$ npx skills add QoderAI/better-harness --skill generate-harness-dsl -a claude-code

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

GitHub CLI
$ gh skill install QoderAI/better-harness generate-harness-dsl --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/QoderAI/better-harness.git skills-src && mkdir -p .claude/skills && cp -r skills-src/packages/harness/skills/generate-harness-dsl .claude/skills/generate-harness-dsl && 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
generate-harness-dsl
GitHub stars
2.4k
Token cost
~761 tokens
SKILL.md length
362 words
Files
4 (incl. scripts, references)
Skills in repo
11
Repo updated
First seen
Licence
MIT

At a glance

Generate, revise, or review complete Harness as Code .harness files when a coding-agent workflow, agent role, skill, tool contract, MCP connection, runtime, or deployment must be compiler-valid and…

  • Works in 5 steps: Identify the host, the capabilities it… → Read the DSL contract. Start from → Generate one self-contained document… → …
  • Tasks that involve Multi-agent orchestration
  • SKILL.md covers Workflow, Authoring Rules and Validate
  • Runs JavaScript scripts from its folder; calls node and npm

What it does

Generate Harness Dsl is an agent skill from QoderAI/better-harness. Generate, revise, or review complete Harness as Code .harness files when a coding-agent workflow, agent role, skill, tool contract, MCP connection, runtime, or deployment must be compiler-valid and resolvable with @qoder-ai/harness.

Its SKILL.md is about 760 tokens, which your agent loads only when the skill is triggered. The skill folder holds 6 other files, including scripts and reference files (for example `agents/openai.yaml` and `references/dsl-contract.md`).

It sits in Agent Workflows, covering Multi-agent orchestration and Deployment. It works with Model Context Protocol. The repository describes itself as: An open-source Harness Engineering platform for coding agents—define harnesses as code, run controlled experiments, inspect evidence, and compare outcomes. Turn task evidence… The licence is MIT.

When your agent uses it

  • Tasks that involve Multi-agent orchestration
  • Tasks that involve Deployment

Example prompts

  • “/generate-harness-dsl”

Requirements

  • Node.js

Workflow steps

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

  1. Identify the host, the capabilities it must actually expose, and the real
  2. Read the DSL contract. Start from
  3. Generate one self-contained document unless the user requests a fragment.
  4. Run scripts/validate.mjs. Fix every compiler or resolution error and rerun.
  5. Return the DSL or saved file plus the harness id, deployment id, runtime,

What it can do on your machine

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

    Ships 1 file in scripts/ (JavaScript), which the agent can run.

    Shell commands in SKILL.md call:

    • node
    • npm

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

  • Network

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

Generate Harness Dsl loads about 761 tokens when it runs, and up to ~1.9k if it reads all its reference files. Until then it costs about 64 tokens; SKILL.md has 362 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~64
When it runs · the whole SKILL.md, loaded when a task matches
~761
With references · SKILL.md plus every file in references/, read only if the agent opens them
~1.9k

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); the scripts in this folder are not scanned.

SKILL.md

The full file from QoderAI/better-harness at commit 34899f3, republished under its MIT licence (© QoderAI). 362 words, ~761 tokens.

Download SKILL.mdSave it as .claude/skills/generate-harness-dsl/SKILL.md (or your agent's skills folder). This skill also uses 3 other files; get the full folder from GitHub.
name
generate-harness-dsl
description
Generate, revise, or review complete Harness as Code `.harness` files when a coding-agent workflow, agent role, skill, tool contract, MCP connection, runtime, or deployment must be compiler-valid and resolvable with `@qoder-ai/harness`.

Generate Harness DSL

Create a standalone Harness as Code v0.3 document and prove the execution contract with the package compiler and resolver.

Workflow

  1. Identify the host, the capabilities it must actually expose, and the real control owner. Use session for one host session. Use state-machine or program only when a selected adapter explicitly implements that mode.
  2. Read the DSL contract. Start from the minimal example; open the standard example when callable tools are required.
  3. Generate one self-contained document unless the user requests a fragment. Include language 0.3, every referenced declaration, a concrete runtime, and a named deployment. Standard tools may remain implicit.
  4. Run scripts/validate.mjs. Fix every compiler or resolution error and rerun. A compile-only state machine is not an executable Qoder or Pi deployment.
  5. Return the DSL or saved file plus the harness id, deployment id, runtime, resolution status, and any execution boundary the selected adapter cannot satisfy.

Authoring Rules

  • State only falsifiable requirements. Do not add permission, setting, degradation, binding, input/output-name, or runtime-execution syntax; v0.3 intentionally has none.
  • Match the requirement verb to its capability: use skill, require tool, or connect mcp.
  • Only the standard tool ids in the contract may be undeclared. Every custom tool declares a stable contract id that the adapter exposure must match.
  • Qoder and Pi descriptors run session workflows only. A session workflow names exactly the one agent role declared by each harness that uses it.
  • State-machine outcomes are typed on agents. Every route emitter, outcome, destination, entry, and stop must exist, and every agent must be reachable.
  • A program <language> <entry> workflow resolves only when the adapter lists the same language in programmaticLanguages.
  • Keep credentials out of source. Prefer env.VARIABLE for MCP endpoints, but remember that declaring an endpoint does not connect it; the adapter must do that.
  • Do not invoke host SDKs, install integrations, or claim native enforcement while generating or validating DSL.
Show full SKILL.md (46 more words)Show less

Validate

From this skill directory, run:

sh
node scripts/validate.mjs /path/to/workflow.harness [harness-id ...]

The command prints JSON and exits non-zero when compilation or any selected named deployment fails resolution. A successful exit is required before calling generated DSL executable.

When editing this skill, build the package first so dist/ reflects the current compiler:

sh
npm run harness:build

© QoderAI, MIT. 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 3 other files (scripts, references) in packages/harness/skills/generate-harness-dsl of QoderAI/better-harness.

  • SKILL.md
  • agents/openai.yaml
  • references/dsl-contract.md
  • scripts/validate.mjs

Open the folder on GitHubat commit 34899f3

Compare with similar skills

Generate Harness Dsl 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.

Generate Harness Dsl compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Generate Harness Dsl this skillQoderAI/better-harness2.4k—~761Automated safety check: PassMIT
Team TopologyCotal-AI/Cotal311—~2.9kAutomated safety check: PassApache-2.0
AWS Strands Agents Agentcoresammcj/agentic-coding1621 repos~3kAutomated safety check: PassApache-2.0
FastmcpTommy-yw/RunbookHermes5464 repos~2.1kAutomated safety check: PassMIT
Codex with ChatGPT Planning LoopXiaoDuoYa/codex-with-chatgpt7.1k—~11kAutomated safety check: NotesMIT
MemPalace Task HandoffMemPalace/mempalace59k—~1.9kAutomated safety check: PassMIT

Similar skills

  • Team Topology

    Cotal-AI/Cotal

    Define a multi-agent team for ANY task on ANY system as an explicit deployment topology - pick the shape from the task's dominant risk, specify the runtime/communication/trust layers, place model…

    311 GitHub stars~2.9k tokensUpdated today
    Agent WorkflowsAuto-check passed

  • AWS Strands Agents Agentcore

    sammcj/agentic-coding

    A skill your agent uses when working with AWS Strands Agents SDK or Amazon Bedrock AgentCore platform for building AI agents.

    162 GitHub starsUsed in 1 repo~3k tokens
    DevOps & CloudAuto-check passed

  • Fastmcp

    Tommy-yw/RunbookHermes

    Build, test, inspect, install, and deploy MCP servers with FastMCP in Python.

    546 GitHub starsUsed in 4 repos~2.1k tokens
    Agent WorkflowsAuto-check passed

  • Codex with ChatGPT Planning Loop

    XiaoDuoYa/codex-with-chatgpt

    Uses ChatGPT in the browser as the planning and review brain for a Codex session, with Codex keeping all execution and ChatGPT reading the workspace through a bridge.

    7.1k GitHub stars~11k tokensUpdated 7 days ago
    Agent WorkflowsAuto-check: notes

  • MemPalace Task Handoff

    MemPalace/mempalace

    Creates, hands off, claims, executes and closes agent tasks through the MemPalace logstream, with approval of the exact task before it is recorded.

    59k GitHub stars~1.9k tokensUpdated today
    Agent WorkflowsAuto-check passed

  • agtx One-Shot Project Runner

    fynnfluegge/agtx

    Runs a whole project unattended on an agtx kanban board, decomposing the goal, starting tasks, unblocking workers and merging each result.

    1.7k GitHub stars~3.8k tokensUpdated 6 days ago
    Agent WorkflowsAuto-check passed

More from QoderAI/better-harness

All 11 skills in this repo

  • Intent Correlation Analysis

    QoderAI/better-harness

    Analyze a bounded IntentCorrelationPacketV1 and propose reviewable links among user inputs, execution slices, change units, commits, artifacts, and validation outcomes.

    2.4k GitHub stars~1.2k tokensUpdated 10 days ago
    Auto-check passed

  • Better Harness

    QoderAI/better-harness

    A skill your agent uses when /better-harness reviews the outer coding-agent Harness for lifecycle controls, repeated work, project feedback, agent assets, session outcomes, repair planning, durable…

    2.4k GitHub stars~3k tokensUpdated 10 days ago
    Auto-check passed

  • Harness Skill Creator

    QoderAI/better-harness

    A skill your agent uses when bootstrapping or tightening the smallest harness-oriented skill from an existing repository, workflow, evaluation corpus, or harness-analysis chain.

    2.4k GitHub stars~844 tokensUpdated 10 days ago
    Auto-check passed

  • Skill Review

    QoderAI/better-harness

    A skill your agent uses when reviewing Codex, Qoder, or repo-local skills and their prompt chains for trigger quality, workflow clarity, progressive disclosure, duplicated instructions, template…

    2.4k GitHub stars~802 tokensUpdated 10 days ago
    Auto-check passed

  • Diagnose Backend Bug

    QoderAI/better-harness

    Diagnose a bounded backend or multi-service failure from GitHub Issues, Jira, Aone, user-provided exports, logs, traces, responses, stack traces, or job records.

    2.4k GitHub stars~1.2k tokensUpdated 10 days ago
    Auto-check passed

  • Reproduce Frontend Bug

    QoderAI/better-harness

    Build a bounded, replayable browser or UI bug reproduction from GitHub Issues, Jira, Aone, user-provided exports, screenshots, videos, comments, or attachments.

    2.4k GitHub stars~1.3k tokensUpdated 10 days ago
    Auto-check passed

Works with

Categories

Questions about Generate Harness Dsl

What does Generate Harness Dsl do?

Generate, revise, or review complete Harness as Code .harness files when a coding-agent workflow, agent role, skill, tool contract, MCP connection, runtime, or deployment must be compiler-valid and…. Generate Harness Dsl is an agent skill from QoderAI/better-harness.harness files when a coding-agent workflow, agent role, skill, tool contract, MCP connection, runtime, or deployment must be compiler-valid and resolvable with @qoder-ai/harness.

When should I use Generate Harness Dsl?

Generate Harness Dsl fits situations like: tasks that involve Multi-agent orchestration; tasks that involve Deployment.

How do I install Generate Harness Dsl in Claude Code?

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

How do I install Generate Harness Dsl in Codex?

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

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

What does Generate Harness Dsl need to run?

Going by SKILL.md and its folder, Generate Harness Dsl needs JavaScript for the scripts in its folder and the command-line tools its instructions call (node and npm). Our summary lists: Node.js.

Does Generate Harness Dsl access the network?

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

Is Generate Harness Dsl 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. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Generate Harness Dsl use?

Generate Harness Dsl 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 Generate Harness Dsl use?

About 761 tokens (SKILL.md is roughly 3k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 1.1k tokens, read only when the agent opens those files.

What are the alternatives to Generate Harness Dsl?

Skills that share tags, products or a category with Generate Harness Dsl: Team Topology (Cotal-AI/Cotal, 311 stars), AWS Strands Agents Agentcore (sammcj/agentic-coding, 162 stars), Fastmcp (Tommy-yw/RunbookHermes, 546 stars) and Codex with ChatGPT Planning Loop (XiaoDuoYa/codex-with-chatgpt, 7.1k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Generate Harness Dsl?

QoderAI (a GitHub organization) maintains it in QoderAI/better-harness, which has 2,364 GitHub stars. The repository holds 11 skills in this directory. The repository was last updated on September 28, 2026.

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