StepByStep

StepByStep turns the current session's research, summary, plan, or partially completed work into an interactive one-step-at-a-time instruction mode.

Usage

Invoke it with:

• /stepbystep
• /sbs
• stepbystep
• sbs
• @stepbystep

The plugin asks for one concrete action at a time, defines a checkpoint test, then waits for feedback such as pass, next, back, regress, revise, skip, or done.

Agent Support

Codex

Codex uses the repo-local marketplace:

.agents/plugins/marketplace.json
plugins/stepbystep/.codex-plugin/plugin.json
plugins/stepbystep/skills/stepbystep/SKILL.md

Install or add this repository as a Codex marketplace, then enable stepbystep@stepbystep.

Claude Code

Claude Code uses the Claude plugin package:

.claude-plugin/marketplace.json
claude-plugin/.claude-plugin/plugin.json
claude-plugin/commands/stepbystep.md
claude-plugin/commands/sbs.md
claude-plugin/skills/stepbystep/SKILL.md

During development, load it directly:

claude --plugin-dir ./claude-plugin

OpenCode

OpenCode discovers project skills and commands from:

.opencode/skills/stepbystep/SKILL.md
.opencode/commands/stepbystep.md
.opencode/commands/sbs.md
.agents/skills/stepbystep/SKILL.md

The package mirror also lives at:

plugins/stepbystep-opencode/

Pi

Pi Coding Agent discovers Agent Skills from:

.pi/skills/stepbystep/SKILL.md
.agents/skills/stepbystep/SKILL.md

The package mirror also lives at:

plugins/stepbystep-pi/

Use /skill:stepbystep to force the skill in Pi, or ask naturally with sbs or stepbystep.

Layout

• .agents/plugins/marketplace.json - local Codex marketplace manifest
• .claude-plugin/marketplace.json - Claude Code marketplace manifest
• claude-plugin/ - Claude Code plugin package
• .opencode/ - project-local OpenCode skills and commands
• .pi/ - project-local Pi skill
• .agents/skills/ - portable Agent Skills discovery path
• plugins/stepbystep/ - Codex plugin package
• plugins/stepbystep-opencode/ - OpenCode package mirror
• plugins/stepbystep-pi/ - Pi package mirror
• scripts/sync-mirrors.sh - refresh all mirrors from the Codex skill source
• tests/test_stepbystep_plugin.sh - structural validation

Run validation:

./scripts/sync-mirrors.sh
./tests/test_stepbystep_plugin.sh