Skip to content

feat: improve hackmd-cli skill score to 100%#96

Open
popey wants to merge 1 commit intohackmdio:developfrom
popey:improve/skill-review-optimization
Open

feat: improve hackmd-cli skill score to 100%#96
popey wants to merge 1 commit intohackmdio:developfrom
popey:improve/skill-review-optimization

Conversation

@popey
Copy link

@popey popey commented Mar 23, 2026

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:

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 🙏


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.

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 🙏
Copy link

@cursor cursor bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Cursor Bugbot has reviewed your changes and found 1 potential issue.

Fix All in Cursor

Bugbot Autofix is OFF. To automatically fix reported issues with cloud agents, enable autofix in the Cursor dashboard.


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 🙏
Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

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.

Fix in Cursor Fix in Web

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