How do I install the Preset CLI Mutations skill?

Run npx skillmds@latest add preset-io/preset-cli-mutations in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Preset CLI Mutations safe to use?

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Preset CLI Mutations?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Preset CLI Mutations free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Preset CLI Mutations?

preset-io (@preset-io) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Preset CLI Mutations by preset-io — Agent Skill

Name: Preset CLI Mutations
Author: preset-io

Preset CLI Mutations

State-changing Preset `sup` CLI workflows: chart/dashboard/dataset push, user push/invite, destructive flags, and cross-workspace sync. Use only for CLI mutation workflows. Do not use for MCP-only work. Do not use for direct HTTP/SDK mutations.

preset-io 6a017e2 7 files · 18.1 KB Updated Sep 17, 2026

File contents

preset-cli-mutations

Use for state-changing CLI operations: single-workspace writes (push, --force, --overwrite) and cross-workspace promotion (sync).

Always

Use preset-cli first to establish auth, workspace, and output context.
CLI mutation surface only; route HTTP mutations to preset-api-skills.
Preview before execution: native --dry-run for sup sync run, sup user push, and sup user invite; pull-and-diff for sup chart push / sup dashboard push / sup dataset push (no native --dry-run).
Identify source AND target workspace explicitly before any cross-workspace operation.
Require explicit typed user confirmation that contains the literal --force / --overwrite flag string when applicable.
Redact tokens and credential-bearing output in transcripts.

Decision Rules

Distinguish single-workspace writes (sup chart/dashboard/dataset push) from cross-workspace sync (sup sync run).
Treat --force and --overwrite as destructive flags; never invoke without explicit per-flag confirmation.
For mutating command groups not named on this card, load command coverage and stop unless it explicitly marks the command as mutation-gated.
Do not let CI / automation context bypass the confirmation step; refuse if no interactive operator is available.
Route HTTP mutations to the API plugin; route MCP-driven workflows to the MCP plugin.

Workflow Order

Resolve source and (if cross-workspace) target workspace.
Validate configuration where the command supports it (e.g. sup sync validate) before previewing.
Preview / diff to surface what will change.
Summarize asset counts, target effects, rollback expectations, and any destructive flags.
Ask for typed confirmation containing the literal destructive flag string.
Stop before execution and wait for the typed confirmation.
Execute only after confirmation.

Retrieve

Single-workspace writes (push, --overwrite, --force, dependency handling): references/write-operations.md
Cross-workspace promotion (sync, source/target, Jinja2, --dry-run): references/cross-workspace-sync.md
Sync templating, rollback, and multi-target risk: references/sync-templating-and-rollback.md
Preview and dry-run handling: references/preview-and-dry-run.md
Confirmation template and abort triggers: references/confirmation-template.md
Confirmation overview and audit expectations: references/confirmation-and-dry-run.md
Registered command coverage and uncovered mutation routing: load preset-cli and then references/command-coverage.md.
Approval gates, redaction, abort triggers: load preset-cli and then references/safety-policy.md.

---name: preset-cli-mutationsdescription: State-changing Preset `sup` CLI workflows: chart/dashboard/dataset push, user push/invite, destructive flags, and cross-workspace sync. Use only for CLI mutation workflows. Do not use for MCP-only work. Do not use for direct HTTP/SDK mutations.---# preset-cli-mutationsUse for state-changing CLI operations: single-workspace writes (push, --force, --overwrite) and cross-workspace promotion (sync).## Always- Use `preset-cli` first to establish auth, workspace, and output context.- CLI mutation surface only; route HTTP mutations to `preset-api-skills`.- Preview before execution: native `--dry-run` for `sup sync run`, `sup user push`, and `sup user invite`; pull-and-diff for `sup chart push` / `sup dashboard push` / `sup dataset push` (no native `--dry-run`).- Identify source AND target workspace explicitly before any cross-workspace operation.- Require explicit typed user confirmation that contains the literal `--force` / `--overwrite` flag string when applicable.- Redact tokens and credential-bearing output in transcripts.## Decision Rules- Distinguish single-workspace writes (`sup chart/dashboard/dataset push`) from cross-workspace sync (`sup sync run`).- Treat `--force` and `--overwrite` as destructive flags; never invoke without explicit per-flag confirmation.- For mutating command groups not named on this card, load command coverage and stop unless it explicitly marks the command as mutation-gated.- Do not let CI / automation context bypass the confirmation step; refuse if no interactive operator is available.- Route HTTP mutations to the API plugin; route MCP-driven workflows to the MCP plugin.## Workflow Order1. Resolve source and (if cross-workspace) target workspace.2. Validate configuration where the command supports it (e.g. `sup sync validate`) before previewing.3. Preview / diff to surface what will change.4. Summarize asset counts, target effects, rollback expectations, and any destructive flags.5. Ask for typed confirmation containing the literal destructive flag string.6. Stop before execution and wait for the typed confirmation.7. Execute only after confirmation.## Retrieve- Single-workspace writes (push, `--overwrite`, `--force`, dependency handling): [references/write-operations.md](references/write-operations.md)- Cross-workspace promotion (sync, source/target, Jinja2, `--dry-run`): [references/cross-workspace-sync.md](references/cross-workspace-sync.md)- Sync templating, rollback, and multi-target risk: [references/sync-templating-and-rollback.md](references/sync-templating-and-rollback.md)- Preview and dry-run handling: [references/preview-and-dry-run.md](references/preview-and-dry-run.md)- Confirmation template and abort triggers: [references/confirmation-template.md](references/confirmation-template.md)- Confirmation overview and audit expectations: [references/confirmation-and-dry-run.md](references/confirmation-and-dry-run.md)- Registered command coverage and uncovered mutation routing: load `preset-cli` and then `references/command-coverage.md`.- Approval gates, redaction, abort triggers: load `preset-cli` and then `references/safety-policy.md`.

Frequently asked questions