# step-by-step

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.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 652 installs
- Author: timschoch
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/timschoch/skilly/tree/HEAD/bundles/workflow/skills/step-by-step/SKILL.md
- Updated: 2026-10-23
- HTML: https://affpapa.org/en/nevibecode/skills/step-by-step

## What it 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.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add timschoch/skilly --skill step-by-step -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/step-by-step/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/step-by-step/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add timschoch/skilly --skill step-by-step -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/step-by-step/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add timschoch/skilly --skill step-by-step -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/step-by-step/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install timschoch/skilly step-by-step
```

2. **Manually: put the files in place**
- File: `.github/skills/step-by-step/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add timschoch/skilly --skill step-by-step -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/timschoch/skilly --path bundles/workflow/skills/step-by-step
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/step-by-step/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add timschoch/skilly --skill step-by-step -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/timschoch/skilly/tree/HEAD/bundles/workflow/skills/step-by-step/SKILL.md

## When to use it
- 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
- 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.

## Similar
- [grill-with-docs](https://affpapa.org/en/nevibecode/skills/grill-with-docs.md) — skill · 1219756 installs
- [skill-creator](https://affpapa.org/en/nevibecode/skills/skill-creator.md) — skill · 414180 installs
- [setup-matt-pocock-skills](https://affpapa.org/en/nevibecode/skills/setup-matt-pocock-skills.md) — skill · 1052851 installs
- [handoff](https://affpapa.org/en/nevibecode/skills/handoff.md) — skill · 1038491 installs
- [triage](https://affpapa.org/en/nevibecode/skills/triage.md) — skill · 990453 installs
- [domain-modeling](https://affpapa.org/en/nevibecode/skills/domain-modeling.md) — skill · 876391 installs

From the same set: [timschoch/skilly](https://affpapa.org/en/nevibecode/by/timschoch/skilly.md) — 16 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md