Put a listing back into an order that carries meaning, moving items only.
Goal
A listing's order is information: kin sit together, and the sequence follows one axis a reader can feel. Order drifts — items get appended where they were written, not where they belong — until the sequence tells the reader nothing. reorder realigns the set under a single, nameable principle so the order reads as intentional again. It is fast and single-purpose: it moves items, and changes nothing else.
Workflow
- Pin the listing and its items — the ordered set in focus.
- Name the principle that makes the order carry the most meaning: workflow or lifecycle sequence, dependency, grouping by kind, severity, frequency, or plain alphabetical. If the set already has a latent order, surface and finish it rather than imposing a new one.
- Cluster kin adjacent, then sequence the clusters by that one principle.
- Move items into the new order in place. Reword nothing; add and remove nothing.
- If the same set is mirrored elsewhere — a translated copy, a second surface — apply the identical order to each.
Rules
- Reorder only. Never reword, add, remove, split, or merge an item; those are other reflexes.
- One principle, and a reader can name it. Do not blend incompatible sorts into one listing.
- Respect a deliberate order. If the current sequence already encodes a real principle, complete and tidy it rather than replacing it; surface the call when it is unclear.
- Keep mirrored copies in lockstep — the same set on different surfaces gets the same order.
- Mutate with edit-safety: assert each item exists before moving it (report a MISS, never a silent drop), edit unicode-safe, and script a large structural move rather than sweeping by hand.
Verification
- A reader can name the ordering principle from the result alone.
- Every item that was there is still there — only positions changed; nothing reworded, added, or removed.
- Kin are adjacent and the sequence follows the one principle end to end.
- Every mirrored copy of the set carries the identical order.
1---
2name: reorder
3disable-model-invocation: true
4description: "Realign a listing whose order has gone arbitrary — a list, table, catalog, sections, an enum — into a logical sequence under one stated principle. Move items only: nothing is reworded, added, or removed. Use when the order no longer helps a reader follow the set."
5metadata:
6 source: https://skillmd.com/skills/lilmgenius/reorder
7---
8
9Put a listing back into an order that carries meaning, moving items only.
10
11## Goal
12
13A listing's order is information: kin sit together, and the sequence follows one axis a reader can feel. Order drifts — items get appended where they were written, not where they belong — until the sequence tells the reader nothing. `reorder` realigns the set under a single, nameable principle so the order reads as intentional again. It is fast and single-purpose: it moves items, and changes nothing else.
14
15## Workflow
16
171. Pin the listing and its items — the ordered set in focus.
182. Name the principle that makes the order carry the most meaning: workflow or lifecycle sequence, dependency, grouping by kind, severity, frequency, or plain alphabetical. If the set already has a latent order, surface and finish it rather than imposing a new one.
193. Cluster kin adjacent, then sequence the clusters by that one principle.
204. Move items into the new order in place. Reword nothing; add and remove nothing.
215. If the same set is mirrored elsewhere — a translated copy, a second surface — apply the identical order to each.
22
23## Rules
24
25- Reorder only. Never reword, add, remove, split, or merge an item; those are other reflexes.
26- One principle, and a reader can name it. Do not blend incompatible sorts into one listing.
27- Respect a deliberate order. If the current sequence already encodes a real principle, complete and tidy it rather than replacing it; surface the call when it is unclear.
28- Keep mirrored copies in lockstep — the same set on different surfaces gets the same order.
29- Mutate with edit-safety: assert each item exists before moving it (report a MISS, never a silent drop), edit unicode-safe, and script a large structural move rather than sweeping by hand.
30
31## Verification
32
331. A reader can name the ordering principle from the result alone.
342. Every item that was there is still there — only positions changed; nothing reworded, added, or removed.
353. Kin are adjacent and the sequence follows the one principle end to end.
364. Every mirrored copy of the set carries the identical order.