Skip to content
Skills Library
Programming · Automation

plot-twist

/plot-twist

Carry a change of direction into every place that still holds the old one: repo text, tickets, pull requests, decision records. Use when the user says "actually", "instead" or "forget that", when a decision you built on is replaced, when a test overturns a recorded rule, and when a ticket records a decision (an answered anomaly or away team) that an earlier plan or doc contradicts.

Licence
MIT
Last repository change
13.11.2026

Assessment and security

90/ 100Class: good
Format25 / 25
Frontmatter with name and description, valid name, description up to 1,024 characters, name matching the folder.
Discoverability25 / 25
Description explains when to use the skill, has a reasonable length and uses third person.
Content25 / 35
At least 150 words and at most 500 lines, headings, step lists, examples or code.
Hygiene15 / 15
No placeholders such as TODO, no Windows paths, with a licence.
Riskno signals detected in the scan
Files in this package
1
Scripts
0
HTML comments
0
URLs in SKILL.md
0
Deprecation

No signals detected. Repository changed on 13.11.2026, without references to retired models or APIs.

Licence

MIT, open: use and modify while retaining author attribution.

What it does and when to use it

Carry a change of direction into every place that still holds the old one: repo text, tickets, pull requests, decision records. Use when the user says "actually", "instead" or "forget that", when a decision you built on is replaced, when a test overturns a recorded rule, and when a ticket records a decision (an answered anomaly or away team) that an earlier plan or doc contradicts.

Triggers from the description

actuallyinsteadforget that
Original author description

Carry a change of direction into every place that still holds the old one: repo text, tickets, pull requests, decision records. Use when the user says "actually", "instead" or "forget that", when a decision you built on is replaced, when a test overturns a recorded rule, and when a ticket records a decision (an answered anomaly or away team) that an earlier plan or doc contradicts.

How it works

  1. Steps
Original SKILL.md headings · 25 lines, 402 words
SKILL.md preview
---
name: plot-twist
description: Carry a change of direction into every place that still holds the old one: repo text, tickets, pull requests, decision records. Use when the user says "actually", "instead" or "forget that", when a decision you built on is replaced, when a test overturns a recorded rule, and when a ticket records a decision (an answered anomaly or away team) that an earlier plan or doc contradicts.
---

# Plot twist

> _The twist is canon now. Rewrite every page that says otherwise._

A **pivot** is the new truth. Left only in the chat, it dies with the session, while every ticket and doc that holds the old decision keeps steering the next agent wrong. So the pivot lands everywhere in the same turn.

When you can't tell whether a message is a pivot, ask in one line: "Going with Y instead of X, correct?"

## Steps

1. **Name it.** Say the new decision in one sentence and name what it replaces. A change the user didn't name, such as dropping a line or an option, goes in that sentence as a question, never into the pivot. Done when the user can confirm or correct one line.
2. **Find the old decision.** Search every place that can state it, never a list of files you picked:
   - the whole repo: `git grep -n -i -E '<old wording>|<key term>'`, decision records and agent files included;
   - every open ticket in the tracker, by title and body, whatever effort it belongs to: an open ticket that plans the old decision reads as live work;
   - the open pull requests the effort touches, and the wiki or docs site the repo mirrors to.

   Read each hit's thread whole, body and comments. Done when every search has run and each hit is on the list, or the search is on the "couldn't reach" list.
3. **Rewrite each place now.** Edit ticket and pull request bodies in place, so they state only the new decision; a comment saying "see chat" settles nothing. Replace a decision record with `decision-record`: it writes the new record, which names the force that changed, and appends one Status line to the old one. Edit nothing else in the old record. Its own call back to this skill is the run already under way. Update the repo's docs and agent files in the effort's branch. Write text a person reads with `human-voice`, and agent files with `robot-voice`. Done when every place on the list is rewritten or on the "couldn't reach" list.
4. **Report** what you changed and what you couldn't reach, one line each. Done when both lists are in your reply.

A pivot overrides the project's earlier decisions. It never overrides the user's standing rules (their global agent file), which change only when they say so.

Charter: C3 ([CHARTER.md](../../CHARTER.md)).

Versions

The database has no other skills named plot-twist.

Database snapshot: 13.11.2026 · package version a7926c85c505 (SHA-256 digest of the entire package)

Downloads in the last 30 days: 0 · ranking

Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.

Similar skills

No similar skills in the database.

Feedback and reports

Your message goes to Bartosz Sokoliński. An email address is needed only for a reply. See the privacy policy.