clean-slate

Back up and remove board-steward state to restore a clean first-run environment.

13|2|Updated May 27, 2026
One-click install
npx skills add https://github.com/malcolm1232/WorkBoard --skill clean-slate
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: clean-slate
Source: https://github.com/malcolm1232/WorkBoard/tree/main/skills/clean-slate
Command: npx skills add https://github.com/malcolm1232/WorkBoard --skill clean-slate

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill resets a board-steward installation to a true fresh-user state by removing stale runtime data, stopping lingering services, and preventing old state from suppressing the first-run experience.

Core Features & Use Cases

  • Full teardown with backup: Preserves board JSON files and ~/.board-steward state before deleting anything, so the previous setup can be restored if needed.
  • Runtime cleanup: Kills listening board servers, removes launchd autostart entries, purges registry and onboarding markers, and deletes board sidecar files.
  • Clean reinstall preparation: Uninstalls the plugin and clears cached plugin code so a later reinstall pulls fresh repository files instead of replaying stale versions.

Quick Start

Ask the assistant to run the clean-slate skill so it backs up existing board-steward data, removes runtime state and cached plugin files, and prepares the machine for a truly fresh reinstall.

Frequently Asked Questions about clean-slate

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I wipe board-steward state for a clean reinstall?▼

To wipe board-steward state for a clean reinstall, this skill backs up existing data, kills listening servers, removes launchd agents, purges ~/.board-steward, and clears cached plugin code to restore a true first-run environment.

Does resetting board-steward delete my board.json and sidecar files permanently?▼

Resetting board-steward does not permanently delete board.json and sidecar files; the skill creates a backup of board JSON files and ~/.board-steward state before purging them for safe teardown.

What's the best way to remove stale launchd agents and board servers?▼

The best way to remove stale launchd agents and board servers is using a teardown process that kills listening runtime processes and deletes autostart entries to prevent old state from suppressing the first-run experience.

When do I need to clear cached plugin code for board-steward?▼

You need to clear cached plugin code when preparing for a clean reinstall, ensuring the machine pulls fresh repository files instead of replaying stale versions during the next installation.

Can I use this teardown process for fresh-user testing validation?▼

Yes, you can use this teardown process for fresh-user testing validation because it removes onboarding markers and registry data to accurately restore a clean first-run environment.

Why does old board-steward state suppress the first-run experience?▼

Old board-steward state suppresses the first-run experience because lingering runtime data, active listeners, and onboarding markers prevent the plugin from triggering the initial setup sequence.