secrets-rotation
Installation
SKILL.md
secrets-rotation — an exposed secret is spent
Deleting the message, rewriting git history or redacting the log does not un-expose a secret: the transcript, the remote, the backup and the provider's own logs already hold it. The only fix is to make the exposed value worthless — revoke it and issue a new one.
What went wrong on real projects is not ignorance of that. It is that the rotation was remembered instead of tracked: "rotate the exchange API keys" was carried forward through seven session logs; "keys that passed through chat" appeared in seven summaries of another project; a monitoring token pasted in plain text was never rotated. Each session wrote the reminder again and nobody owned it.
The moment you see one
- Never repeat the value. Not in your answer, not in a task title, not in a log, not
in a commit message. Name its kind and where it is: "OpenRouter API key, in the
operator's message of 22.09, 14:10".
scripts/lib/secret-patterns.mjsnames the kind. - Say it plainly, first line: this key is compromised; revoking it is the only fix.
- Open one task, not a note — in Beads if the project has it: