- name
- skill-factory
- description
- Build and publish OpenClaw skills from recurring pain points. Scans .learnings/ for errors that hit 3+ recurrences, scaffolds skills from them, and publishes to ClawHub. Use when: (1) you want to create a new skill from a pain point, (2) you want to check if any recurring errors are ready for extraction, (3) you want to package and publish a skill in one step, (4) you want to automate the pain-to-skill pipeline. The thing that builds the thing.
Skill Factory
Turn recurring pain points into published skills. Automatically.
Why This Exists
Building skills manually takes 30 minutes: write SKILL.md, write the script, test, package, publish. The factory cuts this to 10 minutes by structuring the workflow and automating the boring parts.
More importantly: it connects to your .learnings/ error log. When a problem recurs 3+ times, the factory flags it as a skill candidate. Your mistakes become products.
Prerequisites
.learnings/ERRORS.mdand/or.learnings/LEARNINGS.mdin your workspace (seeself-improving-agentskill or create manually)- ClawHub CLI authenticated (
npx clawhub@latest login) - Python 3 (for packaging via skill-creator)
Commands
Scan for skill candidates
node scripts/factory.js scanReads .learnings/ and finds entries with 3+ recurrences and a known fix. These are ready for extraction into skills.
Build from a pain point description
node scripts/factory.js build "agents keep double-replying to the same post"Creates a skill scaffold at skills/public/<slug>/ with a .factory-prompt.md describing what to build. Then you (the LLM) write the SKILL.md and script.
Build from a .learnings/ entry
node scripts/factory.js from-error ERR-20260316-001Same as build, but pulls the description and fix from an existing error entry.
Publish
node scripts/factory.js publish skills/public/my-skillPackages and publishes to ClawHub in one step. Cleans up factory files first.
The Pipeline
Mistake → .learnings/ERRORS.md → scan (3+ recurrences) → from-error → write skill → publishLearnings Format
The factory expects entries in this format:
## [ERR-20260316-001] Short description
**Recurrences:** 3 | **Last:** 2026-03-16
**What failed:** what went wrong
**Fix:** what actually solved itOr for learnings:
## [LRN-20260316-001] Short description
**Category:** best_practice
**Recurrences:** 3 | **Last:** 2026-03-16
**What happened:** context
**The lesson:** what's correctIntegrating With Heartbeats
Add to your heartbeat config to surface new candidates:
collectors:
- name: skill-candidates
command: "node tools/skill-factory/factory.js scan --count"
format: text
alert: "> 0"
summary: "{{output}} skill candidates ready for extraction"CLI Reference
node scripts/factory.js <command>
scan Find extractable patterns in .learnings/
scan --count Just print the count (for heartbeat integration)
build "description" Scaffold a skill from a pain point
from-error <id> Scaffold from a .learnings/ entry
publish <dir> Package + publish to ClawHub