Hullo @hackmdio 👋
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 |
|---|---|---|---|
| hackmd-cli | 94% | 100% | +6% |
Changes summary
The hackmd-cli skill was already well-crafted (94%) — the only dimension below perfect was workflow_clarity (2/3). The changes are minimal and targeted:
- Added verification steps to the "Sync local file to HackMD" workflow so users can confirm operations succeeded (e.g., retrieving the note after creation, previewing content after update)
- Added an Error Handling section with a table covering common failure scenarios (
Unauthorized,Not Found,Forbidden) and their fixes — giving users a clear troubleshooting path
These two additions moved the content score from 88% to 100%, with workflow_clarity improving from 2/3 to 3/3.
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 - @popey - if you hit any snags.
Thanks in advance 🙏