Help us improve
Share bugs, ideas, or general feedback.
From intent-layer
Quick health check for Intent Layer - validates nodes, checks staleness, reports coverage gaps
npx claudepluginhub orban/intent-layer --plugin intent-layerHow this skill is triggered — by the user, by Claude, or both
Slash command
/intent-layer:intent-layer-healthThe summary Claude sees in its skill listing — used to decide when to auto-load this skill
Quick validation of Intent Layer health before starting work. Run this at session start to catch issues early.
Runs validation and sync checks on Intent files: verifies formats against IDD spec, code consistency, and generates reports with fixes. Supports CI/CD, git diffs, and targeted paths.
Audits agent lifecycles in Claude Code plugins, validating execution capabilities against configs via 8 semantic audits on alignments, skill loading, contracts, prompts, tools, dead agents, and patterns. Writes reports to .claude/audits/.
Audits .claude/ config for cross-references, permissions, inventory drift, model tiers, docs freshness. Auto-fixes issues at high/medium/all severity levels or upgrades with verification and A/B testing.
Share bugs, ideas, or general feedback.
Quick validation of Intent Layer health before starting work. Run this at session start to catch issues early.
# Quick check (default, <30 seconds)
${CLAUDE_PLUGIN_ROOT}/scripts/audit_intent_layer.sh --quick
# Full check (includes consistency analysis)
${CLAUDE_PLUGIN_ROOT}/scripts/audit_intent_layer.sh
Run by default, completes in <30 seconds:
${CLAUDE_PLUGIN_ROOT}/scripts/audit_intent_layer.sh --quick [path]
What it checks:
What it skips:
Run when user requests --full or deeper analysis:
${CLAUDE_PLUGIN_ROOT}/scripts/audit_intent_layer.sh [path]
Additional checks:
| Status | Exit Code | Meaning |
|---|---|---|
HEALTHY | 0 | No issues - good to proceed |
NEEDS_ATTENTION | 1 | Warnings only - can proceed with awareness |
CRITICAL | 2 | Failures or >50% stale nodes - address before work |
| Result | Count | Action |
|---|---|---|
| PASS | Nodes with no issues | None |
| WARN | Nodes with warnings | Review, non-blocking |
| FAIL | Nodes with errors | Fix before proceeding |
| Age | Category | Action |
|---|---|---|
| <30 days | Fresh | None |
| 30-90 days | Aging | Monitor |
| >90 days | Stale | Schedule maintenance |
/intent-layer-maintenancePresent results to user in this format:
## Intent Layer Health Check
**Status**: NEEDS_ATTENTION
### Summary
- Validation: 10 PASS, 2 WARN, 0 FAIL
- Staleness: 1 node stale (src/legacy/AGENTS.md - 142 days)
- Coverage: 85% (3 directories uncovered)
### Recommended Actions
1. Run `/intent-layer-maintenance` to address stale nodes
2. Consider adding AGENTS.md to: src/utils/, src/migrations/
Ready to proceed with current work? The warnings are informational.
Intent Layer is healthy. Good to proceed with current work.
### Recommended Actions
1. [If stale nodes] Run `/intent-layer-maintenance` to update stale nodes
2. [If low coverage] Consider adding AGENTS.md to: [list uncovered directories]
3. [If validation warnings] Review warnings: [list]
These are informational - you can proceed with current work.
### Immediate Actions Required
1. [If validation failures] Fix these nodes before proceeding:
- [node path]: [issue description]
2. [If >50% stale] Most nodes are outdated - run `/intent-layer-maintenance`
Recommend addressing these issues before starting new work.
This skill can be run proactively at session start:
For automated checks, use JSON output:
${CLAUDE_PLUGIN_ROOT}/scripts/audit_intent_layer.sh --json --quick
Exit codes enable CI pass/fail:
| Skill | Use When |
|---|---|
/intent-layer-maintenance | Status is NEEDS_ATTENTION or CRITICAL |
/intent-layer | No Intent Layer exists (state = none/partial) |
/intent-layer-query | Need to query Intent Layer for information |
| Script | Purpose |
|---|---|
audit_intent_layer.sh | Main audit script (validation, staleness, coverage, consistency) |
validate_node.sh | Single node validation (called by audit) |
detect_staleness.sh | Detailed staleness analysis |
detect_state.sh | Check if Intent Layer exists |
All paths: ${CLAUDE_PLUGIN_ROOT}/scripts/