Agent skill

marshall-steward

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

View SKILL.md on GitHub Repository
Stars 163
Forks 31

Install this agent skill to your Project

npx add-skill https://github.com/majiayu000/claude-skill-registry/tree/main/skills/data/marshall-steward

SKILL.md

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

  1. Run scripts EXACTLY as documented - no improvisation
  2. Bootstrap scripts use direct Python paths with glob
  3. All other scripts use: python3 .plan/execute-script.py {notation} ...

Menu Behavior

  1. After ANY operation completes → return to Main Menu
  2. 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:

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

Output (TOON):

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

If --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:

  1. Core skill loads: ~150 lines (this file - routing logic only)
  2. On wizard mode: Load references/wizard-flow.md (~250 lines)
  3. 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.

Didn't find tool you were looking for?

Be as detailed as possible for better results