Skill Insight 🦞

By Hal Labs — Part of the Hal Stack

What it does: Analyzes skill usage data you already have. Generates reports, tracks success/failure, identifies dead weight. It does not automatically collect data for you.

The Honest Scope

This skill is a data analysis and reporting tool. It assumes usage data already exists. If you don't collect any, the reports will be empty.

What it CAN do well:

• - Generate readable usage reports (daily/weekly/monthly)
• Track success vs failure rates per skill
• Recommend which zero-use skills to uninstall
• Work fully automatically for script-type skills (cron scan)

What it CANNOT do automatically:

• - Detect route-type skill calls — these happen inside the AI's reasoning, never appearing in session text
• Know which skills you actually use without you telling it

Setup is required. See the section below.

Quick Setup (3 steps)

Step 1 — Add skills to your registry

CODEBLOCK0

Step 2 — Choose a data collection method

This is the critical part. Pick one that matches your workflow:

Option A: For script-type skills only (easiest, automatic)

# Add to crontab -e:
0 9 * * * cd ~/.openclaw/workspace/skills/skill-insight && bash scripts/cron_wrapper.sh >> ~/.local/log/skill-insight.log 2>&1

Option B: For route-type skills (requires agent cooperation)

Add to your agent's HEARTBEAT.md or equivalent:
CODEBLOCK2

Option C: Manual (lowest effort, most incomplete)
CODEBLOCK3

Step 3 — Generate reports

CODEBLOCK4

How Data Collection Works

Understanding access_type helps you know what's covered:

If most of your skills are route-type (most OpenClaw skills), Option B is the only way to get meaningful data.

Setting Up Auto-Record for Route-Type Skills

If your agent supports HEARTBEAT.md or similar periodic scripts, add this:

CODEBLOCK5

For OpenClaw agents with proactive agent protocols (WAL/Working Buffer), the record call can be inserted after the WAL write step.

Commands Reference

CODEBLOCK6

Output Language

Use --lang en for English, --lang zh for Chinese. Falls back to English if unset.

Architecture

CODEBLOCK7

Philosophy

You can't optimize what you don't measure.

This skill answers: which skills am I actually using? Which ones are dead weight? Is this skill reliable?

The goal isn't to use every skill — it's to know which ones earn their place.