From legal-skills
Audits Claude Code skills for compliance with SKILL-DEV-GUIDE.md: verifies directory structure, frontmatter format, line limits, flat subdirs, doc consistency, redundancy, configs, security basics, outputs, workflows, generating structured reports.
npx claudepluginhub cat-xierluo/legal-skills --plugin minimax-image-understandThis skill uses the workspace's default tool permissions.
对指定的 skill 进行格式合规性审查，生成结构化的审计报告。
Guides creation, editing, packaging, and compliance review of Claude Code skills using official skill-creator workflows and built-in checks. Use for new SKILL.md files or auditing existing ones.
Lints Claude skills for errors like broken symlinks and missing SKILL.md/frontmatter, warnings on description quality and fields, plus info on best practices. Includes bash script.
Reviews SKILL.md files against best practices with structured pass/fail reports, warnings, errors, and prioritized recommendations before publishing or deploying.
Share bugs, ideas, or general feedback.
对指定的 skill 进行格式合规性审查，生成结构化的审计报告。
使用 Glob 工具列出技能目录下的所有文件：
<skill-path>/
├── **/*.md
├── **/*.py
├── **/*.yaml
├── **/*.json
└── ...
验证是否符合标准目录结构：
skill-name/
├── SKILL.md # 必需
├── LICENSE.txt # 可选
├── CHANGELOG.md # 可选（推荐）
├── TASKS.md # 可选（开发上下文，保留）
├── DECISIONS.md # 可选（开发上下文，保留）
├── references/ # 可选
├── scripts/ # 可选
├── templates/ # 可选
└── assets/ # 可选
检查项：
test/、docs/ 应改为 references/）__pycache__/、.env、.DS_Store）豁免文件（以下文件为开发过程上下文，不应标记为不合规，不应建议删除）：
TASKS.md — 任务追踪DECISIONS.md — 决策记录CHANGELOG.md — 变更日志解析 SKILL.md 的 YAML frontmatter：
---
name: skill-name
description: 功能描述。本技能应在...时使用
license: MIT License - 详见 LICENSE.txt
---
检查项：
name 字段是否存在且格式正确description 字段是否存在description 是否使用第三人称（"本技能应在...时使用"）description 是否包含触发场景描述description 是否包含负向触发条件（"不要用于..."）description 长度是否 ≤ 1024 字符license 字段version 字段（应删除）检查项：
检查项：
references/ 是否完全扁平（文件直接放在目录下，无子目录）scripts/ 是否完全扁平（文件直接放在目录下，无子目录）assets/ 是否完全扁平（文件直接放在目录下，无子目录）templates/ 是否完全扁平（文件直接放在目录下，无子目录）注意：所有二级目录（references/、scripts/、assets/、templates/）下禁止创建子目录，文件必须直接放在目录根。
扫描所有 .md 文件，提取引用的文件路径：
提取模式：
scripts/xxx.pyassets/xxx.yamlreferences/xxx.md检查项：
检查项：
检查项：
*.example.* 命名检查项：
检查项：
检查项：
rm -rf ~、rm -rf /、rm -rf $HOME）检查项：
ALWAYS，灵活需求用 use your best judgment）检查项：
检查项：
CHANGELOG.md 文件（推荐有）CHANGELOG 格式规范：
# Changelog
All notable changes to this skill will be documented in this file.
## [v1.1.0] - 2026-02-24
### 新增
- 添加了 XXX 功能
### 修改
- 优化了 YYY 逻辑
### 修复
- 修复了 ZZZ 问题
## [v1.0.0] - 2026-02-01
### 新增
- 初始版本发布
检查项：
version 字段（应删除）CHANGELOG.md 中管理注意：版本号不应出现在 SKILL.md 的 frontmatter 中，所有版本变更应在 CHANGELOG.md 中记录。
对于可能参与复杂工作流编排的技能，检查以下项：
检查项：
references/workflow.md输入/输出声明格式：
## 输入/输出
### 输入
- 必需：`--input` 参数说明
- 可选：`--flag` 参数说明
### 输出
- 输出文件：`output/path.md` 说明
- 副作用：如创建目录、修改文件等
单一职责检查：
幂等性检查：
对于包含脚本的技能（scripts/ 目录非空），检查以下项：
检查项：
requirements.txt 是否存在且只包含硬依赖（可选依赖不应列出）判断标准：
# [skill-name] 格式审查报告
**审查时间**: YYYY-MM-DD HH:MM
**技能路径**: /path/to/skill
## 审查摘要
| 检查项 | 状态 | 问题数 |
|--------|------|--------|
| 目录结构 | ✅/⚠️/❌ | N |
| Frontmatter | ✅/⚠️/❌ | N |
| SKILL.md 行数 | ✅/⚠️ | N |
| 目录层级 | ✅/⚠️ | N |
| 文档一致性 | ✅/⚠️/❌ | N |
| 冗余内容 | ✅/⚠️/❌ | N |
| 配置文件 | ✅/⚠️/❌ | N |
| 技能协作 | ✅/⚠️/❌ | N |
| 模块化设计 | ✅/⚠️/❌ | N |
| 安全审计 | ✅/⚠️/❌ | N |
| 输出模式 | ✅/⚠️/❌ | N |
| 工作流模式 | ✅/⚠️/❌ | N |
| CHANGELOG | ✅/⚠️/❌ | N |
| 版本号管理 | ✅/⚠️/❌ | N |
| 可编排性 | ✅/⚠️/❌ | N |
| 依赖声明与防护 | ✅/⚠️/❌ | N |
## 详细问题
### 严重问题（必须修复）
1. **[问题标题]**
- 位置: `文件路径:行号`
- 规范: 违反的规范条款
- 建议: 具体修复建议
### 建议优化
1. **[问题标题]**
- 位置: `文件路径`
- 建议: 优化建议
### 信息提示
- [提示信息]
## 建议操作
### 删除文件
| 文件路径 | 原因 |
|----------|------|
| `path/to/file.md` | 与 SKILL.md 重复 |
| `path/to/old.md` | 引用不存在的脚本 |
### 更新文件
| 文件路径 | 修改内容 |
|----------|----------|
| `SKILL.md` | 更新 description 格式 |
| `config.example.yaml` | 移除未使用的字段 |
### 新增文件
| 文件路径 | 用途 |
|----------|------|
| `assets/config.example.yaml` | 配置模板 |
## 审查完成
- 总问题数: N
- 严重问题: N
- 建议优化: N
- 信息提示: N
用户提供要审查的技能路径，AI 执行以下步骤：
详细检查清单见 references/skill-standards.md
规范依据：项目根目录的 SKILL-DEV-GUIDE.md