os-step-by-step

Featured

ALWAYS invoke this skill when you need the user to act - run a command, paste a secret, click, approve - and whenever they ask how to do something or say they do not know what to do: "step by step", "walk me through it", "what do I do", "what should I do", "I don't understand what to do", "explain what I need to do", in any language. Picking which task comes next is os-whats-next; this skill is for doing the thing in front of you. First earn the ask: try it yourself, find another route, shrink it to the part only they can do. Then one action per step, commands labelled by what they touch, no jargon. Commands are single lines that prompt for any value - typing hidden for secrets - and confirm in plain words. Afterwards verify their step.

AI & Automation 355 stars 67 forks Updated yesterday MIT

Install

View on GitHub

Quality Score: 93/100

Stars 20%
85
Recency 20%
100
Frontmatter 20%
70
Documentation 15%
100
Issue Health 10%
50
License 10%
100
Description 5%
100

Skill Content

# os-step-by-step The user is not stuck because the task is hard - they cannot tell what they are being asked to do. This skill turns "I need something from you" into an instruction a person who does not read code can follow without a follow-up question. `os-done-or-not` reports *that* something is needed; this one says exactly *how*. ## Language Write in the language the user speaks in this session, detected from the conversation. Commands, file names and identifiers stay English. ## When to use Triggers live in the description above - any moment you need the user's hands, or they ask what to do. ## Step 0 - earn the right to ask Every ask costs the user a context switch. Prove it is necessary; stop at the first item that clears the block: 1. **Try it.** A real 403 is a finding; "I probably lack permission" is a guess. 2. **Find another route.** Another tool, a value already on the host, a file you can read. 3. **Shrink the ask.** Obtain what you can yourself; hand over only the irreducible part. 4. **Check you are not asking twice** - search the session and the reports folder first. Three walls where asking IS the correct move, never to be worked around: pulling a secret into your own context, loosening a guard that is there on purpose, doing what the user said only they do. ## The shape Always this order - the ask first, never after the diagnosis. ``` **What I need from you: <one sentence, plain words>.** Why you and not me: <one or two sentences. A r...

Details

Author
kharmanskyi
Repository
kharmanskyi/open-steps
Created
2 weeks ago
Last Updated
yesterday
Language
Shell
License
MIT

Bundled in these plugins

Similar Skills

Semantically similar based on skill content — not just same category

AI & Automation Featured

os-whats-next

ALWAYS invoke this skill when the user asks what to do next, what is left, or what is blocked - "what's next", "what now", "what should we work on", "anything I can do" - in any language. This skill picks the next piece of work; when the user asks HOW to do a thing or says they do not understand what to do, that is os-step-by-step. Reads the last report, local changes, open pull requests and always the backlog. First finishes what is finished: verified-ready pull requests merge in the same pass. Then sorts the rest into doable-alone and needs-you, ending with one recommended next task in plain words - what it closes or unblocks. Never invents tasks.

355 Updated yesterday
kharmanskyi
AI & Automation Featured

os-ask-simple

ALWAYS invoke this skill before asking the user any technical question or offering options, and whenever they ask to be asked in plain words - "ask simple", "ask me simply", "ask me in plain words" - or ask if something is worth doing or if something simpler would do, in any language. Rewrites the question in plain words and always ends with one marked recommendation. A structural choice first passes six checks, shown as a table: effort now, simpler substitute, extra work later, lock-in, over-engineering, easy to undo. Doing nothing is always weighed.

355 Updated yesterday
kharmanskyi
AI & Automation Featured

os-say-simple

ALWAYS invoke this skill when the user asks for simpler or shorter about something said or written - "say it simply", "what does this mean", "I don't understand your answer", "too long", "wait, what?", "bro" - in any language, about any text: your own answer, a report, a review comment, an error. "I don't understand what to DO" is os-step-by-step; this skill restates text. It restates for a reader who does not read code: leads with the point, keeps every number, warning and caveat - no facts added, no bad news dropped. A number returns exactly that many points, most important first.

355 Updated yesterday
kharmanskyi