Skip to content

feat: improve 5 lowest-scoring skill definitions#210

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

feat: improve 5 lowest-scoring skill definitions#210
rohan-tessl wants to merge 1 commit into
databricks:mainfrom
rohan-tessl:improve/skill-review-optimization

Conversation

@rohan-tessl
Copy link
Copy Markdown

Hey @dhruv0811 👋

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

Skill Before After Change
quickstart 82% 100% +18%
long-running-server 82% 97% +15%
agent-openai-memory 78% 95% +17%
deploy 78% 93% +15%
lakebase-setup 78% 90% +12%

These were easy changes to bring the skill's structure and activation in line with what performs well against Anthropic's best practices. Total line reduction: 1540 to 655 lines (~57% smaller) with all domain expertise preserved.

What changed in deploy

Removed duplicated Quick Deploy section (kept the step-by-step workflow), removed CI/CD Pipeline, Monitoring, Adding Resources, and Best Practices sections that belong in other skills or AGENTS.md. Condensed troubleshooting into a compact table. 436 to 105 lines.

What changed in lakebase-setup

Removed both full databricks.yml examples that duplicated the step-by-step snippets, removed overlapping Use Cases/Overview sections, removed the LakebaseClient API reference and Service Principal identifiers sections. Kept the 7-step workflow with compact YAML snippets. 467 to 196 lines.

What changed in agent-openai-memory

Removed "How Sessions Work" and "Key Concepts" sections Claude already knows. Added a Lakebase connectivity verification checkpoint before testing. 176 to 127 lines.

What changed in long-running-server

Deduplicated two near-identical SDK code blocks into a single block with inline comments for SDK differences. Added verification checkpoints. Trimmed start_server.py to show only key changes. 343 to 145 lines.

What changed in quickstart

Removed template placeholder noise, removed verbose "What Quickstart Configures" section, added "Verify Setup" with concrete auth and .env validation commands. 118 to 82 lines.

In addition, I stress-tested your lakebase-setup skill against a few real-world scenarios, and it held up really well. This means that your skill meaningfully improves agent steering and contributes to stronger output quality. Kudos for that!

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.

If you want to self-improve your skills, or define your own scenarios to pressure test, just ask your agent (Claude Code, Codex, etc.) to evaluate and optimize your skill with Tessl. Ping me @rohan-tessl, if you hit any snags.

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