From e11038175b9bdef04cf964cfb611fb342d49ddbb Mon Sep 17 00:00:00 2001 From: Yogesh Rao Date: Wed, 22 Apr 2026 13:34:02 +0530 Subject: [PATCH 1/2] =?UTF-8?q?feat:=20improve=20skill-issue=20skill=20sco?= =?UTF-8?q?re=20(95%=20=E2=86=92=20100%)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Hey @krispuckett 👋 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 | |-------|--------|-------|--------| | skill-issue | 95% | 100% | +5% | Your skill was already in great shape — 95% out of the gate. The reviewer flagged two areas in the **Content** dimension (88% → 100%):
Changes made - **Added example output section** — shows the actual markdown report format the audit produces, so agents know exactly what to expect and can interpret results for the user - **Added "Acting on Results" section** — a quick reference for each recommendation type (keep/update/review/remove) with concrete next steps, including a verification note before removing skills with broken deps Both additions directly addressed the `workflow_clarity` dimension (scored 2/3 → 3/3), which wanted a clearer post-audit workflow for acting on recommendations.
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 🙏 --- SKILL.md | 27 +++++++++++++++++++++++++++ 1 file changed, 27 insertions(+) diff --git a/SKILL.md b/SKILL.md index 151ec32..1540ef9 100644 --- a/SKILL.md +++ b/SKILL.md @@ -36,6 +36,33 @@ node scripts/audit.mjs > /tmp/skill-audit-report.md 4. **Versions** — Checks ClawdHub registry if `clawdhub` CLI is available 5. **Recommendations** — keep (active+healthy), update (outdated), review (unused), remove (broken deps) +## Example Output + +```markdown +# 🔍 Skill Audit Report + +## Summary +- Total skills: 4 +- ✅ Keep: 2 +- 🔎 Review: 1 +- 🗑️ Remove: 1 + +## Detailed Report +| # | Skill | Bins | Usage (7d) | Health | Rec | +|---|----------|----------|------------|-------------|-----------| +| 1 | weather | curl | 📊 5 | ✅ | ✅ keep | +| 2 | email | himalaya | 📊 8 | ✅ | ✅ keep | +| 3 | notes | — | — | ✅ | 🔎 review | +| 4 | voice | sag | — | ❌ sag | 🗑️ remove | +``` + +## Acting on Results + +- **✅ keep** — Active and healthy. No action needed. +- **🔄 update** — Hub has a newer version. Run `clawdhub install ` to update. +- **🔎 review** — Unused in the last `AUDIT_DAYS` days. Confirm the skill is still needed or remove it to reduce clutter. +- **🗑️ remove** — Missing required binaries. Install the dependency (`brew install ` / `npm i -g `) or remove the skill if no longer needed. Verify the binary name is correct before removing. + ## Safety - **Read-only** — Never modifies, installs, or removes anything From 561ecf1c34f92a78dcfd61010e37b880a9a8af46 Mon Sep 17 00:00:00 2001 From: Yogesh Rao Date: Wed, 22 Apr 2026 14:29:13 +0530 Subject: [PATCH 2/2] ci: add skill-review GitHub Action for automated skill review on PRs --- .github/workflows/skill-review.yml | 13 +++++++++++++ 1 file changed, 13 insertions(+) create mode 100644 .github/workflows/skill-review.yml diff --git a/.github/workflows/skill-review.yml b/.github/workflows/skill-review.yml new file mode 100644 index 0000000..f0ab779 --- /dev/null +++ b/.github/workflows/skill-review.yml @@ -0,0 +1,13 @@ +name: Skill Review +on: + pull_request: + paths: ['**/SKILL.md'] +jobs: + review: + runs-on: ubuntu-latest + permissions: + pull-requests: write + contents: read + steps: + - uses: actions/checkout@v4 + - uses: tesslio/skill-review@22e928dd837202b2b1d1397e0114c92e0fae5ead # main