feat: add ccmanager-config skill installable via claude/codex

[kbwo]

Why

CCManager stays silent when its configuration is wrong. An unparseable .ccmanager.json is discarded whole (ProjectConfigManager.loadProjectConfig swallows the parse error), and keys it does not know are never read — so a typo is indistinguishable from a feature that does not work. Getting a config right today means reading the TypeScript types.

This adds an agent skill that carries the schema and can check a file for exactly those silent failures, so .ccmanager.json can be written or repaired by asking for it in plain language.

What

plugins/ccmanager-config/ is a plugin holding one skill: the procedure in SKILL.md, a per-key reference, goal-oriented recipes, a JSON Schema covering both config files, and a dependency-free validator. The plugin README describes the layout.

Beyond schema shape, the validator reports the mistakes JSON cannot express: an unknown key (with a did-you-mean), a defaultPresetId matching no preset, duplicate preset ids, an args entry holding several tokens in one string, a detectionStrategy contradicting command, a shortcut that can never fire, a hook left disabled, an autoDirectoryPattern without {branch}, and a .ccmanager.json placed inside a linked worktree — which CCManager resolves back to the main checkout, so the file is never read.

.claude-plugin/marketplace.json at the repository root turns this repo into a plugin marketplace. Codex accepts Claude's plugin manifests, so one set of files installs from either CLI; the commands are in the READMEs.

Incidental doc fixes

Three claims in docs/ that the source contradicts, corrected because the skill would otherwise contradict the documentation:

• docs/project-config.md showed a command key. No config reader reads it; commandPresets is the supported shape.
• docs/auto-approval.md stated a fixed 60 s timeout. It is autoApproval.timeout, defaulting to DEFAULT_TIMEOUT_SECONDS (120).
• docs/worktree-auto-directory.md listed {branch-name} as a placeholder. The substitution regex matches word characters only, so a dashed placeholder is left in the path verbatim.

Verification

• bun run lint, bun run typecheck: pass.
• bun run test: passes, including the new validate-examples.test.ts, which runs the shipped validator over every configuration example in the skill so the docs and the validator cannot drift apart. Six pre-existing *.submodule.test.* suites fail locally because the sandbox blocks git config --global; they are unrelated to this change and untouched by it.
• Installed the plugin end-to-end with both claude plugin install and codex plugin add against throwaway config homes: the skill is discovered by both, with every file copied.

🤖 Generated with Claude Code