Claude Skill

thedaviddias/skill-check

skill-check is a TypeScript linter for validating agent skill files. It checks skillmd files for errors and ensures correct format for AI agent workflows.

Overview

Stars177
Forks8
LanguageTypeScript
Last pushed2026-05-18
Last synced2026-06-23
View on GitHub

Repository

Ownerthedaviddias
Repositoryskill-check
Full namethedaviddias/skill-check
Repo ID1,162,948,379

Install this Skill

npx skill-check .

Registry

Typemcp_server
Quality score85/100
Verificationreadme_parsed
Last verified2026-06-23
Platforms
ClaudeMCP
Capabilities
browsercode-reviewpdfmemoryimageterminalworkflowai-agentscheckerlinter
Detected files
README.mddocspackage.jsontests
Config keys
URLNPM_TOKENGITHUB_TOKENPACKAGE_JSON
Install methods
  • npx skill-check .
  • npx skill-check check . --format json --no-security-scan > baseline.json
  • npx skill-check check . --baseline baseline.json --no-security-scan
  • npx skill-check init --interactive
  • npx skill-check /path/to/repo

Summary

A linter tool for validating and checking agent skill files, ensuring they follow the correct format and structure.

Chinese description

代理技能文件的Linter(Claude Skill)

Key features

  • Validates skill file structure and format
  • Checks for common errors in skill definitions
  • Supports skillmd file linting
  • Built with TypeScript for reliability
  • Integrates with AI agent workflows

Use cases

  • Ensuring skill files are correctly formatted before deployment
  • Automated quality checks in CI/CD pipelines for agent skills
  • Debugging and fixing skill definition errors
  • Maintaining consistency across multiple skill files

README excerpt

# skill-check [![npm version](https://img.shields.io/npm/v/skill-check)](https://www.npmjs.com/package/skill-check) [![CI](https://github.com/thedaviddias/skill-check/actions/workflows/ci.yml/badge.svg)](https://github.com/thedaviddias/skill-check/actions/workflows/ci.yml) [![License: MIT](https://img.shields.io/badge/license-MIT-yellow.svg)](LICENSE) `skill-check` validates agent skills with clear diagnostics, auto-fix support, quality scoring, and optional security scanning. ![skill-check demo](docs/assets/skill-check-demo.gif) ## Quick Start ```bash npx skill-check . ``` ## Features - Validates `SKILL.md` structure, frontmatter, description quality, body limits, and local references. - Scores skills from 0-100 so teams can track quality improvements over time. - Supports deterministic `--fix` for safe formatting and metadata corrections. - Runs an integrated security scan (`agent-scan`) in the same CLI pipeline. - Accepts local paths and GitHub URLs (`https://github.com/<owner>/<repo>`). - Exports text, JSON, SARIF, HTML, and GitHub annotation formats. ## Install Options Global install via curl: ```bash curl -fsSL https://raw.githubusercontent.com/thedaviddias/skill-check/main/scripts/install.sh | bash ``` Install via Homebrew: ```bash brew tap thedaviddias/skill-check https://github.com/thedaviddias/skill-check brew install skill-check ``` ## Commands | Command | Description | |---|---| | `skill-check [path\|github-url]` | Shorthand for `skill-check check [path\|github-url]` | | `skill-check check [path\|github-url]` | Run validation (and optional security scan) | | `skill-check split-body [path]` | Preview/apply section-based body split into `references/*.md` | | `skill-check new <name>` | Scaffold a new skill directory with SKILL.md template | | `ski

Topics

Explore more

Data from GitHub. Synced on 2026-06-23