- name
- skillforge
- description
- Generate and audit OpenClaw agent skills from natural language. Use when the operator asks to create a skill, build a skill, generate a skill, audit a skill, or check skill quality. Provides both free template-based generation and Pro AI-powered generation with quality assessment. Triggers on phrases like "create a skill", "generate a skill", "build a skill", "audit a skill", "check this skill", "make a skill for", "skillforge".
SkillForge — Skill Generator & Auditor
Generate complete, publish-ready OpenClaw agent skills from natural language descriptions. Audit existing skills for quality, safety, and completeness.
Prerequisites
SkillForge CLI must be installed globally:
npm install -g @shadoprizm/skillforge@latestCheck version: skillforge --version (requires 0.3.2+)
Commands
Generate a Skill
Free tier (template scaffold, no API key):
skillforge "<description>" --output <path> --lang <typescript|javascript|python>Pro tier (AI-powered, requires API key):
skillforge "<description>" --pro --output <path> --lang <typescript|javascript|python>Audit a Skill
skillforge audit <path> --format <table|json|markdown>Pro audit with AI analysis:
skillforge audit <path> --pro --format markdownPublish to ClawHub
First-time auth:
clawhub loginThen publish:
skillforge "<description>" --output <path> --publishOr publish an existing skill:
clawhub publish <path> --slug <slug> --name "<name>" --version <semver>Workflow
When asked to create/generate a skill:
- Clarify the skill purpose if the description is vague
- Run
skillforge "<description>" --pro --output /tmp/skillforge-gen --lang typescript - Read the generated files to verify quality
- Run
skillforge audit /tmp/skillforge-gen --proto score it - If score is B+ or above, offer to publish to ClawHub
- If score is below B+, improve the SKILL.md and scripts manually, then re-audit
- On operator approval, publish:
clawhub publish /tmp/skillforge-gen --slug <slug> --name "<name>" --version 1.0.0
When asked to audit a skill:
- Run
skillforge audit <path> --pro --format markdown - Present the report to the operator
- Offer specific fixes for any issues found
- Re-audit after fixes
API Key Configuration
SkillForge Pro uses the operator's own API key (BYOK model). Supported providers:
| Env Variable | Provider |
|---|---|
ZAI_API_KEY | Z.AI (GLM-5) |
OPENAI_API_KEY | OpenAI |
OPENROUTER_API_KEY | OpenRouter |
QWEN_API_KEY | Qwen |
Keys can also be stored via: skillforge config:set-api-key <key>
Audit Categories
| Category | Weight | What It Checks |
|---|---|---|
| Structure | 20% | SKILL.md, skill.json, file organization |
| Completeness | 25% | Required sections, fields, tags |
| Quality | 25% | Description depth, workflow detail, examples |
| Safety | 20% | Dangerous patterns, hardcoded secrets |
| Compatibility | 10% | Category validity, tool references |
Constraints
- Always use
--prowhen an API key is available for best quality - WARNING: Pro mode sends skill contents to your chosen AI provider. Do not audit directories containing secrets, .env files, private keys, or credentials. Point audits only at skill directories.
- Verify generated skills actually work before publishing
- Never publish without operator approval
- Use
--format jsonfor CI/CD contexts,--format tablefor chat - Slug must be unique on ClawHub — if taken, try variations
- Never pass production API keys to untrusted skill content for auditing