name	nex-skillmon
description	Health monitoring and cost optimization tool for OpenClaw skill ecosystems and power users managing multiple skills. Track all installed skills with real-time health scoring, detect stale skills (unused for 30+ days), identify skills with security flags or vulnerabilities, and monitor for available updates. View comprehensive cost dashboards showing API usage, estimated monthly costs, and spending per skill to identify expensive skills and optimize budget allocation. Set monthly cost budgets and receive alerts when approaching limits. Scan skill installation directories to discover all active skills and build baseline health metrics. Perform security checks for file integrity, vulnerability detection, and suspicious patterns. View usage statistics including trigger counts, execution duration, success rates, and trends over time. Generate detailed reports in markdown or JSON format for stakeholder communication and compliance documentation. Perfect for power users, development teams, and organizations managing complex skill infrastructures who need visibility into skill health, costs, and security posture.
version	1.0.0
metadata	{"clawdbot":{"emoji":"🔍","requires":{"bins":["python3"],"env":["CLAWHUB_API_URL","SKILLS_BASE_DIR"]},"primaryEnv":"","homepage":"https://nex-ai.be","files":["nex-skillmon.py","lib/*","setup.sh"]}}

Nex SkillMon

Skill Health & Cost Monitor - meta-tool for OpenClaw power users. Monitor installed skills, track API costs, detect stale skills, check security flags, and manage your skill ecosystem.

When to Use

Use this skill when the user asks about:

Which skills they have installed and their health status
Cost tracking and which skills are most expensive
API costs and token usage per skill
Skills that haven't been used recently (stale skills)
Security flags, vulnerabilities, or integrity issues with skills
Available updates for installed skills
Overall skill ecosystem health and usage patterns
Deprecated or removed skills
Skill performance metrics and trends
Monthly budget tracking and spending
Skill usage statistics over time
Exporting skill reports and analytics

Trigger phrases: "skill monitor", "which skills", "skill costs", "expensive skills", "stale skills", "security flags", "skill updates", "skill health", "API costs", "token usage", "skill report", "skill ecosystem", "monitor my skills", "what skills am I using"

Quick Setup

If the database does not exist yet, run the setup script:

bash setup.sh

This creates the data directory, initializes the database, and sets up the monitoring environment.

Available Commands

Basic Information

scan - Discover and scan all installed skills
```
nex-skillmon scan
```

list - List skills with filters

nex-skillmon list                    # All skills
nex-skillmon list --status active    # Active only
nex-skillmon list --stale            # Stale skills (unused 30+ days)
nex-skillmon list --flagged          # Flagged/security issues

show - Show detailed skill information
```
nex-skillmon show "skill-name"
```

Monitoring & Health

health - Health dashboard with scores
```
nex-skillmon health
```

check - Run comprehensive health checks

nex-skillmon check                        # All skills
nex-skillmon check --skill "skill-name"   # Specific skill

security - Security scan
```
nex-skillmon security
```
stale - Show unused/stale skills
```
nex-skillmon stale
```
updates - Check for available updates
```
nex-skillmon updates
```

Cost & Usage

cost - Cost overview

nex-skillmon cost                        # This month
nex-skillmon cost --period weekly --last 4   # Last 4 weeks
nex-skillmon cost --skill "skill-name"  # Specific skill

usage - Usage statistics

nex-skillmon usage
nex-skillmon usage --skill "skill-name"

budget - Budget management

nex-skillmon budget                # Check current budget
nex-skillmon budget --set 50       # Set monthly budget (€)
nex-skillmon budget --currency usd # Set currency

Alerts & Configuration

alerts - Show security/cost alerts

nex-skillmon alerts
nex-skillmon alerts --unacknowledged

acknowledge - Acknowledge an alert
```
nex-skillmon acknowledge 42
```

export - Export report as markdown or JSON

nex-skillmon export --format json --period monthly
nex-skillmon export --format markdown

config - Configuration management

nex-skillmon config                    # Show config
nex-skillmon config --set SKILLS_BASE_DIR /path/to/skills

Dashboard Output Example

Skill Health Dashboard
---
Score  Skill              Triggers  Cost/mo  Last Used    Status
 95    nex-life-logger    1,245     €2.34    2 hours ago  OK
 90    nex-crm             342      €0.89    1 day ago    OK
 85    nex-einvoice          47     €0.12    3 days ago   OK
 60    nex-healthcheck       89     €0.00    5 days ago   OK
 30    telegram-bot          12     €0.45    28 days ago  STALE
 10    old-skill              0     €0.00    45 days ago  STALE
  0    flagged-plugin         3     €1.20    2 days ago   FLAGGED
---
Total skills: 7 | Active: 4 | Stale: 2 | Flagged: 1
This month: €5.00 | Budget: €50.00 (10% used)

Features

Real-time Monitoring: Scan installed skills and track their status
Cost Tracking: Monitor API usage and estimated costs per skill
Security Checks: Detect flagged skills, file integrity changes, and vulnerabilities
Health Scoring: Comprehensive skill health metric (0-100) based on usage, errors, and staleness
Update Detection: Check for available updates on ClawHub
Stale Detection: Identify skills not used in N days
Usage Analytics: Track triggers, duration, success rate per skill
Budget Alerts: Set monthly budgets and get cost alerts
Report Export: Export detailed reports in markdown or JSON format

Data Storage

All data is stored locally in ~/.nex-skillmon/:

skillmon.db - SQLite database with skills, usage logs, and security checks
logs/ - Application logs
.env - Configuration (SKILLS_BASE_DIR, API credentials, etc.)

Configuration

Key environment variables can be set in ~/.nex-skillmon/.env:

SKILLS_BASE_DIR=/path/to/skills
CLAWHUB_API_URL=https://api.clawhub.dev
LOG_LEVEL=INFO
CURRENCY=EUR

Security & Privacy

All skill data is stored locally on your machine
Security checks query ClawHub API for known vulnerabilities (can be disabled)
File integrity verification uses local hashing
No personal data is sent to external services without your configuration

Requirements

Python 3.9+
Standard library only (urllib, sqlite3, etc.)

License

name	nex-skillmon
description	Health monitoring and cost optimization tool for OpenClaw skill ecosystems and power users managing multiple skills. Track all installed skills with real-time health scoring, detect stale skills (unused for 30+ days), identify skills with security flags or vulnerabilities, and monitor for available updates. View comprehensive cost dashboards showing API usage, estimated monthly costs, and spending per skill to identify expensive skills and optimize budget allocation. Set monthly cost budgets and receive alerts when approaching limits. Scan skill installation directories to discover all active skills and build baseline health metrics. Perform security checks for file integrity, vulnerability detection, and suspicious patterns. View usage statistics including trigger counts, execution duration, success rates, and trends over time. Generate detailed reports in markdown or JSON format for stakeholder communication and compliance documentation. Perfect for power users, development teams, and organizations managing complex skill infrastructures who need visibility into skill health, costs, and security posture.
version	1.0.0
metadata	{"clawdbot":{"emoji":"🔍","requires":{"bins":["python3"],"env":["CLAWHUB_API_URL","SKILLS_BASE_DIR"]},"primaryEnv":"","homepage":"https://nex-ai.be","files":["nex-skillmon.py","lib/*","setup.sh"]}}