skill-lint

Score skill health across five dimensions and assign CURRENT, STALE, BROKEN, or DELETE verdicts.

28|3|Updated Mar 27, 2026
One-click install
npx skills add https://github.com/mifunedev/openharness --skill skill-lint-mifunedev
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: skill-lint
Source: https://github.com/mifunedev/openharness/tree/main/.claude/skills/skill-lint
Command: npx skills add https://github.com/mifunedev/openharness --skill skill-lint-mifunedev

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Score every skill across two scopes on 5 deterministic dimensions and produce a CURRENT / STALE / BROKEN / DELETE verdict for each. No LLM judgment — scores come from file stats, grep counts, and path existence checks only.

Core Features & Use Cases

  • Automates a deterministic health assessment of skills across freshness, usage, integrity, format, and dependencies.
  • Generates actionable verdicts (CURRENT, STALE, BROKEN, DELETE) with recommendations.
  • Scans root and workspace skill collections and resolves cross-skill references to detect drift and broken links.

Quick Start

Invoke the lint on all skills to generate a health report.

Frequently Asked Questions about skill-lint

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

FAQPage Schema
How do I check the health of skills and detect drift across repositories?

To check skill health and detect drift, evaluate freshness, usage, integrity, format, and dependencies to produce a CURRENT, STALE, BROKEN, or DELETE verdict for each skill across root and workspace repositories.

How does deterministic skill linting work without relying on LLM judgment?

Deterministic skill linting works by scoring file metadata, content references, and presence checks using file stats, grep counts, and path existence checks, avoiding LLM judgment to generate reliable health verdicts.

What is the best way to automate broken link detection in SKILL.md files?

Automate broken link detection in SKILL.md files by scanning root and workspace skill collections, resolving cross-skill references, and checking path existence to identify missing frontmatter and drift.

Can I use skill health checks to identify stale or unused skills in my workspace?

Yes, you can use skill health checks to identify stale or unused skills by evaluating usage and freshness dimensions with deterministic scoring thresholds, mapping the aggregated total to specific verdicts.

When do I need to run a skill health assessment?

You need to run a skill health assessment when managing multiple skill repositories to detect drift, broken references, missing frontmatter, and format degradation before deploying updates.

What are the limitations of deterministic scoring for skill verification?

Deterministic scoring for skill verification is limited to file metadata, grep counts, and path existence checks, meaning it cannot evaluate semantic correctness or behavioral accuracy of skill logic.