Agent skill

Mini Harness

by HangYu8123 in HangYu8123/mini-harness

mini-harness · a supplementary layer over Claude Code and Codex — tags the task, runs online-researcher / diversifier / devils-advocate in addition to the native flow when a trigger fires, keeps a…

No licenceAuto-check passedDevelopment

Install Mini Harness

skills CLI
$ npx skills add HangYu8123/mini-harness --skill mini-harness -a claude-code

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

GitHub CLI
$ gh skill install HangYu8123/mini-harness mini-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/HangYu8123/mini-harness.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/mini-harness .claude/skills/mini-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
mini-harness
GitHub stars
199
Token cost
~1.4k tokens
SKILL.md length
632 words
Files
3
Skills in repo
8
Repo updated
First seen
Licence
None found

At a glance

mini-harness · a supplementary layer over Claude Code and Codex — tags the task, runs online-researcher / diversifier / devils-advocate in addition to the native flow when a trigger fires, keeps a…

  • Keeps a repo memory the agent may consult
  • SKILL.md covers Subcommands — the first word… and A request
  • Runs Shell and Python scripts from its folder; calls bash and python3
  • Records the trajectory

What it does

Mini Harness is an agent skill from HangYu8123/mini-harness. mini-harness · a supplementary layer over Claude Code and Codex — tags the task, runs online-researcher / diversifier / devils-advocate in addition to the native flow when a trigger fires, keeps a repo memory the agent may consult, and records the trajectory. Use only when the user invokes it (/mini-harness · $mini-harness) or it is active in this repo.

Its SKILL.md is about 1.4k tokens, which your agent loads only when the skill is triggered. The skill folder holds 2 other files (for example `mh.sh` and `mh_usage.py`).

It sits in Development. The repository describes itself as: A local minimized harness, with simplified output and logs for self-evolve.

When your agent uses it

  • Keeps a repo memory the agent may consult
  • Records the trajectory
  • Invokes it (/mini-harness · $mini-harness)
  • It is active in this repo

Example prompts

  • “/mini-harness”

Requirements

  • Python 3
  • A Bash shell

What it can do on your machine

Read from SKILL.md and the folder at commit baa821f. 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 script files (Shell and Python), which the agent can run.

    Shell commands in SKILL.md call:

    • bash
    • python3

    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

Mini Harness loads about 1.4k tokens when it runs. Until then it costs about 92 tokens; SKILL.md has 632 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~92
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

Without a licence we can't republish the file, so here is its outline and opening line. It has 632 words (~1,394 tokens).

“Helper: bash "${CLAUDE_SKILL_DIR}/mh.sh" — Claude Code fills the variable; on Codex ${CLAUDE_SKILL_DIR} is this SKILL.md's own folder (.agents/skills/mini-harness standalone, the plugin's skills/mini-harness otherwise). It resolves the workspace root (first directory at or above the cwd with .harness/ or .git) and…”

— opening of SKILL.md by HangYu8123
name
mini-harness
disable-model-invocation
true
argument-hint
on | off | status | doctor | usage [--compare on.json off.json | --rates file | finalize] | routes <words> | effort <level|save|restore|reset> … | subagents…

Read the full SKILL.md on GitHub

Files

SKILL.md and 2 other files in skills/mini-harness of HangYu8123/mini-harness.

  • SKILL.md
  • mh.sh
  • mh_usage.py

Open the folder on GitHubat commit baa821f

Compare with similar skills

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

Mini Harness compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Mini Harness this skillHangYu8123/mini-harness199—~1.4kAutomated safety check: PassNone
Vercel Composition Patternssupabase/supabase111k58 repos~726Automated safety check: PassMIT
Finishing a Development Branchobra/superpowers297k5 repos~1.9kAutomated safety check: PassMIT
Typescript Advanced Typesrolling-scopes/rsschool-app10k25 repos~4.2kAutomated safety check: PassMPL-2.0
PR Babysitteropeninterpreter/openinterpreter69k3 repos~4.2kAutomated safety check: PassApache-2.0
Code Review ChecklistshareAI-lab/learn-claude-code78k5 repos~1.1kAutomated safety check: PassMIT

Similar skills

  • Official

    React composition patterns that scale. An agent skill from supabase/supabase.

    111k GitHub starsUsed in 58 repos~726 tokens
    DevelopmentAuto-check passed
  • 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.

    297k GitHub starsUsed in 5 repos~1.9k tokens
    DevelopmentAuto-check passed
  • Typescript Advanced Types

    rolling-scopes/rsschool-app

    Master TypeScript's advanced type system including generics, conditional types, mapped types, template literals, and utility types for building type-safe applications.

    10k GitHub starsUsed in 25 repos~4.2k tokens
    DevelopmentAuto-check passed
  • PR Babysitter

    openinterpreter/openinterpreter

    Watches an open GitHub pull request until it merges, handling review comments, diagnosing CI failures and retrying flaky checks along the way.

    69k GitHub starsUsed in 3 repos~4.2k tokens
    DevelopmentAuto-check passed
  • Code Review Checklist

    shareAI-lab/learn-claude-code

    Reviews code against a five-part checklist covering security, correctness, performance, maintainability and testing, and reports findings in a fixed format.

    78k GitHub starsUsed in 5 repos~1.1k tokens
    DevelopmentAuto-check passed
  • Greploop

    onyx-dot-app/onyx

    Iteratively improves a PR (GitHub), MR (GitLab), or shelved changelist (Perforce) until Greptile gives it a 5/5 confidence score with zero unresolved comments.

    32k GitHub starsUsed in 4 repos~3.3k tokens
    DevelopmentAuto-check passed

More from HangYu8123/mini-harness

All 8 skills in this repo
  • Breakdown PR

    HangYu8123/mini-harness

    Plan and optionally execute a large pull request split into small stacked PRs.

    199 GitHub stars~2.8k tokensUpdated 17 days ago
    Auto-check passed
  • Code Review And Quality

    HangYu8123/mini-harness

    Multi-axis, review-only code review of a diff across six axes — request achievement, correctness, readability/simplicity, architecture, security, and performance — with severity-labelled findings.

    199 GitHub stars~1.8k tokensUpdated 17 days ago
    Auto-check passed
  • Code Simplification

    HangYu8123/mini-harness

    Simplify code for clarity while preserving exact behavior — reduce nesting, split long functions, remove redundancy and dead code, and fix unclear names.

    199 GitHub stars~1.2k tokensUpdated 17 days ago
    Auto-check passed
  • Mh Init

    HangYu8123/mini-harness

    mini-harness · initialize or re-initialize a repo's memory under .harness/repoinfo/ with a multi-agent pass — three-perspective codebase overview, ranked scripts map, issue scan, git-seeded update…

    199 GitHub stars~2.6k tokensUpdated 17 days ago
    Auto-check passed
  • Mh Loop

    HangYu8123/mini-harness

    mini-harness · repeat a pass toward a verifiable goal until a check passes or a safety stop fires — spec → validate → confirm → loop (pass · observe · exit check · ledger) → review → record.

    199 GitHub stars~2.8k tokensUpdated 17 days ago
    Auto-check passed
  • Mh Wiki

    HangYu8123/mini-harness

    mini-harness · consolidate execution trajectories (.harness/exectraj/) into repoinfo/harnesseffect.md — which parts of the harness helped or hurt, root causes, and one proposed change at a time.

    199 GitHub stars~1.6k tokensUpdated 17 days ago
    Auto-check passed

Categories

Questions about Mini Harness

What does Mini Harness do?

mini-harness · a supplementary layer over Claude Code and Codex — tags the task, runs online-researcher / diversifier / devils-advocate in addition to the native flow when a trigger fires, keeps a…. Mini Harness is an agent skill from HangYu8123/mini-harness. mini-harness · a supplementary layer over Claude Code and Codex — tags the task, runs online-researcher / diversifier / devils-advocate in addition to the native flow when a trigger fires, keeps a repo memory the agent may consult, and records the trajectory.

When should I use Mini Harness?

Mini Harness fits situations like: keeps a repo memory the agent may consult; records the trajectory; invokes it (/mini-harness · $mini-harness); it is active in this repo.

How do I install Mini Harness in Claude Code?

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

How do I install Mini Harness in Codex?

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

Can I use Mini 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 HangYu8123/mini-harness --skill mini-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/mini-harness, .gemini/skills/mini-harness, .github/skills/mini-harness and .opencode/skills/mini-harness in your project.

What does Mini Harness need to run?

Going by SKILL.md and its folder, Mini Harness needs a shell and Python for the scripts in its folder and the command-line tools its instructions call (bash and python3). Our summary lists: Python 3; A Bash shell.

Does Mini Harness 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 Mini 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 Mini Harness use?

No licence was found for Mini Harness or its repository. Without one, default copyright applies: ask the author before reusing or redistributing it.

How many tokens does Mini Harness use?

About 1.4k tokens (SKILL.md is roughly 5.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 Mini Harness?

Skills that share tags, products or a category with Mini Harness: Vercel Composition Patterns (supabase/supabase, 111k stars), Finishing a Development Branch (obra/superpowers, 297k stars), Typescript Advanced Types (rolling-scopes/rsschool-app, 10k stars) and PR Babysitter (openinterpreter/openinterpreter, 69k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Mini Harness?

HangYu8123 (a GitHub user) maintains it in HangYu8123/mini-harness, which has 199 GitHub stars. The repository holds 8 skills in this directory. The repository was last updated on September 22, 2026.

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