A systematic workflow for evaluating, proposing, and safely implementing improvements to existing OpenCode skills.
This skill provides an end-to-end workflow for improving OpenCode skills:
Discover skills → Evaluate quality → Propose improvements → Implement safely → Document changes
It integrates with skill-quality-reviewer for scoring and skill-development for best practices.
- 🔍 Comprehensive Evaluation: 5-dimension scoring system for skill quality assessment
- 📊 Detailed Reports: Generate quality reports and improvement plans
- 🛡️ Safe Implementation: Pre-flight checks, sequential execution, per-change validation
- 📝 Automatic Documentation: Generate improvement logs with user-specified locations
- 🔄 Rollback Support: Emergency rollback procedures for failed improvements
- Clone this repository:
git clone https://github.com/yourusername/opencode-skill-improver.git- Copy to your OpenCode skills directory:
cp -r opencode-skill-improver ~/.config/opencode/skills/skill-improveropencode skills install skill-improver- Start OpenCode in a project directory
- Ask to improve skills:
- "Improve my skills"
- "Evaluate all skills"
- "Fix skill issues"
- "Review and improve skills"
This skill activates when you say:
- "improve skills"
- "evaluate all skills"
- "fix skill issues"
- "review and improve skills"
- "apply skill improvements"
The skill evaluates each skill across 5 dimensions:
| Dimension | Weight | Description |
|---|---|---|
| Content Depth | 30% | Comprehensiveness and technical detail |
| Trigger Quality | 20% | Effectiveness of triggering conditions |
| Structure & Organization | 20% | Progressive disclosure and hierarchy |
| Practical Utility | 15% | Actionability and real-world usefulness |
| Safety & Correctness | 15% | Security and correctness of patterns |
Overall = (Content × 0.30) + (Trigger × 0.20) + (Structure × 0.20) +
(Utility × 0.15) + (Safety × 0.15)
| Score | Grade | Status |
|---|---|---|
| 90-100 | A | Excellent, exemplary |
| 80-89 | B | Good, minor improvements |
| 70-79 | C | Adequate, needs work |
| 60-69 | D | Weak, significant issues |
| <60 | F | Failing, requires rewrite |
- List all available skills
- Read each SKILL.md file
- Score each skill using the 5-dimension framework
- Identify improvement candidates (skills scoring below 80)
For each identified candidate:
- Diagnose specific issues
- Propose concrete solutions
- Present proposal to user for confirmation
Apply approved improvements with safety checks:
- Pre-flight checks (backup, validation)
- Sequential implementation
- Per-change validation
- Rollback on error
- Ask user where to save improvement log
- Generate detailed improvement documentation
- Append to existing logs with date separation
- Always read before writing — Never edit a file without reading it first
- Sequential execution — Apply changes one at a time, not in parallel
- Validate after each change — Check file integrity immediately
- Never delete without backup — Move to deprecated/ if removal needed
- Maintain change log — Document what changed and why
| Error Type | Response |
|---|---|
| File not found | Stop, report to user |
| YAML parse error | Rollback, report |
| Broken reference | Fix reference or remove link |
| Unexpected content | Rollback, ask user |
skill-improver/
├── SKILL.md # Main skill definition
├── examples/
│ ├── improvement-log-example.md # Improvement log template
│ ├── improvement-plan-example.md # Improvement plan template
│ └── update-report-example.md # Update report template
├── references/
│ ├── error-handling.md # Error handling procedures
│ ├── improvement-patterns.md # Common improvement patterns
│ ├── merge-strategies.md # Content merge strategies
│ ├── plan-format.md # Plan formatting guidelines
│ ├── safety-guidelines.md # Safety procedures
│ ├── scoring-rubric.md # Detailed scoring criteria
│ └── supported-updates.md # Supported update types
└── scripts/
├── backup-skill.sh # Backup script
└── verify-update.sh # Update verification script
User: "Evaluate all my skills and show me which ones need improvement"
Claude will:
1. List all skills in ~/.config/opencode/skills/
2. Score each skill on 5 dimensions
3. Generate a summary table
4. Identify skills scoring below 80
5. Present improvement candidates
User: "Improve the daily-coding skill"
Claude will:
1. Read the current SKILL.md
2. Evaluate its quality
3. Diagnose issues
4. Propose specific improvements
5. Apply changes with your approval
6. Generate improvement log
- skill-quality-reviewer — Generate quality reports and improvement plans
- skill-development — Best practices for creating new skills
- code-review-excellence — Effective code review practices
Contributions are welcome! Please feel free to submit a Pull Request.
- Fork the repository
- Create a feature branch:
git checkout -b feature/amazing-feature - Make your changes
- Test thoroughly
- Commit your changes:
git commit -m 'Add amazing feature' - Push to the branch:
git push origin feature/amazing-feature - Open a Pull Request
This project is licensed under the MIT License - see the LICENSE file for details.
- OpenCode community for the skill development framework
- Contributors who have helped improve this skill
- Added comprehensive 5-dimension evaluation framework
- Implemented safe implementation workflow
- Added user-specified log location feature
- Enhanced error handling and rollback procedures
- Initial release
- Basic skill improvement workflow
- Simple evaluation criteria
If you encounter any issues or have questions:
- Check the documentation
- Search existing issues
- Create a new issue if needed
Made with ❤️ for the OpenCode community