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 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