harness-customize

Generate per-skill TOML overrides for Harness agent and workflow surfaces.

1|Updated May 23, 2026
One-click install
npx skills add https://github.com/baobao0303/harness --skill harness-customize
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: harness-customize
Source: https://github.com/baobao0303/harness/tree/main/.agents/skills/harness-customize
Command: npx skills add https://github.com/baobao0303/harness --skill harness-customize

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires tomllib, and includes scripts (resource) components.

What problem does it solve?

It eliminates the guesswork of changing agent or workflow behavior by generating the correct per-skill TOML override files and guiding verification against your installed Harness setup.

Core Features & Use Cases

  • Discovers customizable Harness skills by scanning installed skills for [agent] and/or [workflow] customization surfaces and reporting which already have team/user overrides.
  • Routes changes to the correct surface (agent vs workflow) based on what the user wants to modify and what the target customize.toml exposes.
  • Authors sparse, correct TOML overrides under {project-root}/_harness/custom/ with proper merge semantics (scalars override, append arrays extend, keyed tables replace by key).
  • Verifies the outcome by running the resolver so the merged configuration is shown and inconsistencies can be corrected without inventing unsupported fields.

Quick Start

Ask an AI coding agent to customize Harness by running the harness-customize flow to override a specific installed skill after you say which agent or workflow you want to change and what behavior you want.

Frequently Asked Questions about harness-customize

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

FAQPage Schema
How do I override agent behavior in Harness without modifying the original configuration files?

To override agent behavior, generate sparse TOML customization overrides in the `{project-root}/_harness/custom/` directory. This safely layers your changes without altering base installed skill files.

What is the safest way to apply workflow configuration changes to installed Harness skills?

The safest workflow configuration method is routing changes to the correct `[workflow]` surface exposed in `customize.toml`. This generates sparse overrides with proper merge semantics, ensuring append arrays extend rather than replace existing settings.

How do I verify that my TOML overrides merge correctly with existing Harness configuration?

You verify TOML override merges by running the `resolve_customization.py` resolver script. It shows the final merged configuration, allowing you to catch and correct inconsistencies without inventing unsupported fields.

Can I customize both agent and workflow surfaces simultaneously using TOML overrides?

Yes, you can customize both surfaces. The process scans installed skills for `[agent]` and `[workflow]` customization surfaces, routing your intent to the appropriate target and writing correctly-scoped per-skill overrides for each.

What are the merge semantics when applying sparse TOML overrides to Harness skills?

The merge semantics dictate that scalar values override existing settings, append arrays extend current lists, and keyed tables replace entries by key. This prevents unintentional data loss during configuration.

Do I need tomllib to run Harness customization verification?

Yes, `tomllib` is required. This dependency supports the parsing and verification of TOML files, enabling the resolver script to accurately merge and display your configuration overrides.