Claude Skill 体检器（SKILL.md Doctor）
Agent Skill Quality Inspection and Refactoring Tool
Install & Use
Copy this prompt and send it to your AI assistant (Claude / Cursor / TRAE / Codex / WorkBuddy etc.) to auto-install:
Help me install this AI Skill: Claude Skill 体检器（SKILL.md Doctor）. It is used for: Agent Skill Quality Inspection and Refactoring Tool Full Skill content: https://321skill.com/skills/agent-quality-checker-2/raw/index.md Read that page and install it.
The prompt includes a link to the full Skill content. You can also view the full content.
Has your SKILL.md become a bloated "monolithic file"? Does it lack proper trigger descriptions, progressive disclosure, or security checks? This Skill performs a comprehensive inspection of Claude/Agent Skill SKILL.md files. It scores them across six dimensions—description trigger quality, length control, references/ splitting, script externalization, portability, and security (no hardcoded secrets)—and provides prioritized refactoring suggestions, even performing the refactoring automatically.
Usage is simple: Use wake words like "check my skill," "SKILL.md inspection," or "is this skill compliant?" The AI will prompt you to provide the SKILL.md content (or paste the text), then automatically output a scorecard and detailed improvement plan. For automatic fixes, you can further authorize the AI to perform code-level refactoring.
It's suitable for all developers using Claude/Agent, especially agent developers, full-stack engineers, and backend developers looking to improve Skill quality. Whether you're a beginner or experienced, you can quickly uncover hidden issues in your SKILL.md and get actionable optimization directions.
Note: This tool focuses solely on SKILL.md structure and compliance, not functional logic correctness. Ensure your SKILL.md content is complete before use. Refactoring is recommended under version control for easy rollback.
Key Features
Unlike generic code review tools, it is specifically designed for Claude/Agent's SKILL.md. Its inspection dimensions align with best practices for "on-demand instruction packages" and provide automatically executable refactoring solutions.
Limitations
Requires users to provide the complete SKILL.md content. It cannot process non-standard skill package formats and does not evaluate the correctness of functional logic.
FAQ
How do I trigger the inspection?
Simply use keywords like "check my skill," "SKILL.md inspection," or "is this skill compliant?"
What aspects does it primarily check?
Description trigger quality, SKILL.md length, progressive disclosure (references/ splitting), script externalization, portability (no hardcoded paths), and security (no hardcoded secrets), along with providing a scorecard.
Installation guide for AI assistants
If your AI coding assistant (Claude Code, Cursor, TRAE etc.) can see this page, send it this message to auto-install:
Visit https://321skill.com/skills/agent-quality-checker-2/raw/index.md to read the original Skill definition (Markdown format) for Claude Skill 体检器（SKILL.md Doctor）, and install it according to the instructions.
Raw Markdown URL for AI: /skills/agent-quality-checker-2/raw/index.md