intent-layer-health

Validate Intent Layer nodes and generate structured health reports.

8|1|Updated Jan 21, 2026
One-click install
npx skills add https://github.com/orban/intent-layer --skill intent-layer-health
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: intent-layer-health
Source: https://github.com/orban/intent-layer/tree/main/skills/intent-layer-health
Command: npx skills add https://github.com/orban/intent-layer --skill intent-layer-health

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Intent Layer deployments can drift over time as nodes and coverage degrade. This Skill provides a quick health snapshot to surface stale content, missing coverage, and misconfigurations before work begins.

Core Features & Use Cases

  • Quick root health validation: verifies root node and immediate children for presence and basic correctness.
  • Staleness detection: identifies nodes and AGENTS.md items that age out beyond a threshold.
  • Coverage reporting: highlights directories or sections without corresponding AGENTS.md coverage.
  • Pre-work posture: integrates with session starts to ensure healthy state before tasks.

Quick Start

Run the quick health check at the start of a session to confirm system health:

  • Quick check: ${CLAUDE_PLUGIN_ROOT}/scripts/audit_intent_layer.sh --quick
  • Full check: ${CLAUDE_PLUGIN_ROOT}/scripts/audit_intent_layer.sh

Frequently Asked Questions about intent-layer-health

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I check my Intent Layer for staleness and coverage gaps?

To check your Intent Layer for staleness and coverage gaps, run the audit_intent_layer.sh script to validate root and child nodes, calculate ages, and produce a structured health report for quick remediation.

What is Intent Layer health validation and when do I need it?

Intent Layer health validation verifies root nodes and children for presence and correctness, detecting stale content and missing AGENTS.md coverage before work begins during session starts and maintenance windows.

How do I run a quick health check before starting a session?

Run a quick health check before starting a session by executing audit_intent_layer.sh with the --quick flag to verify system posture and confirm a healthy state before tasks.

Can I detect missing AGENTS.md coverage in my Intent Layer deployment?

Yes, you can detect missing AGENTS.md coverage by running the full audit script, which highlights directories or sections lacking corresponding AGENTS.md coverage and surfaces misconfigurations.

What is the best way to audit an Intent Layer deployment for misconfigurations?

The best way to audit an Intent Layer deployment for misconfigurations is running defined audit scripts that validate nodes, calculate ages, and generate a structured health report for quick remediation.

Why does Intent Layer content drift over time and how do I fix it?

Intent Layer content drifts over time as nodes and coverage degrade; fix it by executing audit scripts that identify stale nodes and coverage gaps, then use the structured health report to guide remediation.