CommunityCoding & Developmentgithub.com

huiyonghkw/hekouwang-claude-skill-doctor-skill

Agent Skill (SKILL.md) health checker: evaluates description trigger quality, length, progressive disclosure, external scripts, portability, and security (no hardcoded keys), producing a scorecard and repair suggestions. Zero dependencies, a sibling tool to claude-md-doctor.

What is hekouwang-claude-skill-doctor-skill?

This skill, `huiyonghkw/hekouwang-claude-skill-doctor-skill`, is an Agent Skill (SKILL.md) health checker designed for developers and AI agent users to assess and improve the quality of their SKILL.md files. It systematically evaluates key dimensions including description trigger quality (how well the description aligns with actual triggers), appropriate length, progressive disclosure (information layered from summary to details), external script usage (recommending scripts outside the markdown for complexity), portability (ease of reuse across platforms like Claude Code, Cursor, or Codex), and security (ensuring no hardcoded API keys or secrets). The tool outputs a scorecard with clear scores per dimension and actionable repair suggestions. It has zero external dependencies and serves as a sibling tool to `claude-md-doctor`, focusing specifically on SKILL.md files rather than general Claude markdown. This helps enforce best practices for well-crafted, maintainable, and secure agent skills.

Works with✓Claude Code~Codex CLI~Cursor
npx skills add huiyonghkw/hekouwang-claude-skill-doctor-skill

Installed? Explore more Coding & Development skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

Ask in your favorite AI

Open a new chat with this agent skill pre-loaded.

Documentation

What does hekouwang-claude-skill-doctor-skill do?

Agent Skill (SKILL.md) health checker: evaluates description trigger quality, length, progressive disclosure, external scripts, portability, and security (no hardcoded keys), producing a scorecard and repair suggestions. Zero dependencies, a sibling tool to claude-md-doctor.

Related Skills