Claude-skill-registry-data marshall-steward

Project configuration wizard for planning system. Manages executor generation, health checks, build systems, and skill domains.

install

source · Clone the upstream repo

git clone https://github.com/majiayu000/claude-skill-registry-data

Claude Code · Install into ~/.claude/skills/

T=$(mktemp -d) && git clone --depth=1 https://github.com/majiayu000/claude-skill-registry-data "$T" && mkdir -p ~/.claude/skills && cp -r "$T/data/marshall-steward" ~/.claude/skills/majiayu000-claude-skill-registry-data-marshall-steward && rm -rf "$T"

manifest: data/marshall-steward/SKILL.md

source content

Marshall Steward Skill

Project configuration wizard for the planning system.

Usage

/marshall-steward           # Interactive menu or first-run wizard
/marshall-steward --wizard  # Force first-run wizard

Banner

Output this banner directly as text at command start (do NOT use Bash echo - output it in your response):

╔═══════════════════════════════════════════════════════════════════════╗
║                                 :                                     ║
║                               .;:;.                                   ║
║                              :;:::;:                                  ║
║          ...             .;:::::::::;.              ...               ║
║          .::;:::::::::::::;:::::::::;:::::::::::::;::.                ║
║               :;:::::::::::::::::::::::::::::::;:                     ║
║                .;:::::::::::::::::::::::::::::;.                      ║
║                                                                       ║
║                        █▀█ █   █▀█ █▄ █                               ║
║                        █▀▀ █▄▄ █▀█ █ ▀█                               ║
║                  █▀▄▀█ █▀█ █▀█ █▀ █ █ █▀█ █   █                       ║
║                  █ ▀ █ █▀█ █▀▄ ▄█ █▀█ █▀█ █▄▄ █▄▄                     ║
║                                                                       ║
║                .;:::::::::::::::::::::::::::::;.                      ║
║               :;:::::::::::::::::::::::::::::::;:                     ║
║          .::;:::::::::::::;:::::::::;:::::::::::::;::.                ║
║         ...              .;:::::::::;.              ...               ║
║                              :;:::;:                                  ║
║                               .;:;.                                   ║
║                                 :                                     ║
╚═══════════════════════════════════════════════════════════════════════╝

Enforcement Rules

Script Execution

Run scripts EXACTLY as documented - no improvisation
Bootstrap scripts use direct Python paths with glob

All other scripts use:

python3 .plan/execute-script.py {notation} ...

Menu Behavior

After ANY operation completes → return to Main Menu
Only exit when user selects "Quit"

Prohibited Actions

Inventing alternative menu structures or options
Ending without returning to menu (unless Quit)
Summarizing what you're about to do instead of doing it

What This Skill Provides

Wizard Mode: Sequential setup for new projects (executor generation, marshal.json init, build detection, skill domains)

Menu Mode: Interactive maintenance for returning users (regenerate executor, health check, configuration)

Scripts

Script	Notation	Purpose
determine-mode	`plan-marshall:marshall-steward:determine-mode`	Determine wizard vs menu mode
gitignore-setup	`plan-marshall:marshall-steward:gitignore-setup`	Configure .gitignore for .plan/
cleanup	`plan-marshall:manage-run-config:cleanup`	Clean temp, logs, archived-plans, memory (delegated to run-config)
ci_health	`plan-marshall:tools-integration-ci:ci_health`	CI provider detection (delegated to tools-integration-ci)
plan-marshall-config	`plan-marshall:manage-plan-marshall-config:plan-marshall-config`	Project-level marshal.json CRUD
scan-marketplace-inventory	`pm-plugin-development:tools-marketplace-inventory:scan-marketplace-inventory`	Script discovery
permission-doctor	`plan-marshall:permission-doctor:permission-doctor`	Permission analysis
permission-fix	`plan-marshall:permission-fix:permission-fix`	Permission fixes
generate-executor	`plan-marshall:tools-script-executor:generate-executor`	Executor generation

Prerequisites

This skill requires

${PLUGIN_ROOT}

to be set by the invoking command (e.g.,

/marshall-steward

). The plugin root is detected via

bootstrap-plugin.py

and cached in

.plan/marshall-state.toon

Step 0: Determine Mode

Determine whether to run wizard or menu based on existing files.

BOOTSTRAP: Since execute-script.py may not exist yet, use DIRECT Python call with glob:

python3 ${PLUGIN_ROOT}/plan-marshall/*/skills/marshall-steward/scripts/determine-mode.py mode

Output (TOON):

mode	wizard
reason	executor_missing

Mode Routing

mode	reason	Action
`wizard`	`executor_missing`	Load: `Read references/wizard-flow.md` → Execute wizard
`wizard`	`marshal_missing`	Load: `Read references/wizard-flow.md` → Execute wizard
`menu`	`both_exist`	Show Main Menu below

Check for

--wizard

Flag

--wizard

flag provided, force wizard regardless of determine-mode result:

Read references/wizard-flow.md

Execute the wizard flow from that file.

Interactive Menu (Returning User)

Display menu when both executor and marshal.json exist.

Main Menu

AskUserQuestion:
  question: "What would you like to do?"
  header: "Main Menu"
  options:
    - label: "1. Maintenance"
      description: "Regenerate executor, clean logs"
    - label: "2. Health Check"
      description: "Verify setup, diagnose issues"
    - label: "3. Configuration"
      description: "Build systems, skill domains"
    - label: "4. Quit"
      description: "Exit plan-marshall"
  multiSelect: false

Menu Routing

User Selection	Action
"1. Maintenance"	Load: `Read references/menu-maintenance.md` → Execute
"2. Health Check"	Load: `Read references/menu-healthcheck.md` → Execute
"3. Configuration"	Load: `Read references/menu-configuration.md` → Execute
"4. Quit"	Output "Good bye!" → STOP

After any menu option completes, return to Main Menu (except Quit).

Deferred Loading Pattern

This skill uses progressive disclosure to minimize context usage:

Core skill loads: ~150 lines (this file - routing logic only)
On wizard mode: Load
```
references/wizard-flow.md
```
(~250 lines)
On menu selection: Load only the selected reference (~100-150 lines)

How to Load a Reference

When routing indicates to load a reference:

Read references/{file}.md

Then execute the workflow described in that file.

Available References

Reference	Purpose	Load When
`wizard-flow.md`	First-run wizard steps 1-11	mode=wizard or --wizard flag
`menu-maintenance.md`	Regenerate executor, cleanup	Menu option 1
`menu-healthcheck.md`	Verify setup, diagnose issues	Menu option 2
`menu-configuration.md`	Build systems, skill domains	Menu option 3
`output-format.md`	TOON output standards	Reference for output formatting
`error-handling.md`	Error types and recovery	On error conditions

Error Handling

If an error occurs during execution:

Read references/error-handling.md

Apply the recovery guidance for the specific error type.