skill-optimizer-yashu

Original🇨🇳 Chinese
Translated
8 scriptsChecked / no sensitive code detected

Analyze and optimize document quality issues of other Skills, including checks on frontmatter format, progressive disclosure structure, file reference integrity, AI-friendliness, etc. When to use: When users say "optimize this skill", "check skill quality", "review skill", "there's something wrong with the skill", "help me look at this skill", "diagnose the skill"

10installs
Added on

NPX Install

npx skill4agent add steelan9199/wechat-publisher skill-optimizer-yashu

SKILL.md Content (Chinese)

View Translation Comparison →

Skill Optimizer

AI Calling Specification: This Skill is designed exclusively for AI. Human users only need to describe their requirements in natural language, and the AI will automatically complete analysis and optimization.

How to Use This Skill

Trigger Conditions

User Input ExamplesAI Execution
"check / diagnose / review / look at / analyze / evaluate xxx skill"Run analyze.py for quality analysis
"optimize / improve / fix / upgrade / refactor xxx skill"Run optimize.py to generate optimized documents
Default Behavior: If the user's intent is unclear, prioritize executing analyze.py (analysis scenarios account for 90%).

Execution Steps

ScenarioStepAI ActionSpecific Command
Analysis1Run analysis script
python skill-optimizer-yashu/scripts/analyze.py <skill-name> --folder <skills-folder>
Analysis2Parse output resultsExtract the number of errors/warnings/suggestions/hints and detailed problem lists
Analysis3Output analysis reportDisplay results to users according to the [Analysis Result Template]
Optimization1Run optimization script
python skill-optimizer-yashu/scripts/optimize.py <skill-name> --folder <skills-folder> --output /tmp/<skill-name>-optimized.md
Optimization2Confirm optimization completionCheck if the output file exists
Optimization3Output optimization summaryDisplay an overview of optimized content and file path to users

Output Templates

Analysis Result Template:
==================================================
Analysis Result: {Level}
==================================================
Errors: {N} | Warnings: {N} | Suggestions: {N} | Hints: {N}

Issues Found:
  - {Type}: {Issue Description}
  - {Type}: {Issue Description}
Optimization Result Template:
✅ Optimization Completed!
📄 Optimized document saved to: {File Path}

Optimization Overview:
- {Optimization Item 1}
- {Optimization Item 2}
- {Optimization Item 3}

Inspection Dimensions

  1. Frontmatter Format - Check fields such as name, description, metadata
  2. Progressive Disclosure Structure - Check document length and content organization
  3. File Reference Integrity - Check if referenced files exist
  4. AI-friendliness - Check whether AI can accurately understand and execute
  5. Completeness of Usage Instructions - Check if there are clear usage instructions
  6. Token Efficiency - Check the way information is organized
For detailed inspection standards, refer to Check Specification.

Rating Standards

LevelConditionsExplanation
Needs FixErrors existCritical issues that must be fixed, affecting normal use of the skill
GoodNo errors, with warningsMinor issues that need attention but do not affect usage
ExcellentNo errors/warnings, with suggestionsOptimization suggestions to further improve quality
Very GoodNo errors/warnings/suggestions, with hintsMinor hints, overall quality is high
PerfectNo issues at allFully compliant with specifications, no problems

Error Handling

Error ScenarioHandling Method
Skill does not existPrompt that the specified skill folder cannot be found
Invalid pathPrompt for invalid folder path
SKILL.md missingMark as error, prompt for missing main document

Resources

  • analyze.py - Main script for analyzing skill quality
  • optimize.py - Generate optimized SKILL.md based on analysis results
  • Check Specification - Detailed inspection standards and specification descriptions