Optional practices
The /deviation-log Skill
Record why implementation departs from the plan as it happens.
Read the agent instructions ↗On this page
When to use it
A non-trivial build encounters a constraint that changes the planned approach.
Try it with your agent
/deviation-log Track changes from the approved plan during this implementation.What you get
- A temporary deviation-log.md with the original approach, new constraint, choice, and safety rationale.
Requirements and boundaries
- An implementation with a stated approach or plan.
Update the log when the decision happens; routine work is not a deviation.
Conservative implementation choices can proceed within scope. Strategic changes still need the user’s decision.
Before merge, fold useful findings into the PR description or a review artifact, then remove the scratch log.
Install with the official skills CLI. Version 1.7.0 requires Node.js 22.20.0 or later, npm/npx, Git, and network access. The command pins this catalogue’s source branch to master; @latest may change CLI requirements.
Installation defaults to the current project. The CLI lets you select agents and symlink or copy files; add --global only when you want a user-wide installation. Update with npx skills update. Review local changes before updating; this catalogue does not provide a backup guarantee.
Install deviation-log
Choose your agent, then run the command in your terminal. Read the installation guide for package setup and update notes.
npx skills@latest add https://github.com/MrCoder/mrcoder.github.io/tree/master --skill deviation-log