[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill-b2b7c001-5684-409e-88f6-334c6f847f7c":3,"$fvWtl2pTQd9Ef9rXH98fK2DcMxhr1nxcN8sWR2yGquRc":42},{"id":4,"title":5,"description":6,"categoryId":7,"moduleId":8,"tags":9,"prompt":10,"icon":11,"source":12,"sourceUrl":13,"authorId":14,"authorName":15,"isPublic":16,"stars":17,"runs":18,"createdAt":19,"updatedAt":19,"module":20,"category":27,"packages":33},"b2b7c001-5684-409e-88f6-334c6f847f7c","skill-check","验证Claude代码技能与agentskills规范的一致性。在用户之前捕捉到结构、语义和命名问题。","cat_coding_backend","mod_coding","sickn33,coding","---\nname: skill-check\ndescription: \"Validate Claude Code skills against the agentskills specification. Catches structural, semantic, and naming issues before users do.\"\ncategory: development\nrisk: safe\nsource: https:\u002F\u002Fgithub.com\u002Folgasafonova\u002FSkillCheck-Free\ndate_added: \"2026-03-11\"\nauthor: olgasafonova\ntags: [validation, linter, agentskills, skill-authoring, code-quality]\ntools: [claude, cursor, windsurf, codex-cli]\nlicense: MIT\nallowed-tools: Read Glob\ncompatibility: claude-code\n---\n\n# SkillCheck\n\n## Overview\n\nValidate SKILL.md files against the [agentskills specification](https:\u002F\u002Fagentskills.io) and Anthropic best practices. Catches structural errors, semantic contradictions, naming anti-patterns, and quality gaps in a single read-only pass.\n\n## When to Use This Skill\n\n- Use when user says \"check skill\", \"skillcheck\", or \"validate SKILL.md\"\n- Use when reviewing a skill before publishing to a marketplace\n- Use when debugging why a skill doesn't trigger correctly\n- Use when onboarding a team to skill authoring standards\n- Do NOT use for anti-slop detection, security scanning, or token analysis; use [SkillCheck Pro](https:\u002F\u002Fgetskillcheck.com) for those\n\n## How It Works\n\n### Step 1: Parse\n\nRead the target SKILL.md file and extract YAML frontmatter.\n\n### Step 2: Validate\n\nApply all Free tier checks in order:\n\n| Category | Checks | What it catches |\n|----------|--------|----------------|\n| Structure (1.x) | Name format, description WHAT+WHEN, allowed-tools, categories, XML injection | Malformed frontmatter, missing fields |\n| Body (2.x) | Line count, hardcoded paths, stale dates, empty sections, deprecated syntax, MCP tool qualification | Content quality issues |\n| Naming (3.x) | Vague terms, single-word names, gerund suggestions | Poor discoverability |\n| Semantic (4.x) | Contradictions, ambiguous terms, missing output format, wisdom\u002Fplatitudes, misplaced triggers | Logical inconsistencies |\n| Quality (8.x) | Examples, error handling, triggers, output format, prerequisites, negative triggers | Strengths (positive patterns) |\n\n### Step 3: Score\n\nCalculate overall score (0-100). Penalties: critical = -20, warning = -5, suggestion = -1.\n\n### Step 4: Report\n\nReturn structured results: score, grade (Excellent\u002FGood\u002FNeeds Work\u002FPoor), issue list with check IDs, line numbers, messages, and fix suggestions.\n\n## Examples\n\n### Example 1: Validating a skill\n\n```\nUser: check my skill at ~\u002F.claude\u002Fskills\u002Fweekly-report\u002FSKILL.md\n\nSkillCheck output:\n## weekly-report Check Results [FREE]\n\nScore: 85\u002F100 (Good)\n\n### Warnings (2)\n  - 1.2-desc-when (line 3): Description missing WHEN clause\n  - 4.5-desc-no-triggers (line 3): Description lacks triggering conditions\n\n### Suggestions (1)\n  - 3.4-gerund-naming (line 2): Skill name could use gerund form\n\n### Passed Checks: 28\n```\n\n### Example 2: Clean skill passes all checks\n\n```\nUser: skillcheck ~\u002F.claude\u002Fskills\u002Fprocessing-pdfs\u002FSKILL.md\n\nScore: 100\u002F100 (Excellent)\nAll 31 checks passed. No issues found.\n```\n\n## Limitations\n\n- Read-only: does not modify any files\n- Free tier covers structural, semantic, and naming checks only\n- Anti-slop, security, WCAG, token, enterprise, and workflow checks require [SkillCheck Pro](https:\u002F\u002Fgetskillcheck.com)\n- Semantic checks (contradiction detection, wisdom\u002Fplatitude) are heuristic with ~5% false positive rate\n- Does not validate referenced files or scripts; only checks SKILL.md content\n- Single-file validation; does not cross-check against other skills in the same directory\n\n## Best Practices\n\n- Run SkillCheck before submitting skills to any marketplace\n- Fix all critical and warning issues; suggestions are optional\n- Use the check ID (e.g., `1.2-desc-when`) to find the exact rule in the skill body\n- Re-run after fixes to confirm the score improved\n\n## Common Pitfalls\n\n- **Problem:** Score seems low due to many suggestions\n  **Solution:** Suggestions cap at -15 points total. Focus on warnings and criticals first.\n\n- **Problem:** False positive on ambiguous terms inside code blocks\n  **Solution:** SkillCheck skips code blocks and inline code. If you still see false positives, wrap the term in backticks.\n\n- **Problem:** Wisdom\u002Fplatitude check flags legitimate instructions\n  **Solution:** Rephrase generic advice (\"Remember that testing is important\") as concrete directives (\"Run tests before committing\").\n","","imported","https:\u002F\u002Fgithub.com\u002Fsickn33\u002Fantigravity-awesome-skills","user_system_seed","SkillOPIC",true,177,1271,"2026-05-16 13:40:35",{"id":8,"name":21,"slug":22,"icon":23,"description":24,"sort":25,"createdAt":26},"编程开发","coding","mdi-code-braces","代码生成、调试、审查，提升开发效率",2,"2026-05-16 12:53:40",{"id":7,"name":28,"slug":29,"icon":30,"description":31,"moduleId":8,"sort":25,"skillCount":32,"createdAt":26},"后端开发","backend","mdi-server","API、数据库、服务端架构",296,[34],{"id":35,"skillId":4,"version":36,"fileName":37,"fileSize":38,"filePath":39,"fileHash":40,"manifest":41,"createdAt":19},"db75820a-15d5-4570-bc2e-8dfdf048fadb","1.0.0","skill-check.zip",2161,"uploads\u002Fskills\u002Fb2b7c001-5684-409e-88f6-334c6f847f7c\u002Fskill-check.zip","a6df87dbafbf09d0ee7e9c85be9aa9c91bb2511a539c282f3e7d55d6b63f5d6e","[{\"path\":\"SKILL.md\",\"isDirectory\":false,\"size\":4338}]",{"code":43,"message":44,"data":45},200,"success",{"items":46,"stats":47,"page":50},[],{"averageRating":48,"totalRatings":48,"ratingCounts":49},0,[48,48,48,48,48],{"limit":51,"offset":48,"hasMore":52,"nextOffset":51,"ratedOnly":16},15,false]