Capability Evolver
Meta-skill for AI agent self-improvement. Analyzes runtime logs to detect error patterns, regressions, and inefficiencies, then generates structured improvem...
Meta-skill for AI agent self-improvement. Analyzes runtime logs to detect error patterns, regressions, and inefficiencies, then generates structured improvem...
Real data. Real impact.
Emerging
Developers
Per week
Open source
Skills give you superpowers. Install in 30 seconds.
Local skill by Claw0x — runs entirely in your OpenClaw agent.
Runs locally. No external API calls, no API key required. Complete privacy.
Analyze agent runtime logs, detect patterns, compute health scores, and generate structured improvement proposals. Pure deterministic logic — no LLM, no external dependencies.
| When This Happens | Use Action | What You Get |
|---|---|---|
| Agent keeps failing | | Error patterns + health score |
| Same error repeats | | Root cause identification |
| Need improvement plan | | Prioritized recommendations |
| System health check | | Health score + summary |
| Post-deployment review | | Regression detection |
| Fleet-wide diagnostics | (batch) | Cross-agent patterns |
Why deterministic? Reproducible results, no hallucination risk, sub-100ms processing, zero token costs.
None. Just install and use.
openclaw skill add capability-evolver
const result = await agent.run('capability-evolver', { action: 'analyze', logs: [ {timestamp: '2025-01-15T10:00:00Z', level: 'error', message: 'ETIMEDOUT', context: 'payment-api.ts'}, {timestamp: '2025-01-15T10:01:00Z', level: 'error', message: 'ETIMEDOUT', context: 'payment-api.ts'}, {timestamp: '2025-01-15T10:02:00Z', level: 'error', message: 'ETIMEDOUT', context: 'payment-api.ts'} ] });
{ "patterns": [ { "type": "repeated_error", "severity": "high", "description": "ETIMEDOUT appeared 3 times in payment-api.ts", "affected_contexts": ["payment-api.ts"] } ], "health_score": 45, "recommendations": [ "Add timeout configuration to payment-api.ts", "Implement retry logic with exponential backoff", "Monitor payment API response times" ] }
const evolution = await agent.run('capability-evolver', { action: 'evolve', logs: result.logs, strategy: 'harden' });
Done. You now have a prioritized improvement roadmap, all processed locally.
Problem: Your agent crashed in production and you need to understand why
Solution:
Example:
const logs = await db.logs.findMany({ where: { timestamp: { gte: incidentStart } }, orderBy: { timestamp: 'asc' } });const analysis = await agent.run('capability-evolver', { action: 'analyze', logs: logs.map(l => ({ timestamp: l.timestamp, level: l.level, message: l.message, context: l.context })) });
// analysis.patterns shows: "auth-service.ts failed, then payment-api.ts failed" // Root cause: auth service timeout cascaded to payment failures
Problem: You want your agent to automatically improve based on production data
Solution:
Example:
// Cron job: every day at 2am async function dailyEvolution() { const logs = await getLast24HoursLogs();const evolution = await agent.run('capability-evolver', { action: 'evolve', logs, strategy: 'balanced' });
// Store recommendations for review for (const rec of evolution.recommendations.filter(r => r.priority === 'critical')) { await db.recommendations.create({ title:
, priority: rec.priority, affected_files: rec.affected_files, approach: rec.suggested_approach }); }${rec.category}: ${rec.description}// Track health score trend await db.metrics.create({ date: new Date(), health_score: evolution.estimated_improvement }); } // Result: Health score improved from 45 to 85 over 3 months
Problem: Managing 50+ agent instances, need to identify systemic issues
Solution:
Example:
# Collect logs from all agents all_logs = [] for agent_id in agent_fleet: logs = fetch_agent_logs(agent_id, last_24h) all_logs.extend(logs)Analyze fleet-wide
result = client.call("capability-evolver", { "action": "analyze", "logs": all_logs })
result.patterns shows: "40 of 50 agents failing on auth-service.ts"
Fix auth-service.ts once, deploy to all agents
Result: 80% reduction in fleet-wide errors
Problem: Want to ensure new deployment doesn't introduce regressions
Solution:
Example:
// Pre-deployment health check script async function preDeploymentCheck() { const stagingLogs = await fetchStagingLogs();const result = await agent.run('capability-evolver', { action: 'analyze', logs: stagingLogs });
const BASELINE = 75;
if (result.health_score < BASELINE) { console.error(
); console.error('Critical patterns:', result.patterns.filter(p => p.severity === 'critical')); process.exit(1); }Health score ${result.health_score} below baseline ${BASELINE}console.log(); } // Result: Zero regression-related incidents in 6 months✓ Health check passed: ${result.health_score}
// Analyze logs after each run agent.onComplete(async () => { const logs = agent.getRecentLogs();const analysis = await agent.run('capability-evolver', { action: 'analyze', logs });
if (analysis.health_score < 70) { console.warn('⚠️ Health score low:', analysis.health_score); console.log('Recommendations:', analysis.recommendations); } });
def analyze_agent_health(logs): result = agent.run("capability-evolver", { "action": "analyze", "logs": logs })return { "health_score": result["health_score"], "patterns": result["patterns"], "recommendations": result["recommendations"] }Use in monitoring
health = analyze_agent_health(agent.logs) if health["health_score"] < 70: alert_team(health)
// Real-time health monitoring async function updateHealthDashboard() { const logs = await db.logs.findMany({ where: { timestamp: { gte: Date.now() - 3600000 } } // last hour });const result = await agent.run('capability-evolver', { action: 'analyze', logs });
// Update dashboard dashboard.update({ healthScore: result.health_score, errorRate: result.summary.error_count / result.summary.total_logs, topPatterns: result.patterns.slice(0, 5) }); }
setInterval(updateHealthDashboard, 60000); // every minute
// Compare different evolution strategies const logs = await getProductionLogs();const strategies = ['balanced', 'innovate', 'harden', 'repair-only'];
const results = await Promise.all( strategies.map(strategy => agent.run('capability-evolver', { action: 'evolve', logs, strategy }) ) );
// Compare estimated improvements for (let i = 0; i < strategies.length; i++) { console.log(
); }${strategies[i]}: ${results[i].estimated_improvement}// Choose best strategy for current situation const best = results.reduce((a, b) => parseFloat(a.estimated_improvement) > parseFloat(b.estimated_improvement) ? a : b );
Capability Evolver is a deterministic analysis engine that processes structured log data and produces actionable diagnostics. No LLM is involved �?the analysis is rule-based, which means results are reproducible and fast.
The core engine processes log entries through several analysis passes:
Pattern detection �?logs are grouped by
context (file/module) and level (error/warn/info/debug). The engine looks for:
Health scoring �?a system health score (0�?00) is computed based on:
Recommendation generation �?based on detected patterns, the engine generates specific, actionable recommendations. These aren't generic advice �?they reference the actual files, error messages, and patterns found in your logs.
When using the
evolve action, you can choose a strategy that shapes the recommendations:
| Strategy | Focus | Best For |
|---|---|---|
| Balanced based on health score | Default �?let the engine decide |
| Equal weight to reliability and features | Stable systems with moderate issues |
| Prioritize new capabilities | Healthy systems ready to grow |
| Prioritize reliability and error reduction | Systems with frequent failures |
| Fix critical issues only | Systems in crisis |
The
evolve action produces structured improvement proposals with:
evolution_id for trackingThe tradeoff: the engine can't understand semantic meaning in log messages the way an LLM could. It relies on structural patterns (frequency, timing, severity) rather than understanding what the error message means in context.
This skill is provided by Claw0x, the native skills layer for AI agents.
Cloud version available: For users who need centralized analytics and cross-agent insights, a cloud version is available at claw0x.com/skills/capability-evolver.
Explore more skills: claw0x.com/skills
GitHub: github.com/kennyzir/capability-evolver
| Field | Type | Required | Description |
|---|---|---|---|
| string | yes | , , or |
| array | yes (for analyze/evolve) | Array of log entries |
| string | yes | ISO timestamp |
| string | yes | , , , or |
| string | yes | Log message |
| string | no | File or module name |
| string | no | , , , , |
| string | no | Focus analysis on a specific file |
| Field | Type | Description |
|---|---|---|
| array | Detected error/regression/inefficiency patterns with severity |
| number | System health 0�?00 |
| string[] | Actionable improvement suggestions |
| object | Counts: total_logs, error_count, warn_count, unique_patterns |
| Field | Type | Description |
|---|---|---|
| string | Unique proposal ID |
| string | Effective strategy used |
| array | Prioritized improvements with category and approach |
| object | Risk level and contributing factors |
| string | Projected health score improvement |
400 — Invalid action or missing logs array500 — Processing failedClaw0x is the native skills layer for AI agents — providing unified API access, atomic billing, and quality control.
Explore more skills: claw0x.com/skills
GitHub: github.com/kennyzir/capability-evolver
| Feature | LLM-Based (GPT-4, Claude) | Capability Evolver (Local) |
|---|---|---|
| Setup Time | 5-10 min (prompt engineering) | 30 seconds (install skill) |
| Processing Speed | 5-30 seconds | Sub-100ms |
| Reproducibility | ❌ Varies per run | ✅ Same logs = same results |
| Hallucination Risk | ⚠️ Can invent patterns | ✅ Only reports real patterns |
| Cost | $0.10-0.50 per analysis | Free (runs locally) |
| Semantic Understanding | ✅ Understands context | ❌ Pattern-based only |
| Audit Trail | ❌ Hard to explain | ✅ Rule-based, explainable |
| Privacy | ⚠️ Sends data to API | ✅ Runs entirely locally |
┌─────────────────────────────────────────────────────────────┐ │ Agent Development Lifecycle │ └─────────────────────────────────────────────────────────────┘ │ ├─ Development │ • Write agent code │ • Local testing │ ├─ Staging Deployment │ agent.run('capability-evolver', │ {action: "analyze", logs: staging_logs}) │ → Health check before production │ ├─ Production Monitoring │ agent.run('capability-evolver', │ {action: "analyze", logs: recent_logs}) │ → Real-time health tracking (every hour) │ ├─ Incident Response │ agent.run('capability-evolver', │ {action: "analyze", logs: incident_logs}) │ → Root cause analysis │ └─ Continuous Improvement agent.run('capability-evolver', {action: "evolve", strategy: "balanced"}) → Auto-generate improvement tasks (daily)
No automatic installation available. Please visit the source repository for installation instructions.
View Installation Instructions1,500+ AI skills, agents & workflows. Install in 30 seconds. Part of the Torly.ai family.
© 2026 Torly.ai. All rights reserved.