Files
rohan-tessl 9f6d81ca6a feat: improve skill scores across 421 skills
Hey 👋 @partme-ai

I ran your skills through `tessl skill review` at work and found some targeted improvements across all 421 skills. Here's the full before/after:

Overall: 53% → 86% average (+32 percentage points) across 421 skills — 345 improved, 74 unchanged, 2 minor regressions.

| Skill Group | Skills | Before | After | Change |
|-------------|--------|--------|-------|--------|
| stitch-skills | 28 | 4% | 88% | +83% |
| tauri-skills | 52 | 32% | 89% | +57% |
| nvm-skills | 15 | 45% | 95% | +49% |
| social-skills | 2 | 40% | 84% | +43% |
| t2ui-skills | 97 | 46% | 87% | +41% |
| document-skills | 5 | 42% | 79% | +37% |
| vscode-skills | 4 | 58% | 91% | +34% |
| teaching-skills | 3 | 54% | 87% | +32% |
| avue-skills | 3 | 62% | 94% | +31% |
| electron-skills | 3 | 47% | 78% | +31% |

Key changes:
- Fixed allowed-tools validation (array→string) in 26 stitch-skills (0%→88% avg)
- Converted >- chevron descriptions to quoted strings across all skills
- Added executable code examples, workflow steps, and Use when clauses
- Fixed YAML parse errors, description length violations, name format issues
- Preserved all existing domain expertise and Chinese-language content
2026-03-25 14:24:58 +05:30

4.6 KiB

Hey 👋 @partme-ai

I ran your skills through tessl skill review at work and found some targeted improvements across all 421 skills. Here's the full before/after:

Score Card

Overall: 53% → 86% average (+32 percentage points) across 421 skills — 345 improved, 74 unchanged, 2 minor regressions.

Skill Group Skills Before After Change
stitch-skills 28 4% 88% +83%
tauri-skills 52 32% 89% +57%
nvm-skills 15 45% 95% +49%
social-skills 2 40% 84% +43%
t2ui-skills 97 46% 87% +41%
document-skills 5 42% 79% +37%
vscode-skills 4 58% 91% +34%
teaching-skills 3 54% 87% +32%
avue-skills 3 62% 94% +31%
electron-skills 3 47% 78% +31%
svelte-skills 1 64% 94% +30%
uview-skills 2 66% 94% +28%
mobile-native-skills 2 60% 86% +26%
drawio-skills 2 66% 92% +26%
database-skills 5 64% 89% +25%
speckit-skills 13 61% 85% +24%
pencil-skills 28 60% 83% +22%
antd-skills 4 66% 88% +22%
chart-skills 2 64% 86% +22%
devops-skills 6 68% 88% +20%
python-skills 3 68% 87% +19%
go-skills 2 66% 84% +19%
nodejs-skills 4 68% 86% +18%
utility-skills 3 64% 81% +18%
ascii-skills 13 70% 86% +16%
build-skills 6 69% 85% +16%
dev-utils-skills 13 63% 78% +15%
angular-skills 1 70% 85% +15%
design-skills 4 59% 73% +14%
react-skills 6 75% 88% +14%
threejs-skills 18 84% 95% +11%
ddd-skills 6 71% 82% +11%
flutter-skills 2 72% 83% +10%
testing-skills 9 73% 83% +9%
uniapp-skills 13 58% 67% +9%
spring-skills 7 75% 81% +5%
docker-skills 2 84% 88% +4%
vue-skills 7 72% 74% +2%
vue-ui-skills 4 70% 70% 0%
openspec-skills 15 88% 88% 0%
ocrmypdf-skills 5 93% 93% 0%
cocos-skills 1 71% 71% 0%
Changes made

Validation fixes (biggest impact on 0% skills)

  • Fixed allowed-tools format in 26 stitch-skills: converted YAML arrays to comma-separated quoted strings (the spec requires a string, not an array)
  • Fixed descriptions exceeding 1024 chars in mermaid, plantuml, and several others — trimmed while preserving key trigger terms
  • Fixed YAML parse errors in plantuml frontmatter
  • Fixed name field in internal-comms and uniapp-mini to match kebab-case requirements

Description improvements (all 421 skills)

  • Converted >- chevron descriptions to quoted strings for consistent formatting
  • Added explicit "Use when..." trigger clauses where missing
  • Made descriptions more specific and action-oriented (e.g., "Provides comprehensive guidance" → "Creates, debugs, and configures...")
  • Ensured all descriptions include concrete trigger terms users would naturally say

Content improvements (345 skills)

  • Added executable code examples (real, runnable snippets — not pseudocode) to skills that only had bullet points or topic outlines
  • Added numbered workflow steps with validation checkpoints
  • Expanded thin Chinese-only content with English equivalents while preserving all existing domain-specific content
  • Added concrete CLI commands with actual arguments (e.g., ng generate component user-profile --standalone)
  • Added troubleshooting sections for common error scenarios in framework skills

Skills left unchanged (76)

  • High-scoring skills (90%+) like openspec, ocrmypdf, and well-structured vue/spring/threejs skills were not modified beyond formatting
  • Skills with deep, well-structured domain content that would not benefit from changes

Minor regressions (2)

  • java-code-comments (74% → 68%) and mybatis-plus-generator (77% → 74%): description improved to 100%, but the existing verbose body content (450+ lines of domain-specific Chinese content) was scored more harshly. The body was preserved as-is to maintain domain expertise.

Honest disclosure — I work at @tesslio where we build tooling around skills like these. Not a pitch - just saw room for improvement and wanted to contribute.

Want to self-improve your skills? Just point your agent (Claude Code, Codex, etc.) at this Tessl guide and ask it to optimize your skill. Ping me - @rohan-tessl - if you hit any snags.

Thanks in advance 🙏