Back to Details

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 是否符合规范"
执行步骤：
  1. 读取检查规范
  2. 读取 
    /workspace/projects/check-all-skills/SKILL.md
  3. 检查目录结构
  4. 逐项验证检查清单
  5. 输出检查报告
User: "Check if the check-all-skills skill complies with specifications"
Execution steps:
  1. Read inspection specifications
  2. Read 
    /workspace/projects/check-all-skills/SKILL.md
  3. Check directory structure
  4. Verify checklist items one by one
  5. Output inspection report

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

Example 2: Batch Check Multiple Skills (Automatic Traversal)

用户："检查 /workspace/projects 目录下所有 skill 是否符合规范"
执行步骤：
  1. 读取检查规范
  2. 使用步骤 3 中的命令列出该目录下所有 Skills
  3. 对每个 Skill 执行步骤 2 的检查流程
  4. 生成汇总报告
User: "Check if all skills under the /workspace/projects directory comply with specifications"
Execution steps:
  1. Read inspection specifications
  2. Use the command in Step 3 to list all Skills under this directory
  3. Execute the inspection process in Step 2 for each Skill
  4. Generate a summary report

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

Example 3: Check and Automatically Repair Issues

用户："检查所有 skill 是否符合规范，发现问题自动修复"
执行步骤：
  1. 读取检查规范和问题修复指南
  2. 使用步骤 3 中的命令识别当前工作目录下的所有 Skills
  3. 对每个 Skill 执行步骤 2 的检查流程
  4. 根据步骤 5 执行修复：
    • 可自动修复的：直接执行修复
    • 需要确认的：提供修复建议，询问用户是否同意
  5. 修复后重新验证
  6. 生成修复报告
User: "Check if all skills comply with specifications and automatically repair any issues found"
Execution steps:
  1. Read inspection specifications and issue repair guidelines
  2. Use the command in Step 3 to identify all Skills in the current working directory
  3. Execute the inspection process in Step 2 for each Skill
  4. 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
  5. Re-verify after repair
  6. Generate a repair report

示例 4：检查特定维度

Example 4: Check Specific Dimensions

用户："检查 check-all-skills 的命名和目录结构是否符合规范"
执行步骤：
  1. 仅检查命名规范相关项目
  2. 仅检查目录结构相关项目
  3. 输出这两类检查的结果
User: "Check if the naming and directory structure of check-all-skills comply with specifications"
Execution steps:
  1. Only check items related to naming specifications
  2. Only check items related to directory structure
  3. Output the results of these two types of inspections