Skip to content

feat: improve use-notify skill score (85% → 95%)#16

Open
yogesh-tessl wants to merge 1 commit into
use-py:mainfrom
yogesh-tessl:improve/skill-review-optimization
Open

feat: improve use-notify skill score (85% → 95%)#16
yogesh-tessl wants to merge 1 commit into
use-py:mainfrom
yogesh-tessl:improve/skill-review-optimization

Conversation

@yogesh-tessl

Copy link
Copy Markdown

Hey 👋 @mic1on

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
use-notify 85% 95% +10%
Changes made
  • Description specificity: Expanded from generic "integrate and troubleshoot" to concrete actions - "configure notification channels, set up retry policies, debug publish errors, customize @notify decorators"
  • Trigger term coverage: Added useNotify.from_settings and set_default_notify_instance as additional trigger keywords
  • Inline code examples: Added two copy-pasteable Quick Examples (decorator pattern + publisher pattern) directly in the skill body so Claude has runnable code without needing to read reference files
  • Workflow verification step: Added step 5 to the workflow - verify error handling covers NotificationPublishError for multi-channel failures and retry configuration

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 👋 @mic1on

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 |
|-------|--------|-------|--------|
| use-notify | 85% | 95% | +10% |

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

- **Description specificity**: Expanded from generic "integrate and troubleshoot" to concrete actions — "configure notification channels, set up retry policies, debug publish errors, customize @notify decorators"
- **Trigger term coverage**: Added `useNotify.from_settings` and `set_default_notify_instance` as additional trigger keywords
- **Inline code examples**: Added two copy-pasteable Quick Examples (decorator pattern + publisher pattern) directly in the skill body so Claude has runnable code without needing to read reference files
- **Workflow verification step**: Added step 5 to the workflow — verify error handling covers `NotificationPublishError` for multi-channel failures and retry configuration

</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