CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

optimize-harness

Audit one or all supported agent harnesses (claude, codex, opencode, pi, omp, antigravity, crush) for config efficiency, hook overhead, permission friction, plugin and MCP cost, skill metadata portability, dead config, and measured session friction. Use when invoked as `$optimize-harness [harness ...] [focus]`, or when the user asks to optimize or compare agent harness configuration.

Quality

88%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

SKILL.md
Quality
Evals
Security

Quality

Content

81%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

A highly actionable, well-sequenced audit procedure with strong validation gates and real, well-integrated reference files. Its main costs are token weight in SKILL.md itself — long environment-specific sections that belong in references — which pulls down conciseness and progressive disclosure.

Suggestions

Move the 'Tracked configuration coverage' triage detail and the never-track table into a references/ file (e.g. references/tracked-config-coverage.md), keeping only the `just audit-ignored-config` command and the Critical-severity rule inline in SKILL.md.

Trim the procedural-skill exception paragraph in 'Plugins and skills' by moving the named-skill examples (`using-git-worktrees`, `backlog-batch-delivery`, `executing-plans`) into a reference or short list, keeping the general rule inline.

Compress the 'Control-plane note' to the protected-path list and the single proposal workflow pointer, moving the `ness policy` candidate/proposal detail into a reference file.

DimensionReasoningScore

Conciseness

The body is information-dense with no concept explanations Claude already knows, but several sections could be tightened or relocated: the ~75-line 'Tracked configuration coverage' triage with its table, the 'Control-plane note' path inventory, and long exception parentheticals like "(for example `using-git-worktrees` pointing at `/git:worktree`) or sits inside a workflow the user started explicitly (`backlog-batch-delivery` steps, `executing-plans` finishing with `branch-finish`)". This is more than the 'minor instances' of the 4 anchor, but well short of the padding of the 2 anchor.

3 / 5

Actionability

Guidance is copy-paste executable throughout: `python3 ~/scripts/harness-sessions.py <slugs> --since <N> --json`, `just audit-ignored-config .omp .pi`, `git log --oneline -- <hook script>`, `codex debug prompt-input`, a concrete YAML snippet for `agents/openai.yaml`, a worked example ("$optimize-harness claude hooks since:14"), and a complete output template. Common cases are covered by specific commands, matching the 5 anchor.

5 / 5

Workflow Clarity

The 'Execution shape' gives a clearly numbered sequence ('Run one deterministic scan first', fan out audits capped at 3 concurrent, structural transcript privacy boundary) with explicit validation gates ("A finding with no evidence is dropped, not softened"; "Never render `unknown/not observed` as `unused`"), error-recovery paths for invalid tokens ("stop and print the two valid token sets above. Do not guess") and absent harnesses ("reported as `not installed / not configured` and skipped"), plus a read-only guardrail ("Do not mutate config during the audit"). Sequence, checkpoints, and a dimension checklist are all present, satisfying the 5 anchor rather than the 4.

5 / 5

Progressive Disclosure

All three bundle references exist and are clearly signaled with when-to-read guidance (`references/harness-map.md`, `references/session-usage-evidence.md`, `references/agent-harness-portability.md`), and they are one level deep within the bundle. However, the long inline 'Tracked configuration coverage' section and the portability mapping rules (which duplicate `references/agent-harness-portability.md`) are content that could live in reference files, and reference files point onward to out-of-bundle docs (`docs/agent-session-transcripts.md`) — minor organization gaps that fit the 4 anchor rather than the clean split of the 5 anchor.

4 / 5

Total

17

/

20

Passed

Description

92%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

A strong description: concrete and comprehensive about what it audits, with an explicit dual 'Use when' trigger clause and a distinctive, well-bounded niche. The only weakness is trigger-term breadth — a few natural user phrasings are not covered.

DimensionReasoningScore

Specificity

The description enumerates seven concrete audit areas ("config efficiency, hook overhead, permission friction, plugin and MCP cost, skill metadata portability, dead config, and measured session friction") and names all seven target harnesses explicitly. Coverage of what the skill audits is comprehensive rather than leaving minor gaps, so it matches the 5 anchor over the 4 anchor.

5 / 5

Completeness

It explicitly answers both questions: what ("Audit one or all supported agent harnesses... for [seven named areas]") and when ("Use when invoked as `$optimize-harness [harness ...] [focus]`, or when the user asks to optimize or compare agent harness configuration") with concrete trigger phrases, matching the 5 anchor exactly.

5 / 5

Trigger Term Quality

Natural trigger phrases are present ("Use when... the user asks to optimize or compare agent harness configuration", plus terms like "audit", "hooks", "permissions", "plugins", "MCP" and the explicit "$optimize-harness" invocation). A few natural variations users might say (e.g. "speed up", "tune", "clean up config") are missing, which keeps it at 4 rather than 5; it is well above the 3 anchor's 'missing common variations' because the core intent words are covered.

4 / 5

Distinctiveness Conflict Risk

It occupies a clear niche — multi-harness configuration auditing with seven named harnesses — and its triggers include the explicit "$optimize-harness" invocation syntax, making conflict with other skills minimal. It is not the 4 anchor because no meaningful overlap risk with closely related skills is identifiable.

5 / 5

Total

19

/

20

Passed

Validation

93%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

referenced_paths_exist

Referenced path issues: 6 missing

Warning

Total

15

/

16

Passed

Repository

phatblat/dotfiles

Path

.agents/skills/optimize-harness/SKILL.md

Reviewed

Table of Contents

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.