skills.rest
tsuga-dev
tsuga-devOFFICIAL
Explore all skills by this author →
WebsiteGitHub

check-skill-health

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
One-click install
npx skills add https://github.com/tsuga-dev/agent-plugins --skill check-skill-health
Or copy as Structured Prompt for Agent▼
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.

Related Skills

Explore More Software Engineering Skills→
SkillsCatalogSkillsCatalog
1

skill-validator

Validate agent skill directories against the SKILL.md specification.

Official
Advanced
sunholo-datasunholo-data
3

AILANG Debug

Diagnose and fix AILANG type, parse, and runtime errors.

Official
Intermediate
tsuga-devtsuga-dev
2

build-incident-history

Transform raw incident dumps into validated SUMMARY.md dossiers and inventory files.

Official
Advanced
auldsyababuaauldsyababua
6

markdown-validation

Validate Markdown files for syntax, links, and formatting standards.

Community
Advanced