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.