Agent skill

Harness Setup

by Chachamaru127 in Chachamaru127/claude-code-harness

HAR: Project init, tool setup, agent config, memory setup, skill mirror sync.

MITAuto-check: notesAgent Workflows

Install Harness Setup

skills CLI
$ npx skills add Chachamaru127/claude-code-harness --skill harness-setup -a claude-code

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

GitHub CLI
$ gh skill install Chachamaru127/claude-code-harness harness-setup --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/Chachamaru127/claude-code-harness.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/harness-setup .claude/skills/harness-setup && 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
harness-setup
GitHub stars
3.2k
Token cost
~1.4k tokens
SKILL.md length
347 words
Files
9 (incl. references)
Skills in repo
25
Repo updated
First seen
Licence
MIT

At a glance

HAR: Project init, tool setup, agent config, memory setup, skill mirror sync.

  • Works in 4 steps: ユーザーの目的に対応する Quick Reference 行を選ぶ。 → 該当する ${CLAUDE_SKILL_DIR}/references/*.md… → 参照ファイルの手順に従い、dry-run がある操作は dry-run… → …
  • Tasks that involve Product roadmapping
  • SKILL.md covers Quick Reference, Execution, Upstream Policy Anchors and Cursor 実装バックエンド導入, plus 2 more sections
  • Calls claude, bash and codex

What it does

Harness Setup is an agent skill from Chachamaru127/claude-code-harness. HAR: Project init, tool setup, agent config, memory setup, skill mirror sync. Trigger: setup, init, new project, CI/Codex setup, harness-mem, mirror. Do NOT load for: implementation, review, release, planning.

Its SKILL.md is about 1.4k tokens, which your agent loads only when the skill is triggered. The skill folder holds 9 other files, including reference files (for example `references/ci.md`, `references/codex.md` and `references/cursor.md`).

It sits in Agent Workflows, covering Product roadmapping. The repository describes itself as: Claude Code Dedicated Development Harness - Achieving High-Quality Development Through an Autonomous Plan→Work→Review Cycle. The licence is MIT.

When your agent uses it

  • Tasks that involve Product roadmapping

Example prompts

  • “/harness-setup”

Requirements

  • Pre-approved tools (allowed-tools): Read, Write, Edit, Grep, Glob, Bash

Workflow steps

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

  1. ユーザーの目的に対応する Quick Reference 行を選ぶ。
  2. 該当する ${CLAUDE_SKILL_DIR}/references/*.md を読む。
  3. 参照ファイルの手順に従い、dry-run がある操作は dry-run を先に実行する。
  4. setup 後は必要に応じて harness doctor、bash scripts/sync-skill-mirrors.sh --check、bash scripts/ci/check-consistency.sh で確認する。

What it can do on your machine

Read from SKILL.md and the folder at commit 2b2b748. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves these tools, so the agent can use them without asking each time:

    • Read
    • Write
    • Edit
    • Grep
    • Glob
    • Bash

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • claude
    • bash
    • codex

    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

Harness Setup loads about 1.4k tokens when it runs, and up to ~6.3k if it reads all its reference files. Until then it costs about 56 tokens; SKILL.md has 347 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~56
When it runs · the whole SKILL.md, loaded when a task matches
~1.4k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~6.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: notes

The automated check noted patterns worth knowing about, such as sudo or a known installer.

  • NotePre-approves every shell command (allowed-tools: Bash)SKILL.md
    allowed-tools: Read, Write, Edit, Grep, Glob, Bash

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 Chachamaru127/claude-code-harness at commit 2b2b748, republished under its MIT licence (© Chachamaru127). 347 words, ~1,423 tokens.

Download SKILL.mdSave it as .claude/skills/harness-setup/SKILL.md (or your agent's skills folder). This skill also uses 8 other files; get the full folder from GitHub.
name
harness-setup
description
HAR: Project init, tool setup, agent config, memory setup, skill mirror sync. Trigger: setup, init, new project, CI/Codex setup, harness-mem, mirror. Do NOT load for: implementation, review, release, planning.
allowed-tools
Read, Write, Edit, Grep, Glob, Bash
description-en
HAR: Project init, tool setup, agent config, memory setup, skill mirror sync. Trigger: setup, init, new project, CI/Codex setup, harness-mem, mirror. Do NOT…
description-ja
HAR:プロジェクト初期化・ツール設定・エージェント構成・メモリ設定・skill mirror 同期を担当。セットアップ、初期化、新規プロジェクト、CI/Codex CLI セットアップ、harness-mem、mirror で起動。実装・レビュー・リリース・プランニングには使わない。
kind
workflow
purpose
Initialize and repair Harness project configuration
trigger
setup, init, new project, CI/Codex setup, harness-mem, mirror
shape
workflow
role
generator
pair
harness-sync
owner
harness-core
since
2026-05-05

Harness Setup

Harness の統合セットアップスキル。 以下の旧スキルを統合:

  • setup — 統合セットアップハブ
  • harness-init — プロジェクト初期化
  • harness-update — Harness アップデート
  • maintenance — ファイル整理・クリーンアップ

Quick Reference

サブコマンド動作詳細
/harness-setup init新規プロジェクト初期化(CLAUDE.md + Plans.md + hooks + sync + doctor)${CLAUDE_SKILL_DIR}/references/init.md
/harness-setup ciCI/CD パイプライン設定${CLAUDE_SKILL_DIR}/references/ci.md
/harness-setup codexCodex CLI インストール・設定${CLAUDE_SKILL_DIR}/references/codex.md
/harness-setup harness-memharness-mem 統合・メモリ設定${CLAUDE_SKILL_DIR}/references/harness-mem.md
/harness-setup mirrorsskills/ → 公開 mirror bundle 更新${CLAUDE_SKILL_DIR}/references/mirrors-agents-localize.md
/harness-setup agentsagents/ エージェント設定${CLAUDE_SKILL_DIR}/references/mirrors-agents-localize.md
/harness-setup localizeCLAUDE.md ルールのローカライズ${CLAUDE_SKILL_DIR}/references/mirrors-agents-localize.md
marketplace / updatePlugin install, update, dependency policy${CLAUDE_SKILL_DIR}/references/marketplace.md
maintenanceファイル整理・クリーンアップ${CLAUDE_SKILL_DIR}/references/maintenance.md

Built-in slash discovery (CC 2.1.108+): /init のような built-in slash command も発見される。 Harness 固有の bootstrap が必要な時だけ /harness-setup init と使い分ける。

Claude Code setup guidance (CC 2.1.120+): MCP alwaysLoad、${CLAUDE_EFFORT}、claude plugin prune、claude project purge、 ANTHROPIC_BEDROCK_SERVICE_TIER、claude_code.skill_activated.invocation_trigger、 Windows PowerShell primary shell、forked skills / subagents の deferred tools は docs/claude-code-setup-mcp-telemetry-provider.md を正本として扱う。

Codex plugin workflows: Codex /goal と Plans.md を二重管理しない。 plugin-bundled hooks は opt-in、external agent import は ownership 明記、 MultiAgentV2 / agents.max_threads = 8 は上限として扱い、 sticky environments / app-server artifacts は safe default を優先する。 Codex 0.130.0 stable の codex remote-control、large thread pagination、 selected-environment view_image、live app-server config refresh、 accurate turn diffs、plugin details bundled hooks、sharing discoverability controls は docs/codex-plugin-workflows-policy.md を正本として扱う。 詳細は docs/codex-plugin-workflows-policy.md と ${CLAUDE_SKILL_DIR}/references/codex.md を参照。

Execution

状態確認だけの依頼は read-only の診断で完了する。setup 依頼は対象、望む状態、合格条件を既存設定と照合し、明示された surface の変更を進める。 不足情報は設定や契約を読み取りで回収する。任意機能を追加したり、対象外の設定や保護された設定を目的から推測して変更したりしない。

  1. ユーザーの目的に対応する Quick Reference 行を選ぶ。
  2. 該当する ${CLAUDE_SKILL_DIR}/references/*.md を読む。
  3. 参照ファイルの手順に従い、dry-run がある操作は dry-run を先に実行する。
  4. setup 後は必要に応じて harness doctor、bash scripts/sync-skill-mirrors.sh --check、bash scripts/ci/check-consistency.sh で確認する。

Upstream Policy Anchors

  • docs/plugin-managed-settings-policy.md — plugin managed settings policy; normal defaults must not inherit managed marketplace restrictions.
  • docs/codex-provider-setup-policy.md — Codex provider setup policy, including amazon-bedrock and model_provider = "amazon-bedrock" examples.
  • Codex 0.123.0 以降の MCP diagnostics / plugin MCP loading guidance: use /mcp verbose and docs/codex-mcp-diagnostics.md for diagnostics.
  • Codex sandbox / execution policy (0.123.0+): see docs/codex-sandbox-execution-policy.md for remote_sandbox_config and execution constraints.

Cursor 実装バックエンド導入

詳細手順は ${CLAUDE_SKILL_DIR}/references/cursor.md を読む。 契約アンカー: set-impl-backend.sh は AI 実行可。permissions.json、.cursorignore、*.cursor.sh allowlist はユーザー手動で、AI が編集できない protected path として扱う。 根拠ルールは .claude/rules/cursor-cli-only.md と docs/sandbox-allowlist-recipe.md。

Reference Index

  • ${CLAUDE_SKILL_DIR}/references/init.md — init, Go binary verification, plugin sync, doctor.
  • ${CLAUDE_SKILL_DIR}/references/ci.md — GitHub Actions CI setup.
  • ${CLAUDE_SKILL_DIR}/references/codex.md — Codex CLI, provider/model metadata, app-server, MCP diagnostics, sandbox policy.
  • ${CLAUDE_SKILL_DIR}/references/cursor.md — Cursor implementation backend setup and boundaries.
  • ${CLAUDE_SKILL_DIR}/references/harness-mem.md — memory directory and template setup.
  • ${CLAUDE_SKILL_DIR}/references/mirrors-agents-localize.md — mirror sync, agent setup, localization.
  • ${CLAUDE_SKILL_DIR}/references/marketplace.md — plugin marketplace install/update and managed dependency policy.
  • ${CLAUDE_SKILL_DIR}/references/maintenance.md — cleanup commands and related skills.

関連スキル

  • harness-sync — 設定/Plans/git 状態の同期確認
  • harness-work — 実装タスク実行
  • harness-review — 品質レビュー
  • maintenance — ファイル整理(統合済み)

© Chachamaru127, 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 8 other files (references) in skills/harness-setup of Chachamaru127/claude-code-harness.

  • SKILL.md
  • references/ci.md
  • references/codex.md
  • references/cursor.md
  • references/harness-mem.md
  • references/init.md
  • references/maintenance.md
  • references/marketplace.md
  • references/mirrors-agents-localize.md

Open the folder on GitHubat commit 2b2b748

Compare with similar skills

Harness Setup 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.

Harness Setup compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Harness Setup this skillChachamaru127/claude-code-harness3.2k—~1.4kAutomated safety check: NotesMIT
Living Product Scope Plannerjsmastery-pro/skills1.4k—~2.8kAutomated safety check: NotesMIT
Product Strategistalirezarezvani/claude-skills28k2 repos~1.8kAutomated safety check: PassMIT
Strategic Roadmap Planningdeanpeters/Product-Manager-Skills7.2k2 repos~4.7kAutomated safety check: PassCustom licence
Walking Skeleton Roadmap Scopingprime-radiant-inc/iterative-development181—~1.7kAutomated safety check: PassApache-2.0
AI Product Strategy InterviewerPrepLabsAI/InterviewMentor112—~4.5kAutomated safety check: PassMIT

Similar skills

  • Living Product Scope Planner

    jsmastery-pro/skills

    Turns a product idea into a coarse, ordered scope kept in docs/scope, then keeps it current: plan a product, plan the next slice, enroll one feature or reconcile after shipping.

    1.4k GitHub stars~2.8k tokensUpdated 1 mo ago
    Product & Project ManagementAuto-check: notes
  • Product Strategist

    alirezarezvani/claude-skills

    OKR cascade toolkit for product leaders: generates aligned company-to-team OKRs from five strategy types and scores how well they line up.

    28k GitHub starsUsed in 2 repos~1.8k tokens
    Product & Project ManagementAuto-check passed
  • Strategic Roadmap Planning

    deanpeters/Product-Manager-Skills

    Sequences prioritization, epic definition, and stakeholder alignment into a release plan that ladders up to business outcomes.

    7.2k GitHub starsUsed in 2 repos~4.7k tokens
    Product & Project ManagementAuto-check passed
  • Walking Skeleton Roadmap Scoping

    prime-radiant-inc/iterative-development

    Turns extracted requirements into a roadmap by choosing a walking skeleton iteration with its first journey scenario and ordering the remaining work into follow-on iterations.

    181 GitHub stars~1.7k tokensUpdated 4 mo ago
    Product & Project ManagementAuto-check passed
  • AI Product Strategy Interviewer

    PrepLabsAI/InterviewMentor

    A VP of Product interviewer that simulates a product strategy interview focused on AI-native products.

    112 GitHub stars~4.5k tokensUpdated today
    Product & Project ManagementAuto-check passed
  • Product Planner

    BuildGreatProducts/builder-os

    Vision intake conversation followed by generation of three product documents — docs/product-vision.md (strategy and brand), docs/prd.md (technical spec for coding agents), and…

    227 GitHub stars~4.6k tokensUpdated 3 mo ago
    Product & Project ManagementAuto-check passed

More from Chachamaru127/claude-code-harness

All 25 skills in this repo
  • CI Failure Triage and Repair

    Chachamaru127/claude-code-harness

    Diagnoses failing CI pipelines and tests, deciding first whether the test or the implementation is at fault, and hands hard cases to a dedicated fixer subagent.

    3.2k GitHub starsUsed in 1 repo~1.1k tokens
    Auto-check: notes
  • Cursor Composer Task Delegate

    Chachamaru127/claude-code-harness

    Hands one implementation task to Cursor Composer in an isolated git worktree, then reviews its diff and cherry-picks the result into the main branch.

    3.2k GitHub stars~4.4k tokensUpdated 2 days ago
    Auto-check: notes
  • Acceptance Demo Generator

    Chachamaru127/claude-code-harness

    Renders a single HTML page showing each acceptance criterion as verified or not, with a ship, wait, or reject recommendation for non-engineers.

    3.2k GitHub stars~3.4k tokensUpdated 2 days ago
    Auto-check: notes
  • Harness Long-Running Task Loop

    Chachamaru127/claude-code-harness

    Repeats a long task as a series of scheduled wake-ups, each re-entering with fresh context and calling harness-work for one task per cycle.

    3.2k GitHub stars~2.3k tokensUpdated 2 days ago
    Auto-check: notes
  • Harness Plan

    Chachamaru127/claude-code-harness

    Creates and maintains Plans.md task plans with a spec delta, updates task markers and syncs plan progress with the implementation.

    3.2k GitHub stars~3.7k tokensUpdated 2 days ago
    Auto-check: notes
  • Harness Release

    Chachamaru127/claude-code-harness

    Runs a release for any project that keeps a Keep a Changelog file on GitHub, from version bump to merge, tag and GitHub Release after a single approval.

    3.2k GitHub stars~4.4k tokensUpdated 2 days ago
    Auto-check: notes

Questions about Harness Setup

What does Harness Setup do?

HAR: Project init, tool setup, agent config, memory setup, skill mirror sync. Harness Setup is an agent skill from Chachamaru127/claude-code-harness. HAR: Project init, tool setup, agent config, memory setup, skill mirror sync.

When should I use Harness Setup?

Harness Setup fits situations like: tasks that involve Product roadmapping.

How do I install Harness Setup in Claude Code?

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

How do I install Harness Setup in Codex?

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

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

What does Harness Setup need to run?

Going by SKILL.md and its folder, Harness Setup needs the command-line tools its instructions call (claude, bash and codex). Its frontmatter pre-approves these tools: Read, Write, Edit, Grep, Glob, Bash.

Does Harness Setup 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 Harness Setup safe to install?

Our automated static check of SKILL.md found notes only (pre-approves every shell command (allowed-tools: bash)), nothing it rates as a warning. It is not a guarantee. Review the folder before installing.

What licence does Harness Setup use?

Harness Setup 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 Harness Setup use?

About 1.4k tokens (SKILL.md is roughly 5.7k 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 4.9k tokens, read only when the agent opens those files.

What are the alternatives to Harness Setup?

Skills that share tags, products or a category with Harness Setup: Living Product Scope Planner (jsmastery-pro/skills, 1.4k stars), Product Strategist (alirezarezvani/claude-skills, 28k stars), Strategic Roadmap Planning (deanpeters/Product-Manager-Skills, 7.2k stars) and Walking Skeleton Roadmap Scoping (prime-radiant-inc/iterative-development, 181 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Harness Setup?

Chachamaru127 (a GitHub user) maintains it in Chachamaru127/claude-code-harness, which has 3,153 GitHub stars. The repository holds 25 skills in this directory. The repository was last updated on October 5, 2026.

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