Skip to content

feat: improve skill scores for claude_code_setup#1

Open
rohan-tessl wants to merge 1 commit intosreenivasanac:mainfrom
rohan-tessl:improve/skill-review-optimization
Open

feat: improve skill scores for claude_code_setup#1
rohan-tessl wants to merge 1 commit intosreenivasanac:mainfrom
rohan-tessl:improve/skill-review-optimization

Conversation

@rohan-tessl
Copy link
Copy Markdown

@rohan-tessl rohan-tessl commented Apr 8, 2026

Hey 👋 @mbailey

I ran your skills through tessl skill review at work and found some targeted improvements.

image

Here's the full before/after:

Skill Before After Change
show 86% 99% +13%
look 68% 99% +31%
show-me 67% 94% +27%

This PR covers all 3 skills in the repo — intentionally scoped to keep the review manageable.

Changes made

show (86% → 99%)

  • Expanded description with concrete actions (opens files in Neovim, launches URLs, runs commands in shell pane, focuses tmux panes)
  • Added "Use when..." clause with natural trigger terms: 'display', 'open this file', 'view', 'look at this URL'
  • Clarified visual rendering distinction from file-reading skills

look (68% → 99%)

  • Rewrote description from vague "Observe what the user is currently viewing" to specific capabilities (reads tmux pane content, scrollback history, window hierarchy)
  • Added "Use when..." clause with trigger terms: 'what's on my screen', 'look at my terminal', 'read my pane', 'check what I'm viewing'
  • No changes to content body (already scored 100%)

show-me (67% → 94%)

  • Replaced vague "Visual context sharing" description with concrete actions and explicit trigger terms
  • Consolidated redundant Chrome MCP sections (two separate sections covering the same workflows merged into one concise reference)
  • Reduced line count from 169 → 138 while preserving all actionable content

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 🙏

Hey @sreenivasanac 👋

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

| Skill | Before | After | Change |
|-------|--------|-------|--------|
| rigorous-coding | 55% | 84% | +29% |
| prompt-refiner | 60% | 100% | +40% |
| skill-creator | 64% | 94% | +30% |
| mgrep | 65% | 100% | +35% |
| web-design-guidelines | 72% | 86% | +14% |

This PR is intentionally scoped to the 5 lowest-scoring skills. The remaining
2 skills (react-useeffect at 90%, prompt-refiner-gpt at 81%) can be improved
in follow-ups or via automated review on future PRs.

Changes:
- rigorous-coding: Added workflow, checklist, and before/after code example
- prompt-refiner: Added refinement workflow, structured format, and example
- skill-creator: Trimmed verbose preamble, consolidated resources table
- mgrep: Fixed typos, rewrote description, removed over-claims
- web-design-guidelines: Merged duplicate sections, added example output

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.
@rohan-tessl rohan-tessl marked this pull request as ready for review April 8, 2026 09:01
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant