BeClaude

skillcheck

New
GitHub TrendingGeneralby rogerchappel

Local-first lint checks for agent SKILL.md files

First seen 6/16/2026
Community PluginView Source

Summary

md files against heuristic rules to ensure they are well-formed and ready for packaging or sharing.

  • It helps developers catch missing operational coverage and formatting issues before distributing skills to other agents.

Overview

skillcheck

Use this skill when an agent needs to validate one or more SKILL.md files before packaging, sharing, or installing them.

Required Inputs

  • •Path to one or more skill markdown files.
  • •Optional minimum score threshold.

Required Tools

  • •Local filesystem read access.
  • •Node.js 18 or newer for the CLI.

Side Effects

skillcheck reads markdown files and prints reports. It does not install skills, modify files, call external services, or write to live accounts.

Approval Requirements

No approval is needed for local reads. Ask the user before combining this with any workflow that edits, installs, publishes, or sends skill content externally.

Examples

bash
skillcheck SKILL.md
skillcheck --json --min-score 90 skills/*/SKILL.md

Validation Workflow

Run npm test, npm run check, and npm run smoke after changing rules, fixtures, or output formatting.

Limitations

The rules are heuristic and deterministic. They cannot prove a skill is safe; they identify missing operational coverage for human or agent review.

Install & Usage

1
Create the skills directory
mkdir -p .claude/skills
2
Download the skill file

Add the configuration to .claude/skills/skillcheck.md

3
Invoke in Claude Code
/skillcheck

Use Cases

Validate a single SKILL.md file before committing it to a repository.
Run a batch check on multiple skill files in a directory to ensure consistency.
Integrate skillcheck into a CI pipeline to automatically validate skill files on pull requests.
Use the JSON output to programmatically review skill quality across a skill library.
Set a minimum score threshold to enforce quality standards for skill contributions.
Quickly verify a downloaded skill file from the community before installing it.

Usage Examples

1

/skillcheck SKILL.md

2

/skillcheck --json --min-score 90 skills/*/SKILL.md

3

Run skillcheck on all skill files in the current directory and show a summary report.

View source on GitHub
agent

Security Audits

LicenseUnknownSourceWarnRepositoryPass

Frequently Asked Questions

What is skillcheck?

skillcheck is a local-first lint tool that validates SKILL.md files against heuristic rules to ensure they are well-formed and ready for packaging or sharing. It helps developers catch missing operational coverage and formatting issues before distributing skills to other agents.

How to install skillcheck?

To install skillcheck: create the skills directory (mkdir -p .claude/skills), then add the config to .claude/skills/skillcheck.md. Finally, /skillcheck in Claude Code.

What is skillcheck best for?

skillcheck is a community categorized under General. It is designed for: agent. Created by rogerchappel.

What can I use skillcheck for?

skillcheck is useful for: Validate a single SKILL.md file before committing it to a repository.; Run a batch check on multiple skill files in a directory to ensure consistency.; Integrate skillcheck into a CI pipeline to automatically validate skill files on pull requests.; Use the JSON output to programmatically review skill quality across a skill library.; Set a minimum score threshold to enforce quality standards for skill contributions.; Quickly verify a downloaded skill file from the community before installing it..