ref-checker-test

Detect broken or missing references in Claude Skill definitions.

1|Updated Mar 24, 2026
One-click install
npx skills add https://github.com/jeremylongshore/j-rig-skill-binary-eval --skill ref-checker-test
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ref-checker-test
Source: https://github.com/jeremylongshore/j-rig-skill-binary-eval/tree/main/packages/core/fixtures/packages/broken-refs
Command: npx skills add https://github.com/jeremylongshore/j-rig-skill-binary-eval --skill ref-checker-test

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Detects and flags broken and missing references within Claude Skill bodies to prevent runtime errors and misconfigurations.

Core Features & Use Cases

  • Validates references to configuration files like config.yaml and templates within the Skill body.
  • Detects broken or nonexistent references and reports them for remediation.
  • Produces a reference health report suitable for regression gates and quality checks.

Quick Start

Run the ref-checker against a skill directory to validate all references and generate a report.

Frequently Asked Questions about ref-checker-test

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

FAQPage Schema
How do I validate broken file references in a markdown skill definition?

You can check markdown skill configuration by scanning the SKILL.md body text for ${VAR} references and confirming linked templates exist, yielding a reference health report for regression gates.

What is the best way to detect missing configuration files in Claude skills?

The best way to detect missing configuration files in Claude skills is scanning the markdown body for internal references and verifying linked files exist, generating a structured report for remediation.

Can I use reference validation for automated quality checks in my repository?

Yes, reference validation supports automated quality checks by producing a structured reference health report suitable for regression gates and quality checks across your skill repository.

Why does my SKILL.md frontmatter validation fail when config files are missing?

SKILL.md frontmatter validation fails when config files are missing because the scanner parses frontmatter and verifies linked assets exist, flagging any nonexistent references in the body content for remediation.

Does the broken link checker work with template files referenced in skill bodies?

Yes, the broken link checker works with template files by scanning the skill body text for internal references and verifying that linked templates and assets actually exist within the directory.