From af1eea8d97a56c8222abb7fdd6f3072eb98e27c0 Mon Sep 17 00:00:00 2001 From: Yogesh Rao Date: Fri, 17 Apr 2026 17:02:42 +0530 Subject: [PATCH 1/2] feat: improve skill scores for branch-memory-manager MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Hey 👋 @Davidcreador I ran your skills through `tessl skill review` at work and found some targeted improvements. Here's the full before/after: ![Skill Review Score Card](score_card.png) | Skill | Before | After | Change | |-------|--------|-------|--------| | list | 73% | 96% | +23% | | status | 73% | 96% | +23% | | save | 82% | 87% | +5% | | load | 90% | 90% | — (already great, left untouched) |
Changes made **list** & **status** — Added explicit "Use when..." clauses with natural trigger keywords (e.g. "show branches", "check memory status", "view what's stored"). These were the main gaps flagged by the evaluator — without a "Use when" clause, Claude has weaker signal for when to select the skill. **save** — Expanded trigger terms ("persist settings", "store context", "snapshot branch state") and added brief error handling guidance for when CLAUDE.md doesn't exist. Also added confirmation of what was saved in the result output. **load** — Already scoring 90% with solid "Use when" guidance and clean content. Left unchanged.
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 🙏 --- skills/list/SKILL.md | 2 +- skills/save/SKILL.md | 6 ++++-- skills/status/SKILL.md | 2 +- 3 files changed, 6 insertions(+), 4 deletions(-) diff --git a/skills/list/SKILL.md b/skills/list/SKILL.md index 2d9dca9..1c4887a 100644 --- a/skills/list/SKILL.md +++ b/skills/list/SKILL.md @@ -1,6 +1,6 @@ --- name: list -description: List all stored branch memories with their sizes and last modified dates. +description: "List all stored branch memories with their sizes and last modified dates. Use when the user asks to show branches, view saved memories, check what branches have stored context, or see memory usage." --- # List Branch Memories diff --git a/skills/save/SKILL.md b/skills/save/SKILL.md index f39e6b0..a894373 100644 --- a/skills/save/SKILL.md +++ b/skills/save/SKILL.md @@ -1,6 +1,6 @@ --- name: save -description: Save the current CLAUDE.md to branch-specific memory. Use when the user wants to save their current branch context. +description: "Save the current CLAUDE.md to branch-specific memory. Use when the user wants to save their current branch context, persist settings, store context, or snapshot their branch state." --- # Save Branch Memory @@ -14,4 +14,6 @@ node "${CLAUDE_PLUGIN_ROOT}/dist/cli.js" save "$ARGUMENTS" If no description was provided in the arguments, use a brief description based on recent work context. -Report the result to the user. +If the command fails, check that CLAUDE.md exists in the project root and report the error to the user. + +Report the result to the user, confirming the branch name and description that were saved. diff --git a/skills/status/SKILL.md b/skills/status/SKILL.md index b8917b2..9cee3a3 100644 --- a/skills/status/SKILL.md +++ b/skills/status/SKILL.md @@ -1,6 +1,6 @@ --- name: status -description: Show the current branch memory status including active memory, saved memory, and configuration. +description: "Show the current branch memory status including active memory, saved memory, and configuration. Use when the user asks to check memory status, view what's stored, inspect branch memory configuration, or see current memory info." --- # Branch Memory Status From 47d142014b540a2045e971f0960c83abb0654bb1 Mon Sep 17 00:00:00 2001 From: Yogesh Rao Date: Sun, 19 Apr 2026 00:33:24 +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