[knihit]

Description

Stack: 2 of 9 in the skills stack, directly after #120. Base: feat/agent-skill-index (#120). Depends on #120. First of three PRs that replace #137, split so each can be reviewed on its own: this one adds the measuring and the lint, the next trims the agent specs, the third updates the guide.

Claude Code injects the full SKILL.md of every name in an agent's clientConfig.claudeCli.skills into each subagent it spawns, and that text is re-sent on every turn. Nothing measured or limited it.

CLI:

• konductor synth warns (konductor: warning:) when an agent's preload passes 32,768 B or Claude Code's 32-name cap, and names the dropped skills. On this branch's own tree it prints 9 such warnings, which the next PR removes by trimming the specs.
• synth -v prints a claude preload: line per agent ("preloads N B across K skills") and --json carries a claude_preload array. Both use the same measuring function as the warning.
• The generated Claude agent file ends with a "Skills you can load" block listing declared skills that are not preloaded. The frontmatter emits each preload name once.
• synth warns when an agent lists on-demand skills but cannot use the Skill tool, listing each skill once.
• New e2e test cli/konductor-rs/tests/synth_claude_preload_e2e.rs: a fat fixture skill trips the byte budget, read from synth --json; scratch copies are removed after each test.
• cli/README.md documents the warning and the new -v / --json output.
• CHANGELOG.md: [Unreleased] bullet. No VERSION change.

Type of Change

• CLI (cli/) change: Rust
• Documentation

Testing

• npm test: not run (no JS changed).
• cd cli && make test passes
• Gate on this branch's head, and on the top of the stack (feat/slim-cypress-test-implementation, which contains it): make build && make synth, cd cli && make test (1,836 Rust tests on the top, 0 failed), make test-skills-sh, uvx --with pyyaml pytest -q tests/ (468 passed on the top), make claude-plugin-check. All pass. On this head alone, synth prints the 9 expected preload warnings.
• New or changed code files carry the required SPDX header

Checklist

• My code follows the style guidelines of this project
• I have performed a self-review of my own changes
• I have commented my code where necessary
• I have made corresponding changes to the documentation
• My changes generate no new warnings: cd cli && make lint passes
• I have added or updated tests that prove my change works

Agents Affected

Generated Claude Code agent files gain the "Skills you can load" block; no spec changes here.

Notes for Reviewers

• Review: feat(claude): trim each agent's skill preload and warn on oversized preloads #137 was reviewed before the split (5 findings, all fixed), then each split PR went through adversarial review in rounds until 0 CRITICAL and 0 IMPORTANT findings remained (3 rounds on this one, none CRITICAL or IMPORTANT). Fixes on this branch: the missing Skill grant warning, a scratch-dir drop guard, a self-contained fixture skill, "across N skills" wording and de-duplicated names.
• Benchmark figures are in the trim PR above this one, which is where the cost changes.