Skip to content

feat: improve skill scores for GcRustVsJvm#1

Open
yogesh-tessl wants to merge 1 commit intotechatspree:masterfrom
yogesh-tessl:improve/skill-review-optimization
Open

feat: improve skill scores for GcRustVsJvm#1
yogesh-tessl wants to merge 1 commit intotechatspree:masterfrom
yogesh-tessl:improve/skill-review-optimization

Conversation

@yogesh-tessl
Copy link
Copy Markdown

Hey @tnfink 👋

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

score_card

The main issue was the missing YAML frontmatter. Without it, the skill fails validation entirely and agents can't properly discover or match it.

Changes made
  • Added YAML frontmatter with name and description fields so agents can discover and select the skill
  • Added a structured "Use when..." clause in the description with specific trigger terms (performance benchmarks, comparing language execution times, profiling Haskell memory, dataset sizes)
  • Replaced hardcoded JAVA_HOME path (/Users/tnfink/Library/Java/...) with a portable java_home lookup that falls back gracefully
  • Restructured content from flat instructions/notes into a clear Workflow + Environment Requirements layout
  • Improved formatting with bold step labels and consistent inline code styling

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 - @yogesh-tessl - if you hit any snags.

Thanks in advance 🙏

Hey @tnfink 👋

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 |
|-------|--------|-------|--------|
| run-benchmarks | 10% | 95% | +85% |

The main issue was the missing YAML frontmatter — without it, the skill fails validation entirely and agents can't properly discover or match it.

<details>
<summary>Changes made</summary>

- **Added YAML frontmatter** with `name` and `description` fields so agents can discover and select the skill
- **Added a structured "Use when..." clause** in the description with specific trigger terms (performance benchmarks, comparing language execution times, profiling Haskell memory, dataset sizes)
- **Replaced hardcoded JAVA_HOME path** (`/Users/tnfink/Library/Java/...`) with a portable `java_home` lookup that falls back gracefully
- **Restructured content** from flat instructions/notes into a clear Workflow + Environment Requirements layout
- **Improved formatting** with bold step labels and consistent inline code styling

</details>

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](https://docs.tessl.io/evaluate/optimize-a-skill-using-best-practices) and ask it to optimize your skill. Ping me - [@yogesh-tessl](https://github.com/yogesh-tessl) - if you hit any snags.

Thanks in advance 🙏
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