Skip to content

feat: improve 5 lowest-scoring skill definitions#406

Merged
GregHolmes merged 1 commit into
deepgram:mainfrom
rohan-tessl:improve/skill-review-optimization
May 12, 2026
Merged

feat: improve 5 lowest-scoring skill definitions#406
GregHolmes merged 1 commit into
deepgram:mainfrom
rohan-tessl:improve/skill-review-optimization

Conversation

@rohan-tessl

Copy link
Copy Markdown
Contributor

Hey @deepgram 👋

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
deepgram-dotnet-management-api 89% 100% +11%
deepgram-dotnet-speech-to-text 89% 100% +11%
deepgram-dotnet-conversational-stt 76% 95% +19%
deepgram-dotnet-text-to-speech 86% 95% +9%
deepgram-dotnet-voice-agent 89% 95% +6%

These were easy changes to bring the skill's structure and activation in line with what performs well against Anthropic's best practices. Added error handling, reconnection logic, cleanup/shutdown steps, condensed verbose sections.

In addition, I stress-tested your deepgram-dotnet-conversational-stt 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.

@rohan-tessl
rohan-tessl requested a review from lukeocodes as a code owner May 7, 2026 06:43
@GregHolmes
GregHolmes merged commit d7600e5 into deepgram:main May 12, 2026
2 checks passed
@rohan-tessl

rohan-tessl commented Jun 3, 2026

Copy link
Copy Markdown
Contributor Author

Thanks @GregHolmes for the quick merge, and @lukeocodes for the review really appreciated the fast turnaround on a drive-by contribution.

We've reviewed a bunch of skills across different orgs by now and have picked up some useful patterns around keeping them maintainable, secure, and well-scored as adoption grows — especially around the tradeoffs between agent-friendly brevity and SDK-accurate detail (which mattered a lot for the conversational-stt and voice-agent skills here).

If you're open to it, a 15-min coffee would be a good way to swap notes: Calendly link.

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.

3 participants