check-skill-health

Name: check-skill-health
Availability: InStock
Author: Tsuga

Validate Tsuga runtime skill bundles for frontmatter, structure, and documentation patterns.

2|Updated May 28, 2026

Search Tags:#linting #knowledge management #structural validation #incident investigation #skill metadata #tsuga cli #documentation hygiene

Ready to run

npx skills add https://github.com/tsuga-dev/agent-plugins --skill check-skill-health

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: check-skill-health
Source: https://github.com/tsuga-dev/agent-plugins/tree/main/plugins/tsuga/skills/check-skill-health
Command: npx skills add https://github.com/tsuga-dev/agent-plugins --skill check-skill-health

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill detects mechanical violations in runtime skill bundles so skill authors can catch broken structure early and avoid frustrating failures later in skill discovery and execution.

Core Features & Use Cases

Frontmatter quality enforcement: Ensures required metadata fields exist and the description length is within expected bounds for reliable triggering.
Structural validation for Tsuga bundles: Verifies incident-history and knowledge-company trees follow expected folder/file conventions and contain load-bearing sections.
Command/doc hygiene checks: Flags forbidden pseudo-CLI syntax patterns and common Tsuga CLI flag/verb mistakes before they are shipped.
Optional live execution probing: Can run sampled Tsuga CLI commands extracted from service knowledge to confirm the commands actually work.

Quick Start

Run the linter across all discovered skills using scripts/lint-all.sh, then fix any FAIL findings before updating the skill tree.

Frequently Asked Questions about check-skill-health

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

FAQPage Schema

How do I lint runtime skill bundles for structural correctness?▼

Lint runtime skill bundles by running scripts/lint-all.sh to validate SKILL.md frontmatter, structural conventions, and forbidden documentation patterns across discovered skill trees, ensuring skills pass mechanical checks before execution.

What does skill metadata validation check for in frontmatter?▼

Skill metadata validation checks that required frontmatter fields exist and the description length stays within expected bounds, ensuring reliable skill triggering and preventing broken metadata from reaching runtime execution.

How do I validate incident-history and knowledge-company reference schemas?▼

Validate incident-history and knowledge-company schemas by verifying their folder and file conventions follow expected structural rules and contain load-bearing sections required for stable knowledge retrieval.

Can I test extracted Tsuga CLI commands before shipping a skill bundle?▼

Yes, optional live execution probing runs sampled Tsuga CLI commands extracted from service knowledge to confirm the commands actually work and validate authentication before the bundle is shipped.

Does this structural validation tool check cross-links and forbidden syntax patterns?▼

Yes, structural validation verifies that cross-links resolve correctly and flags forbidden pseudo-CLI syntax patterns alongside common Tsuga CLI flag and verb mistakes to maintain documentation hygiene.