os-say-simple

1# os-say-simple
2 
3A text exists and the user cannot use it. This skill rewrites it into words
4they can act on - the pack's rescue skill: the others fire at moments of work,
5this one whenever any text, including your own, needs saying again properly.
6It changes only the words. Never the facts.
7 
8## Language
9 
10Write in the language the user speaks in this session. Detect it from the
11conversation. Keep code, file names and identifiers in English.
12 
13## When to use
14 
15- The user asks for simpler or shorter, in any phrasing: "say it simply",
16  "in plain words", "what does this mean", "I don't understand", "too long",
17  "wait, what?", "bro".
18- The user pastes text and asks what it says.
19- The user gives the skill a number - they want exactly that many points.
20 
21Not this skill:
22 
23- "Is this true?" is verification - `os-check-work`; a restatement stays
24  exactly as true as its source.
25- "What do I do?" right after an answer that asked the user to act is a
26  walkthrough - `os-step-by-step`. Asked about the road ahead, it is
27  `os-whats-next`.
28 
29## What text to restate
30 
311. Whatever the user points at: pasted text, a named file, a report in the
32   reports folder. Read it if it is a file.
332. Nothing pointed at: your own last substantial answer. A bare "wait, what?"
34   always means the thing you just said.
35 
36## The controlled-language rules
37 
38Drawn from the ideas behind ASD-STE100, the Simplified Technical English
39standard from aerospace manuals. This pack follows the ideas; it does not
40…