Review an MCP plugin against the homelab canonical plugin spec and identify any and all misalignments. Use when the user wants a plugin audited for spec drift, wants to compare a plugin to canonical manifests and runtime patterns, wants to know whether deviations are documented and justified, or wants a detailed plugin review report.
From plugin-labnpx claudepluginhub jmagar/claude-homelab --plugin plugin-labThis skill uses the workspace's default tool permissions.
references/canonical-spec.mdreferences/review-report-template.mdProvides UI/UX resources: 50+ styles, color palettes, font pairings, guidelines, charts for web/mobile across React, Next.js, Vue, Svelte, Tailwind, React Native, Flutter. Aids planning, building, reviewing interfaces.
Fetches up-to-date documentation from Context7 for libraries and frameworks like React, Next.js, Prisma. Use for setup questions, API references, and code examples.
Calculates TAM/SAM/SOM using top-down, bottom-up, and value theory methodologies for market sizing, revenue estimation, and startup validation.
Review a plugin for alignment with the homelab canonical plugin spec.
Find mismatches between the target plugin and the current canonical standard.
Treat the review as a spec audit, not a style pass.
Focus on:
See references/canonical-spec.md for the authoritative correct values for every check category below.
Inspect the target plugin's tree first to know what exists and what is absent. Then read each canonical file when present:
README.mdpyproject.toml, Cargo.toml, or package.json).claude-plugin/plugin.json.codex-plugin/plugin.json.mcp.json.app.jsonCLAUDE.mdAGENTS.mdCHANGELOG.mdDockerfiledocker-compose.yamlJustfile.env.example.github/workflows/ci.yaml)Also inspect the repo tree so you can reason about missing or misplaced surfaces.
Check for every category below. For the exact correct values in each category, consult references/canonical-spec.md.
/health endpoint*_help tool or action/subaction patternFor each finding, state:
Do not treat every difference as a bug. A deviation is acceptable if it is deliberate, documented, and technically justified.
Some findings cannot be resolved by reading files alone. Flag these explicitly as open questions — issues that require user input or live service access to resolve before remediation can proceed.
Examples of open questions:
Group open questions at the end of the report so the user can answer them before align-lab-plugin begins work.
Write the final review to:
docs/reports/plugin-reviews/<YYYYMMDD-HHMMSS>.md
Use the fill-in-the-blanks template in references/review-report-template.md for the report structure.
The report must include:
Findings first. Each finding uses this format:
**[HIGH] Missing /health endpoint**
File: src/server.py
Expected: GET /health returns HTTP 200 with {"status": "ok"}
Found: No /health route registered
Fix: Add health route before starting server
Severity levels:
Keep the report detailed and complete enough that align-lab-plugin can implement all fixes without repeating the audit.