groundwork-check

name	groundwork-check
description	Validate the Groundwork plugin for common issues. Usage /groundwork:groundwork-check
allowed-tools	["Bash","Read","Skill"]
disable-model-invocation	true

Groundwork Plugin Health Check

Validates the Groundwork plugin installation and reports any issues.

Workflow

Step 1: Run Validation Script

Run the plugin validation script:

node "${CLAUDE_PLUGIN_ROOT}/lib/validate-plugin.js"

Step 2: Report Results

Present the validation results to the user:

• If all checks pass: Confirm plugin is healthy
• If errors found: List each error with file path and description
• If warnings found: List warnings as recommendations

Step 3: Suggest Fixes

For any issues found, suggest specific fixes:

Issue Type	Suggested Fix
Missing frontmatter	Add --- delimited YAML at file start
Literal \n in description	Use YAML block scalar (|)
Non-standard field	Remove field or document exception
allowed_tools	Change to allowed-tools (hyphen)
@ syntax	Use explicit file paths
Missing execute permission	Run chmod 755 on script

Step 4: Offer to Fix

If issues are found, offer to automatically fix simple issues:

• Permissions can be fixed with chmod
• YAML key names can be updated

Ask user before making any changes.