Skill Best Practice Check

Task Objectives

• This Skill is used to: Check or verify whether a Skill complies with specification requirements
• Trigger condition: Check or verify specification compliance after creating or modifying a Skill

Operation Steps

Standard Process

1. Obtain Checklist
   • Read [references/checklist.md] to get the complete 14-item checklist
   • The checklist includes five categories of checks: naming conventions, SKILL.md preface section, directory structure, file cleanup, and dependency metadata
2. Check Skill Item by Item
   • Verify the Skill directory item by item according to [references/checklist.md]
   • Record the result of each check item (pass/warning/error)
3. Generate Inspection Report
   • Generate a structured report based on the template in [references/checklist.md#Report Format]
   • The report should include the Skill name, overall status, detailed results of each check item, and repair suggestions
4. Automatically Fix Issues
   • Prioritize handling

     error

     level issues
   • Directly modify non-compliant files (SKILL.md, directory structure, etc.)
   • Delete temporary files and redundant files
   • Re-execute the checklist verification after repair

Optional Branches

• Grouped Check: When there are many check items, you can check by five categories (naming, structure, metadata, files, dependencies)
• Detailed Standards: When you need to understand the detailed description of the inspection standards, read [references/quality-standards.md]

Skill Library Documentation Integrity Check and Automatic Repair

README.md

skills/

1. List all subdirectory names in the

   skills/

   directory
2. Read the table under the "## Skills" section in

   README.md

   and extract the skill names in the first column
3. Compare and generate a report: Find missing skills (existing in directories but not in the table) and redundant skills (existing in the table but not in directories)
4. Automatic Repair:
   • For missing skills: Directly add a new row to the table in the "## Skills" section of

     README.md

   • For redundant skills: Directly delete the corresponding row from the table in the "## Skills" section of

     README.md

Resource Index

• Checklist: [references/checklist.md]
  • When to read: Before starting the check
  • Content: Complete 14 check items, passing standards, repair suggestions, report format
• Detailed Specifications: [references/quality-standards.md]
  • When to read: When you need to understand the detailed description of the inspection standards
  • Content: Detailed descriptions of naming conventions, directory structure, metadata format, etc.
• Report Template: [references/check-report-template.md]
  • When to read: When generating the skill library documentation integrity check report
  • Content: Complete report example, automatic repair script template (supports direct file modification)