Wipes workflow history and temporary artifacts to allow for a clean state.

Install

mkdir -p .claude/skills/reset && curl -L -o skill.zip "https://agentskills.codes/api/skills/download/11379" && unzip -o skill.zip -d .claude/skills/reset && rm skill.zip

Installs to .claude/skills/reset

Activation

This is the description your AI agent reads to decide when to run this skill — the better it matches your request, the more reliably it fires.

Resets workflow artifacts (.otto/ directory). Removes sessions, tasks, and specs. Use when starting over. Destructive - requires confirmation.
142 chars✓ has a “when” trigger
Beginner

Key capabilities

  • Clear workflow artifacts from the `.otto/` directory
  • Remove specific targets like tasks, specs, or sessions
  • Preview what will be removed with sizes before deletion
  • Require explicit user confirmation before proceeding with deletion
  • Report on the completion of the reset operation

How it works

The skill checks for the `.otto/` directory, parses specified targets, previews the files to be removed, requests user confirmation, and then deletes the targeted directories.

Inputs & outputs

You give it
Optional targets (tasks, specs, sessions, or all) to clear
You get back
Confirmation of cleared workflow data and a report of the reset operation

When to use reset

  • Starting a project over
  • Cleaning up workflow workspace
  • Resetting agent session data

About this skill

Reset workflow data. Selectively or fully clears the .otto/ directory.

Available Targets

TargetDirectoryContents
tasks.otto/tasks/Task lists
specs.otto/specs/Specifications
sessions.otto/sessions/Browser sessions
allAbove targetsEverything except docs (default)

Usage Examples

  • reset - Clear everything (prompts for confirmation)
  • reset tasks - Clear only task lists
  • reset specs tasks - Clear specs and tasks
  • reset sessions - Clear browser sessions only
  • reset all - Explicit full reset

Workflow

1. Check for .otto/

if [[ ! -d ".otto" ]]; then
  echo "No .otto/ directory found. Nothing to reset."
  exit 0
fi

If no .otto/ exists, report and stop.

2. Parse Arguments

Map targets to directories:

tasks    -> .otto/tasks/
specs    -> .otto/specs/
sessions -> .otto/sessions/
all      -> tasks + specs + sessions (NOT docs)

If no arguments or all specified, target tasks, specs, and sessions. Docs are always preserved.

3. Preview Removal

Show what will be removed with sizes:

du -sh <target_dirs> 2>/dev/null

Display to user:

Will remove:
  .otto/tasks/ (4K)
  .otto/specs/ (8K)

4. Confirm

Prompt the user to confirm before proceeding:

"This will delete the selected workflow data. Continue?" Options: "Yes, reset" / "Cancel"

5. Remove

After confirmation, remove only the targeted directories:

rm -rf <target_dirs>

For all, remove tasks, specs, and sessions (preserving docs):

rm -rf .otto/tasks .otto/specs .otto/sessions .otto/otto

7. Report

Reset complete. Cleared: tasks, specs
Run otto or spec to continue.

When not to use it

  • When the `.otto/` directory does not exist
  • When the user does not confirm the deletion
  • When the goal is to preserve workflow artifacts

Limitations

  • Requires explicit user confirmation for deletion
  • Only operates within the `.otto/` directory
  • Docs are always preserved

How it compares

This skill provides a controlled, confirmed deletion of specific workflow artifacts within the `.otto/` directory, offering selective clearing and a safety preview, unlike a general file deletion command.

Compared to similar skills

reset side by side with the closest alternatives in the catalog.

SkillInstallsUpdatedSafetyDifficulty
reset (this skill)02moReviewBeginner
tmux202moReviewIntermediate
jira116moNo flagsBeginner
triaging-issues52moReviewIntermediate

Try saying

Example prompts that trigger this skill in your AI assistant.

Search skills

Search the agent skills registry