Validate AGH skill metadata and detect YAML type mismatches.
npx skills add https://github.com/compozy/agh --skill malformed-agh
Please help me install this Agent Skill. Skill: malformed-agh Source: https://github.com/compozy/agh/tree/main/internal/skills/testdata/loader/malformed-agh Command: npx skills add https://github.com/compozy/agh --skill malformed-agh
This Skill helps users and maintainers identify why an AGH skill cannot be loaded when its declared metadata is malformed, preventing silent failures and reducing time spent debugging loader issues.
Run an AI-assisted check that attempts to load the skill at internal/skills/testdata/loader/malformed-agh and reports the metadata type error it encounters.
High-intent search queries and answers about installing and using this skill.
Malformed SKILL.md metadata causes skill discovery failures because loader pipelines expect specific YAML schemas, and type mismatches like non-map values in object fields trigger parse errors that prevent proper indexing and activation.
You validate YAML metadata by running a check against the skill's testdata path to detect type mismatches in the frontmatter, producing a clear parse error that identifies the exact field causing the loader validation failure.
Silent skill discovery failures happen when SKILL.md frontmatter contains incorrect YAML structures like type mismatches in object fields, causing the loader pipeline to skip the skill during indexing without surfacing a clear parse error.
Troubleshoot a skill loader by running an AI-assisted check against the malformed skill's testdata path to reproduce the parsing error, which pinpoints the exact metadata type mismatch preventing the loader from indexing the entry.
Yes, YAML schema validation detects non-map values in object fields by parsing the SKILL.md frontmatter and producing a clear error when the encountered type does not match the expected map or object structure required by the loader.
luebkenValidate Markdown YAML frontmatter against JSON Schema definitions.
compozyLoad skills without AGH-specific metadata using YAML frontmatter.
LegalQuantsProvides a minimal SKill entry with tag metadata for loader tests.
beyonaiValidate and repair YAML frontmatter in markdown files with gbrain CLI.
