tune

Marshmallow Tune

Tune skills only when the user wants Marshmallow to change durable skill behavior. Skill overlays are optional downstream use of Marshmallow recall. The graph supplies source-backed defaults; the target skill keeps its own procedure.

Choose Targets

Run:

"${CLAUDE_PLUGIN_ROOT}/scripts/marshmallow.py" scan-skills --project "$PWD"

Recommend skills where personal taste, product judgment, writing style, design direction, or architectural defaults materially change the result. Avoid deterministic checklist skills unless the user explicitly asks.

Draft Overlay

Use recall first, then check compact indexes and graph nodes directly:

"${CLAUDE_PLUGIN_ROOT}/scripts/marshmallow.py" recall "<skill|topic|label>"
rg -n "<skill|topic|label>" ~/.marshmallow/indexes
rg -n "<skill|topic|label>" ~/.marshmallow/graph

Use references/overlay-template.md. Keep the overlay short, source-backed, and scoped to defaults, quality bars, anti-patterns, and ask-when rules. Do not copy the full graph into a skill. Use only the 2-5 graph nodes that actually change this skill.

Before drafting, answer four questions:

• What kind of signal is each selected node?
• What exact evidence supports it?
• What should this skill do differently?
• Where should this alignment not apply?

Preview And Apply

Preview:

"${CLAUDE_PLUGIN_ROOT}/scripts/marshmallow.py" overlay preview \
  --skill "<skill-path>" \
  --overlay "<overlay-path>"

Apply only after explicit approval:

"${CLAUDE_PLUGIN_ROOT}/scripts/marshmallow.py" overlay apply \
  --skill "<skill-path>" \
  --overlay "<overlay-path>"

For a read-only or plugin-cache skill, do not edit the cached file. Offer a writable aligned copy instead:

"${CLAUDE_PLUGIN_ROOT}/scripts/marshmallow.py" overlay apply \
  --skill "<source-skill>" \
  --overlay "<overlay-path>" \
  --aligned-copy

Starter Skill

If no existing skill is worth tuning, preview a starter skill:

"${CLAUDE_PLUGIN_ROOT}/scripts/marshmallow.py" starter preview --overlay "<overlay-path>"

Apply only after explicit approval:

"${CLAUDE_PLUGIN_ROOT}/scripts/marshmallow.py" starter apply --overlay "<overlay-path>"

Rollback

Preview:

"${CLAUDE_PLUGIN_ROOT}/scripts/marshmallow.py" overlay rollback --skill "<skill-path>"

Apply only after explicit approval:

"${CLAUDE_PLUGIN_ROOT}/scripts/marshmallow.py" overlay rollback --skill "<skill-path>" --approve

Rollback restores bytes from the backup and restores or removes the overlay store according to the backup record beside it.