harness-mint

Scaffolds custom AI agent harnesses via metaharness with dry-run safety checks.

70.1k|8.4k|Updated Jun 2, 2025
One-click install
npx skills add https://github.com/ruvnet/claude-flow --skill harness-mint
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: harness-mint
Source: https://github.com/ruvnet/claude-flow/tree/main/plugins/ruflo-metaharness/skills/harness-mint
Command: npx skills add https://github.com/ruvnet/claude-flow --skill harness-mint

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

Scaffolding a new AI agent harness involves write operations that can accidentally overwrite or pollute the current repository. This Skill wraps the metaharness new command with mandatory dry-run behavior and path safety checks so nothing is written to disk until explicitly confirmed.

Core Features & Use Cases

  • Dry-run by default: Without --confirm, the script prints the full scaffold plan (name, template, host, target) and exits without touching disk.
  • Path safety enforcement: Refuses to write to the calling repository root or any path inside it, and refuses to overwrite existing directories.
  • Template and host selection: Supports 20 templates (minimal, vertical:coding, vertical:devops, vertical:legal, etc.) and 9 hosts (claude-code, codex, copilot, github-actions, etc.).
  • Use Case: You want to prototype a coding-focused agent harness for Claude Code. Run the skill with --name my-harness --template vertical:coding --host claude-code, review the dry-run plan, then re-run with --confirm to scaffold into a fresh temp directory.

Quick Start

Ask the AI to scaffold a new agent harness named my-harness using the vertical:coding template for claude-code, review the dry-run output, then confirm to write it.

Frequently Asked Questions about harness-mint

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I scaffold a new AI agent harness with metaharness?

Run the mint script with --name, --template, and optionally --host and --target. It performs a dry-run first showing the planned action; add --confirm to actually execute `npx metaharness new` and write the scaffold.

What templates are available for agent harness scaffolding?

Twenty templates are supported: minimal plus vertical templates for coding, devops, support, legal, research, trading, health, education, sales, business, crm, marketing, advertising, ai, agentics, ruview, gaming, repo-maintainer, and exotic.

Which agent hosts does harness scaffolding support?

Nine hosts are supported: claude-code (the default), codex, pi-dev, hermes, openclaw, rvm, copilot, opencode, and github-actions. Specify one with the --host flag.

Why does harness-mint refuse to write to my project directory?

The skill intentionally blocks writes to the calling repository root or any path inside it, exiting with code 2. The target must be an absolute path outside the repo, defaulting to a fresh /tmp/ruflo-mint directory.

Can harness-mint overwrite an existing scaffold directory?

No. The target directory must not already exist; the script refuses to overwrite. Choose a new path or remove the existing directory before re-running with --confirm.