setup-agent-harness

Configure repositories for the agent-harness plugin by updating .gitignore and settings.local.json.

1|Updated Jan 4, 2026
One-click install
npx skills add https://github.com/bossjones/boss-skills --skill setup-agent-harness
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: setup-agent-harness
Source: https://github.com/bossjones/boss-skills/tree/main/plugins/boss-dev/agent-harness/skills/setup-agent-harness
Command: npx skills add https://github.com/bossjones/boss-skills --skill setup-agent-harness

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires python3, uv, and includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill automates the process of setting up a repository to be compatible with the agent-harness plugin, ensuring necessary configurations are in place.

Core Features & Use Cases

  • Automate Gitignore Configuration: Safely updates the .gitignore file to manage runtime artifacts from agent-harness hooks.
  • Configure settings.local.json: Merge custom settings like $schema, statusLine, outputStyle, and enabledPlugins into the user-specific settings file.
  • Backup: Creates backups of configuration files before making any changes, preventing accidental loss of data.
  • Use Case: When setting up a new repository for the agent-harness plugin, this Skill will ensure the correct configuration is applied without requiring manual editing.

Quick Start

Use the setup-agent-harness skill to make your repository ready for agent-harness. Simply run the command uv run setup-agent-harness in your repository root directory.

Frequently Asked Questions about setup-agent-harness

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

FAQPage Schema
How do I configure my repository for the agent-harness plugin?

Configuring a repository for the agent-harness plugin involves merging custom settings into `settings.local.json` and updating `.gitignore` to manage runtime artifacts from hooks.

What files does agent-harness setup modify in my project?

The agent-harness setup modifies `.gitignore` to manage hook runtime artifacts and merges custom settings into `settings.local.json` to enable the plugin within the Claude Code environment.

Do I need Python to run the agent-harness repository setup?

Yes, executing the agent-harness repository setup requires Python3 and `uv` installed, alongside a Claude Code environment, to properly apply the configurations.

Is it safe to update settings.local.json automatically for agent-harness?

Yes, the setup process creates backups of your configuration files before applying any changes, preventing accidental data loss when updating `settings.local.json` or `.gitignore`.

What is the best way to manage runtime artifacts from agent-harness hooks?

The best way to manage runtime artifacts from agent-harness hooks is to configure `.gitignore` automatically via the setup script, ensuring repository cleanliness without manual editing.