From workflow-skills
Reviews Claude Code skills (.md files) for structure validity via validate.sh, content quality via skill-creator, cross-platform/agent compatibility, prerequisite declarations, and description triggering accuracy.
npx claudepluginhub niracler/skill --plugin workflow-skillsThis skill uses the workspace's default tool permissions.
审计 Claude Code skills 的质量和兼容性。作为编排器，委托已有工具处理结构/质量检查，自身专注兼容性审计。
Audits Claude Code skills for structure compliance, triggering accuracy, instruction quality, and best practices. Scores 0-100 with prioritized improvement recommendations.
Audits Claude Code skills by reading SKILL.md, references, scripts; evaluates 12 best-practice dimensions, scores 0-24, grades A-F, suggests top fixes, supports batch mode.
Validates SKILL.md files against agentskills spec and best practices. Catches structural, semantic, naming, and quality issues; provides scores, grades, and fix suggestions before publishing or debugging.
Share bugs, ideas, or general feedback.
审计 Claude Code skills 的质量和兼容性。作为编排器，委托已有工具处理结构/质量检查，自身专注兼容性审计。
| Tool | Type | Required | Install |
|---|---|---|---|
| skill-creator | skill | Yes | Built-in on most AI coding agents (Claude Code, Cursor, etc.) |
Do NOT proactively verify these tools on skill load. If a command fails due to a missing tool, directly guide the user through installation and configuration step by step.
运行 skill-reviewer 自带的校验脚本，汇总 YAML frontmatter、name 格式、description 格式等结果：
bash <skill-reviewer-dir>/scripts/validate.sh
若脚本不可用（如未通过 npx skills 安装），手动检查每个 SKILL.md 的 YAML frontmatter：name（hyphen-case，≤64 字符）、description（无尖括号，≤1024 字符）。
MUST 执行：调用 skill-creator skill 进行深度质量审查（token 效率、渐进式披露、反模式、description 基准测试等）。
若 skill-creator 不可用，MUST 停下并引导用户确认，不得跳过。大多数 AI 编码 agent 内置了 skill-creator：
document-skills:skill-creator 或 skill-creator:skill-creator此步骤不可跳过。没有 skill-creator 的审计是不完整的。
按 references/compatibility-checklist.md 逐项检查目标 skill 的所有文件（SKILL.md + scripts/ + references/）：
3a. 跨平台兼容性 — 扫描平台锁定模式（macOS-only 命令、Windows 不兼容项等）。
3b. 跨 Agent 兼容性 — 检测 Claude Code 专属工具引用和 MCP 依赖。
3c. npx skills 生态兼容性 — 校验 marketplace.json 注册、symlink 可用性、跨 skill 依赖。
3d. 工具引用规范 — 检查是否保留了 Claude Code 工具术语并提供了其他环境的 fallback 备注。详见 checklist 的 "Tool Reference Best Practices" 部分。
3e. Prerequisites 声明 — 检查 SKILL.md 是否声明了外部依赖：
git, gh, reminders-cli 等）、MCP 服务器、或其他 skill，MUST 有 ## Prerequisites 章节## 章节cli, mcp, skill, system详见 references/compatibility-checklist.md。
使用以下格式输出统一报告：
## Skill Review: {skill-name}
### 总览
| 维度 | 状态 | 方式 |
|------|------|------|
| 结构与元数据 | PASS / FAIL | validate.sh |
| 内容质量 | PASS / FAIL (N issues) | skill-creator |
| 平台兼容性 | PASS / FAIL (N issues) | 自查 |
| Agent 兼容性 | PASS / FAIL (N issues) | 自查 |
| npx skills 生态 | PASS / FAIL (N issues) | 自查 |
| Prerequisites 声明 | PASS / WARN / N/A | 自查 |
### Critical
- **[维度]** 问题描述
当前: ...
建议: ...
### High
...
### Medium / Low
...
严重度分级：