Skip to content

Improve/skill review optimization #2

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
yogesh-tessl wants to merge 2 commits into
base: main
Choose a base branch
from
Open

Improve/skill review optimization #2

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
e110381
feat: improve skill-issue skill score (95% → 100%)
yogesh-tessl Apr 22, 2026
561ecf1
ci: add skill-review GitHub Action for automated skill review on PRs
yogesh-tessl Apr 22, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
13 changes: 13 additions & 0 deletions .github/workflows/skill-review.yml
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -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
27 changes: 27 additions & 0 deletions SKILL.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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 <skill>` 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 <bin>` / `npm i -g <bin>`) 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
Expand Down