Groundwork Check

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.

Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: etr
• Source: etr/groundwork
• License: MIT

Install and usage instructions live in the source repository linked above.