feat: improve hackmd-cli skill score to 100% - #96
Conversation
Sorry, something went wrong.
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% | <details> <summary>Changes summary</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. </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 - [@popey](https://github.com/popey) - if you hit any snags. Thanks in advance 🙏
There was a problem hiding this comment.
Cursor Bugbot has reviewed your changes and found 1 potential issue.
Bugbot Autofix is OFF. To automatically fix reported issues with cloud agents, enable autofix in the Cursor dashboard.
Sorry, something went wrong.
|
|
||
| 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 - [@popey](https://github.com/popey) - if you hit any snags. | ||
|
|
||
| Thanks in advance 🙏 |
There was a problem hiding this comment.
PR description file accidentally committed to repository
Medium Severity
The pr_description.md file is the PR description text accidentally committed to the repository. This file has no purpose in the project — it's a draft/copy of the GitHub PR body, including promotional content and a reference to a non-existent score_card.png. It doesn't belong in the codebase and would clutter the repository root.
Sorry, something went wrong.
There was a problem hiding this comment.
Great contribution! Just a reminder to remove the pr_description.md @popey
Sorry, something went wrong.
The PR body draft was committed by mistake and does not belong in the repo. Co-authored-by: Cursor <cursoragent@cursor.com>
Co-authored-by: Cursor <cursoragent@cursor.com>
Co-authored-by: Cursor <cursoragent@cursor.com>
Hullo @hackmdio 👋
I'm a fellow hackmd abuser! Thanks for maintaining it. Having used a bazillion notes "apps" over the years, this is the only one that has stuck in my silly brain!
I ran your skills through tessl skill review at work and found some targeted improvements. Here's the full before/after:
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:
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 🙏
Note
Low Risk
Documentation-only updates that add workflow verification commands and troubleshooting guidance; no runtime or API behavior changes.
Overview
Improves the hackmd-cli skill documentation by adding post-action verification steps to the “Sync local file to HackMD” workflow (confirming note creation and previewing exported content after updates).
Adds a new Error Handling section with a quick reference table for common failures (Unauthorized, Not Found, Forbidden) and suggested fixes.
Written by Cursor Bugbot for commit 409706b. This will update automatically on new commits. Configure here.