/spicetify

Use this skill when the user wants to inspect, plan, modify, repair, audit, or roll back local Spicetify customizations through a safety-gated agent workflow.

The user-facing skill name is /spicetify. The helper CLI is spicetify-agent. The official Spicetify CLI remains a separate user-installed dependency and must not be bundled, replaced, shadowed, or auto-installed by this skill.

Default Workflow

1. Classify the request into one or more modes.
2. Prefer read-only probes for local state: inspect paths, versions, config shape, staged assets, and existing snapshots.
3. For any possible mutation, produce a dry-run operation plan first.
4. Include policy decision, risk level, plan hash, snapshot requirement, verification steps, and rollback path.
5. Stage and audit third-party code before enabling it.
6. Require explicit confirmation for mutating or high-risk actions.
7. Execute only allowlisted Spicetify argv shapes through spicetify-agent; never pass through arbitrary shell or user-provided argv.
8. Verify after execution and update last-known-good only after required checks pass.
9. Report the result with redaction and the rollback path.

Modes