check-all-skills

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Skill 合规性检查工具

Skill Compliance Check Tool

任务目标

Task Objectives

本 Skill 用于:检查一个或多个 Skill 是否符合最佳实践规范
能力包含:读取 Skill 文件、验证命名、前言区、目录结构、文件清理、依赖元数据等维度、生成检查报告
触发条件:用户需要验证 Skill 质量时，如 "检查所有 skill 是否符合规范"、"验证 skill 目录结构"、"检查这个 skill 是否符合要求"

This Skill is used to: check whether one or more Skills comply with best practice specifications
Capabilities include: reading Skill files, verifying naming, preface section, directory structure, file cleanup, dependency metadata and other dimensions, generating inspection reports
Trigger conditions: when users need to verify Skill quality, such as "Check if all skills comply with specifications", "Verify skill directory structure", "Check if this skill meets requirements"

前置准备

Preparations

无特殊依赖

No special dependencies

操作步骤

Operation Steps

标准流程

Standard Process

步骤 1：读取检查规范

Step 1: Read Inspection Specifications

阅读 references/checklist.md，了解完整的 19 项检查清单
阅读 references/quality-standards.md，了解各项检查的背景说明

Read references/checklist.md to understand the complete 19-item inspection checklist
Read references/quality-standards.md to understand the background explanations of each inspection item

步骤 2：检查单个 Skill

Step 2: Check a Single Skill

阅读目标 Skill 的
```
SKILL.md
```
文件
检查目录结构和文件列表
按照 checklist.md 中的 19 项检查清单逐项验证：
1. 命名规范检查（3 项）：目录名格式、目录名后缀、最佳实践后缀
2. 前言区检查（5 项）：name 字段存在、name 与目录名一致、description 存在、description 单行、description 长度
3. 目录结构检查（3 项）：SKILL.md 存在、固定结构目录、空目录检查
4. 文件清理检查（1 项）：临时文件清理
5. 依赖元数据检查（2 项）：dependency.python 格式、dependency.system 格式
6. README.md 记录检查（5 项）：README.md 存在、skills/ 目录存在、Skill 在 skills/ 中、Skill 已记录、记录格式正确

Read the
```
SKILL.md
```
file of the target Skill
Check the directory structure and file list
Verify item by item according to the 19-item inspection checklist in checklist.md:
1. Naming specification check (3 items): directory name format, directory name suffix, best practice suffix
2. Preface section check (5 items): name field exists, name matches directory name, description exists, description is single-line, description length
3. Directory structure check (3 items): SKILL.md exists, fixed structure directories, empty directory check
4. File cleanup check (1 item): temporary file cleanup
5. Dependency metadata check (2 items): dependency.python format, dependency.system format
6. README.md record check (5 items): README.md exists, skills/ directory exists, Skill is in skills/, Skill is recorded, record format is correct

步骤 3：批量检查多个 Skill（自动遍历）

Step 3: Batch Check Multiple Skills (Automatic Traversal)

检查 Skills 是否位于
```
skills/
```
目录下

使用目录遍历命令列出目标目录下所有 Skill：

bash

find /workspace/projects/skills -maxdepth 1 -name "SKILL.md" -exec dirname {} \;

获取所有 Skill 目录列表后，对每个 Skill 重复步骤 2 的检查流程

Check if Skills are located under the
```
skills/
```
directory

Use the directory traversal command to list all Skills under the target directory:

bash

find /workspace/projects/skills -maxdepth 1 -name "SKILL.md" -exec dirname {} \;

After obtaining the list of all Skill directories, repeat the inspection process in Step 2 for each Skill

步骤 4：生成检查报告

Step 4: Generate Inspection Report

汇总所有检查结果
对每个 Skill 生成报告，包含：
- 19 项检查的明细（pass/warning/error）
- 总体状态（pass/warning/error）
- 修复建议
提供总体统计：Skill 数量、通过率、最常见问题

Summarize all inspection results
Generate a report for each Skill, including:
- Details of 19 inspection items (pass/warning/error)
- Overall status (pass/warning/error)
- Repair suggestions
Provide overall statistics: number of Skills, pass rate, most common issues

步骤 5：问题修复（可选）

Step 5: Issue Repair (Optional)

如果检查发现问题，根据用户需求执行修复：
- 自动修复：对于可安全自动修复的问题（如删除临时文件、删除空目录），直接执行修复
- 人工确认：对于需要判断的问题（如重命名目录、修改 description、修改 name 字段），提供修复建议，等待用户确认
参考 references/quality-standards.md 中的检查级别说明和修复建议
修复后重新验证，确认问题已解决且没有引入新问题

If issues are found during inspection, perform repairs according to user needs:
- Automatic repair: For issues that can be safely repaired automatically (such as deleting temporary files, deleting empty directories), perform repairs directly
- Manual confirmation: For issues that require judgment (such as renaming directories, modifying description, modifying name field), provide repair suggestions and wait for user confirmation
Refer to the inspection level explanations and repair suggestions in references/quality-standards.md
Re-verify after repair to confirm that the issue has been resolved and no new issues have been introduced

资源索引

Resource Index

检查清单:见 references/checklist.md
- 内容:完整的 19 项 Skill 检查清单（命名规范、前言区、目录结构、文件清理、依赖元数据、README.md 记录）
- 何时读取:开始检查前阅读，检查过程中逐项对照
质量标准:见 references/quality-standards.md
- 内容:各项检查的背景说明、通过标准定义、检查级别说明（pass/warning/error）
- 何时读取:理解检查项背景、确定修复优先级时参考

Inspection Checklist: See references/checklist.md
- Content: Complete 19-item Skill inspection checklist (naming specifications, preface section, directory structure, file cleanup, dependency metadata, README.md records)
- When to read: Read before starting the inspection, and compare item by item during the inspection process
Quality Standards: See references/quality-standards.md
- Content: Background explanations of each inspection item, definition of passing standards, inspection level explanations (pass/warning/error)
- When to read: Refer to when understanding the background of inspection items and determining repair priorities

注意事项

Notes

批量检查时，建议分批处理大量 Skills
修复问题后必须重新验证

When performing batch checks, it is recommended to process a large number of Skills in batches
Must re-verify after repairing issues

使用示例

Usage Examples

示例 1：检查单个 Skill

Example 1: Check a Single Skill

用户："检查 check-all-skills 这个 skill 是否符合规范"

执行步骤：

读取检查规范

读取

/workspace/projects/check-all-skills/SKILL.md

检查目录结构
逐项验证检查清单
输出检查报告

User: "Check if the check-all-skills skill complies with specifications"

Execution steps:

Read inspection specifications

Read

/workspace/projects/check-all-skills/SKILL.md

Check directory structure
Verify checklist items one by one
Output inspection report

示例 2：批量检查多个 Skill（自动遍历）

Example 2: Batch Check Multiple Skills (Automatic Traversal)

用户："检查 /workspace/projects 目录下所有 skill 是否符合规范"

执行步骤：

读取检查规范
使用步骤 3 中的命令列出该目录下所有 Skills
对每个 Skill 执行步骤 2 的检查流程
生成汇总报告

User: "Check if all skills under the /workspace/projects directory comply with specifications"

Execution steps:

Read inspection specifications
Use the command in Step 3 to list all Skills under this directory
Execute the inspection process in Step 2 for each Skill
Generate a summary report

示例 3：检查并自动修复问题

Example 3: Check and Automatically Repair Issues

用户："检查所有 skill 是否符合规范，发现问题自动修复"

执行步骤：

读取检查规范和问题修复指南
使用步骤 3 中的命令识别当前工作目录下的所有 Skills
对每个 Skill 执行步骤 2 的检查流程
根据步骤 5 执行修复：
- 可自动修复的：直接执行修复
- 需要确认的：提供修复建议，询问用户是否同意
修复后重新验证
生成修复报告

User: "Check if all skills comply with specifications and automatically repair any issues found"

Execution steps:

Read inspection specifications and issue repair guidelines
Use the command in Step 3 to identify all Skills in the current working directory
Execute the inspection process in Step 2 for each Skill
Perform repairs according to Step 5:
- For issues that can be automatically repaired: perform repairs directly
- For issues requiring confirmation: provide repair suggestions and ask the user for consent
Re-verify after repair
Generate a repair report

示例 4：检查特定维度

Example 4: Check Specific Dimensions

用户："检查 check-all-skills 的命名和目录结构是否符合规范"

执行步骤：

仅检查命名规范相关项目
仅检查目录结构相关项目
输出这两类检查的结果

User: "Check if the naming and directory structure of check-all-skills comply with specifications"

Execution steps:

Only check items related to naming specifications
Only check items related to directory structure
Output the results of these two types of inspections