step-by-step — Claude Code skill: setup guide
This skill turns a manual task into a concrete sequence with filled-in values, direct links, and a final check. Use it for first-time service or secret setup.
npx skills add timschoch/skilly --skill step-by-step -a claude-codeWhat step-by-step does
The skill guides an agent to turn a manual procedure into numbered actions: which page to open, what to enter, and which option to select. It calls for real project values, deep links, and warnings at the point where a wrong choice could stay hidden. The final action checks the outcome.
The agent sends one handover block and then waits for the user's report. Longer work is split at completed checkpoints, so the next section is held back until the current one is checked. Secret handling gets its own step, including a warning not to paste the value into chat and a way to verify it without exposing the value.
Automatic invocation is disabled in Claude Code, so the skill must be started manually. Installing it with npx requires command-line access to the timschoch/skilly repository.
What it helps with
- turn a service setup into numbered actions
- fill a form with exact project values
- reach the right settings page directly
- verify that a token or secret works
- split a long procedure at usable checkpoints
Example prompts for the agent
- Walk me through creating the token for this project. Send one complete handover block, then wait.
- Break the secret setup from
.github/workflows/*into manual steps with exact values and a final test. - I am setting up this service for the first time. Tell me what to click and flag the choices that are easy to get wrong.
How to install step-by-step
1Skills CLI (Vercel)
npx skills add timschoch/skilly --skill step-by-step -a claude-code2Manually: put the files in place
~/.claude/skills/step-by-step/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/step-by-step/
1Skills CLI (Vercel)
npx skills add timschoch/skilly --skill step-by-step -a codex2Manually: put the files in place
.agents/skills/step-by-step/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add timschoch/skilly --skill step-by-step -a cursor2Manually: put the files in place
.cursor/skills/step-by-step/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install timschoch/skilly step-by-step2Manually: put the files in place
.github/skills/step-by-step/SKILL.md1Skills CLI (Vercel)
npx skills add timschoch/skilly --skill step-by-step -a gemini-cli2Platform CLI
gemini skills install https://github.com/timschoch/skilly --path bundles/workflow/skills/step-by-stepManually: put the files in place
.devin/skills/step-by-step/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add timschoch/skilly --skill step-by-step -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about step-by-step
How do I install step-by-step in Claude Code?
Run npx skills add timschoch/skilly --skill step-by-step -a claude-code. After installation, the skill file is at ~/.claude/skills/step-by-step/SKILL.md.
What does step-by-step do?
It guides the agent to write a manual procedure as concrete actions with direct links, field values, warnings, and a closing test. The agent pauses after handing over the block.
How does step-by-step handle secrets?
A secret gets a dedicated step that names its destination. The user is told not to put the value in chat, while confirmation uses a property such as its prefix, length, or final characters.