Back to Details

skill-check

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

SkillCheck

SkillCheck

Overview

概述

Validate SKILL.md files against the agentskills specification and Anthropic best practices. Catches structural errors, semantic contradictions, naming anti-patterns, and quality gaps in a single read-only pass.
根据agentskills规范和Anthropic最佳实践验证SKILL.md文件。通过单次只读扫描，发现结构错误、语义矛盾、命名反模式以及质量缺陷。

When to Use This Skill

何时使用该技能

  • Use when user says "check skill", "skillcheck", or "validate SKILL.md"
  • Use when reviewing a skill before publishing to a marketplace
  • Use when debugging why a skill doesn't trigger correctly
  • Use when onboarding a team to skill authoring standards
  • Do NOT use for anti-slop detection, security scanning, or token analysis; use SkillCheck Pro for those
  • 当用户提及「check skill」「skillcheck」或「validate SKILL.md」时使用
  • 在将技能发布到市场前进行审核时使用
  • 调试技能无法正确触发的原因时使用
  • 团队入门学习技能编写标准时使用
  • 请勿用于反冗余检测、安全扫描或令牌分析；此类场景请使用SkillCheck Pro

How It Works

工作原理

Step 1: Parse

步骤1：解析

Read the target SKILL.md file and extract YAML frontmatter.
读取目标SKILL.md文件并提取YAML前置元数据。

Step 2: Validate

步骤2：验证

Apply all Free tier checks in order:
CategoryChecksWhat it catches
Structure (1.x)Name format, description WHAT+WHEN, allowed-tools, categories, XML injectionMalformed frontmatter, missing fields
Body (2.x)Line count, hardcoded paths, stale dates, empty sections, deprecated syntax, MCP tool qualificationContent quality issues
Naming (3.x)Vague terms, single-word names, gerund suggestionsPoor discoverability
Semantic (4.x)Contradictions, ambiguous terms, missing output format, wisdom/platitudes, misplaced triggersLogical inconsistencies
Quality (8.x)Examples, error handling, triggers, output format, prerequisites, negative triggersStrengths (positive patterns)
按顺序执行所有免费版检查：
类别检查项检测内容
结构（1.x）名称格式、描述的WHAT+WHEN要素、允许的工具、分类、XML注入格式错误的前置元数据、缺失字段
正文（2.x）行数、硬编码路径、过期日期、空章节、已弃用语法、MCP工具资质内容质量问题
命名（3.x）模糊术语、单字名称、动名词建议可发现性差的问题
语义（4.x）矛盾内容、歧义术语、缺失输出格式、套话/陈词滥调、触发器位置错误逻辑不一致问题
质量（8.x）示例、错误处理、触发器、输出格式、前置条件、负向触发器优势（正向模式）

Step 3: Score

步骤3：评分

Calculate overall score (0-100). Penalties: critical = -20, warning = -5, suggestion = -1.
计算总分（0-100分）。扣分规则：严重问题扣20分，警告扣5分，建议扣1分。

Step 4: Report

步骤4：报告

Return structured results: score, grade (Excellent/Good/Needs Work/Poor), issue list with check IDs, line numbers, messages, and fix suggestions.
返回结构化结果：分数、等级（优秀/良好/需要改进/较差）、包含检查ID、行号、提示信息和修复建议的问题列表。

Examples

示例

Example 1: Validating a skill

示例1：验证某技能

User: check my skill at ~/.claude/skills/weekly-report/SKILL.md

SkillCheck output:
User: check my skill at ~/.claude/skills/weekly-report/SKILL.md

SkillCheck output:

weekly-report Check Results [FREE]

weekly-report Check Results [FREE]

Score: 85/100 (Good)
Score: 85/100 (Good)

Warnings (2)

Warnings (2)

  • 1.2-desc-when (line 3): Description missing WHEN clause
    • 4.5-desc-no-triggers (line 3): Description lacks triggering conditions
  • 1.2-desc-when (line 3): Description missing WHEN clause
    • 4.5-desc-no-triggers (line 3): Description lacks triggering conditions

Suggestions (1)

Suggestions (1)

  • 3.4-gerund-naming (line 2): Skill name could use gerund form
  • 3.4-gerund-naming (line 2): Skill name could use gerund form

Passed Checks: 28

Passed Checks: 28

undefined
undefined

Example 2: Clean skill passes all checks

示例2：合规技能通过所有检查

User: skillcheck ~/.claude/skills/processing-pdfs/SKILL.md

Score: 100/100 (Excellent)
All 31 checks passed. No issues found.
User: skillcheck ~/.claude/skills/processing-pdfs/SKILL.md

Score: 100/100 (Excellent)
All 31 checks passed. No issues found.

Limitations

局限性

  • Read-only: does not modify any files
  • Free tier covers structural, semantic, and naming checks only
  • Anti-slop, security, WCAG, token, enterprise, and workflow checks require SkillCheck Pro
  • Semantic checks (contradiction detection, wisdom/platitude) are heuristic with ~5% false positive rate
  • Does not validate referenced files or scripts; only checks SKILL.md content
  • Single-file validation; does not cross-check against other skills in the same directory
  • 只读模式：不会修改任何文件
  • 免费版仅涵盖结构、语义和命名检查
  • 反冗余、安全、WCAG、令牌、企业级和工作流检查需要使用SkillCheck Pro
  • 语义检查（矛盾检测、套话/陈词滥调）采用启发式算法，约有5%的误报率
  • 不验证引用的文件或脚本；仅检查SKILL.md内容
  • 单文件验证：不会交叉检查同一目录下的其他技能

Best Practices

最佳实践

  • Run SkillCheck before submitting skills to any marketplace
  • Fix all critical and warning issues; suggestions are optional
  • Use the check ID (e.g., 
    1.2-desc-when
    ) to find the exact rule in the skill body
  • Re-run after fixes to confirm the score improved
  • 在将技能提交到任何市场前运行SkillCheck
  • 修复所有严重问题和警告；建议项为可选修复
  • 使用检查ID（如
    1.2-desc-when
    ）在技能正文中查找对应的具体规则
  • 修复后重新运行以确认分数提升

Common Pitfalls

常见陷阱

  • Problem: Score seems low due to many suggestions Solution: Suggestions cap at -15 points total. Focus on warnings and criticals first.
  • Problem: False positive on ambiguous terms inside code blocks Solution: SkillCheck skips code blocks and inline code. If you still see false positives, wrap the term in backticks.
  • Problem: Wisdom/platitude check flags legitimate instructions Solution: Rephrase generic advice ("Remember that testing is important") as concrete directives ("Run tests before committing").
  • 问题： 因大量建议项导致分数偏低 解决方案： 建议项最多扣15分。优先处理警告和严重问题。
  • 问题： 代码块内的歧义术语被误报 解决方案： SkillCheck会跳过代码块和行内代码。如果仍出现误报，可将术语用反引号包裹。
  • 问题： 套话/陈词滥调检查标记了合理的说明 解决方案： 将通用建议（如「请记住测试很重要」）改写为具体指令（如「提交前运行测试」）。