# Send Skill Factory to your agent Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually. ## Fast path - Download the package from Yavira. - Extract it into a folder your agent can access. - Paste one of the prompts below and point your agent at the extracted folder. ## Suggested prompts ### New install ```text I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete. ``` ### Upgrade existing ```text I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run. ``` ## Machine-readable fields ```json { "schemaVersion": "1.0", "item": { "slug": "skill-factory", "name": "Skill Factory", "source": "tencent", "type": "skill", "category": "开发工具", "sourceUrl": "https://clawhub.ai/jeremysommerfeld8910-cpu/skill-factory", "canonicalUrl": "https://clawhub.ai/jeremysommerfeld8910-cpu/skill-factory", "targetPlatform": "OpenClaw" }, "install": { "downloadUrl": "/downloads/skill-factory", "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=skill-factory", "sourcePlatform": "tencent", "targetPlatform": "OpenClaw", "packageFormat": "ZIP package", "primaryDoc": "SKILL.md", "includedAssets": [ "SKILL.md", "_meta.json", "evals/evals.json", "evals/history.json", "evals/runs/20260222T174653.json", "references/patterns.md" ], "downloadMode": "redirect", "sourceHealth": { "source": "tencent", "slug": "skill-factory", "status": "healthy", "reason": "direct_download_ok", "recommendedAction": "download", "checkedAt": "2026-05-09T00:09:29.017Z", "expiresAt": "2026-05-16T00:09:29.017Z", "httpStatus": 200, "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=skill-factory", "contentType": "application/zip", "probeMethod": "head", "details": { "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=skill-factory", "contentDisposition": "attachment; filename=\"skill-factory-1.0.0.zip\"", "redirectLocation": null, "bodySnippet": null, "slug": "skill-factory" }, "scope": "item", "summary": "Item download looks usable.", "detail": "Yavira can redirect you to the upstream package for this item.", "primaryActionLabel": "Download for OpenClaw", "primaryActionHref": "/downloads/skill-factory" }, "validation": { "installChecklist": [ "Use the Yavira download entry.", "Review SKILL.md after the package is downloaded.", "Confirm the extracted package contains the expected setup assets." ], "postInstallChecks": [ "Confirm the extracted package includes the expected docs or setup files.", "Validate the skill or prompts are available in your target agent workspace.", "Capture any manual follow-up steps the agent could not complete." ] } }, "links": { "detailUrl": "https://openagent3.xyz/skills/skill-factory", "downloadUrl": "https://openagent3.xyz/downloads/skill-factory", "agentUrl": "https://openagent3.xyz/skills/skill-factory/agent", "manifestUrl": "https://openagent3.xyz/skills/skill-factory/agent.json", "briefUrl": "https://openagent3.xyz/skills/skill-factory/agent.md" } } ``` ## Documentation ### Skill Creator Build, refine, and publish OpenClaw skills. Supports six modes. ### Modes at a Glance ModeWhen to UseOutputCreateNew skill from scratch/SKILL.md + resourcesEvalMeasure skill qualityRun report + pass/failImproveIterate an existing skillNew version with changelogBenchmarkCompare two skill versionsWinner + delta analysisAnalyzeExtract reusable patternspatterns.md reportSynthesizeBuild skill from patternsScaffolded SKILL.md ### Mode 1: Create Build a skill from scratch in 6 steps. ### Step 1 — Understand Clarify before writing a single line: What does this skill do that no existing skill does? Who triggers it and when? (the description field drives triggering) What CLI tools, APIs, or files does it need? What's the output format? Run scripts/analyze_patterns.py --query "" to see if relevant patterns already exist. ### Step 2 — Plan Write a one-paragraph spec covering: trigger conditions, happy path, error cases, output format. Confirm with user if uncertain. ### Step 3 — Init Scripts are bundled in scripts/ — no external path needed: # From your workspace skills directory: python3 $(openclaw skills info skill-creator --json 2>/dev/null | python3 -c "import json,sys; print(json.load(sys.stdin).get('path',''))")/scripts/init_skill.py \\ \\ --path ~/.openclaw/workspace/skills/ \\ --resources scripts,references \\ --examples Or locate the skill dir and use relative path: SKILL_DIR=$(dirname $(find ~/.openclaw/workspace/skills ~/.nvm -name "init_skill.py" 2>/dev/null | head -1)) python3 "$SKILL_DIR/init_skill.py" --path ~/.openclaw/workspace/skills/ --resources scripts,references This creates: / SKILL.md # Edit this scripts/ # Helper scripts references/ # Reference docs, cheat sheets _meta.json # Auto-populated on publish ### Step 4 — Write SKILL.md Frontmatter rules: --- name: my-skill-name # lowercase-hyphen, max 64 chars description: "One sentence: what it does AND when to use it. Include trigger phrases." --- Body structure: # Skill Title Brief one-liner. ## Quick Start [Most common usage — 3-5 lines max] ## Commands / Recipes [Concrete examples with real output] ## Reference [Full option tables, edge cases, advanced usage] Progressive disclosure rules: Frontmatter: always loaded (~100 words) — make it count Body: loaded on trigger (<500 lines) — stay under limit Bundled resources: loaded on demand — put verbosity here ### Step 5 — Package # package_skill.py is bundled in this skill's scripts/ directory: SKILL_SCRIPTS="$(dirname "$(find ~/.openclaw/workspace/skills/skill-creator ~/.nvm -name "package_skill.py" 2>/dev/null | head -1)")" python3 "$SKILL_SCRIPTS/package_skill.py" ~/.openclaw/workspace/skills/ Validates structure, outputs .skill zip. ### Step 6 — Iterate Run evals (Mode 2) → identify failures → update SKILL.md → re-package → repeat. ### Mode 2: Eval Measure skill quality against defined expectations. ### Setup Create evals/evals.json: [ { "id": "basic-create", "prompt": "Create a skill that sends a Slack message", "expected_output": "SKILL.md with slack-notifier name and working command", "assertions": [ "contains SKILL.md frontmatter with name and description", "contains at least one bash command example", "description includes trigger phrases" ] } ] ### Eval Run For each eval case: Execute the prompt using current skill Grade against assertions (pass/fail per assertion) Log result to evals/runs/.json ### Run Report Format { "skill": "skill-creator", "version": "1.0.0", "timestamp": "2026-02-22T03:00:00Z", "pass_rate": 0.85, "cases": [ { "id": "basic-create", "passed": true, "assertions_passed": 3, "assertions_total": 3 } ] } ### Mode 3: Improve Iterate on an existing skill using eval feedback. ### Improvement Loop 1. Run evals → identify failing assertions 2. Read current SKILL.md 3. Draft changes targeting failures 4. Write new version (increment semver in _meta.json) 5. Re-run evals → confirm pass rate improved 6. Update history.json ### history.json Track all versions at evals/history.json: [ { "version": "1.0.0", "parent": null, "expectation_pass_rate": 0.70, "is_current_best": false, "notes": "Initial version" }, { "version": "1.1.0", "parent": "1.0.0", "expectation_pass_rate": 0.85, "is_current_best": true, "notes": "Improved trigger description, added Synthesize mode" } ] ### Mode 4: Benchmark Blind A/B comparison of two skill versions. ### Process Run identical eval suite against version A and version B Collect raw outputs without labels Compare blind (no version labels) → pick winner per case Reveal versions, compute delta Recommend: keep A, adopt B, or cherry-pick specific cases ### Benchmark Output Version A: 1.0.0 pass_rate=0.70 Version B: 1.1.0 pass_rate=0.85 Delta: +0.15 (B wins) Regressions: 0 Recommendation: Adopt B ### Mode 5: Analyze Patterns Scan installed skills to extract reusable building blocks. python3 ~/.openclaw/workspace/skills/skill-creator/scripts/analyze_patterns.py \\ --scan-dirs ~/.openclaw/workspace/skills/,~/.nvm/versions/node/v22.22.0/lib/node_modules/openclaw/skills/ \\ --output ~/.openclaw/workspace/skills/skill-creator/references/patterns.md What it extracts: Trigger phrases — common description keywords that activate skills Tool patterns — CLI tools, APIs, Docker patterns used across skills Output formats — JSON schemas, markdown templates, log formats Structural patterns — how skills organize commands/recipes Error handling patterns — retry logic, circuit breakers, fallbacks See references/patterns.md for the current extracted pattern library. ### Mode 6: Synthesize from Patterns Build a new skill scaffold by combining patterns from the library. ### Usage When asked to create a skill in a domain that resembles existing skills: Run Analyze Patterns first Query references/patterns.md for relevant patterns Compose a SKILL.md that combines: Best trigger phrases from similar skills Relevant tool/API patterns Appropriate output format Error handling from most robust similar skill ### Example "Create a skill for Twitter scraping": Pull trigger phrases from reddit-scraper Pull CDP/browser patterns from fast-browser-use Pull output format (JSON array) from crypto-market-data Synthesize into twitter-scraper/SKILL.md ### Skill Anatomy Quick Reference / SKILL.md # Required: frontmatter + body scripts/ # Helper Python/bash scripts references/ # Cheat sheets, API docs, schemas assets/ # Images, templates evals/ evals.json # Test cases runs/ # Eval run results history.json # Version history _meta.json # Publishing metadata _meta.json template: { "ownerId": "", "slug": "skill-name", "version": "1.0.0", "publishedAt": null } ### Publishing to OpenClaw Community Registry: clawhub.com — use the clawhub CLI (already installed). # 1. Login (opens browser once) clawhub login # 2. Publish directly from skill folder — no .skill zip needed clawhub publish ~/.openclaw/workspace/skills/ \\ --version 1.0.0 \\ --changelog "Initial release" # 3. Or sync all workspace skills at once: clawhub sync --workdir ~/.openclaw/workspace --dir skills Ensure _meta.json has correct slug and version Run full eval suite — pass rate must be ≥ 0.80 clawhub login (one-time browser auth) clawhub publish Verify at clawhub.com/skills/ Quality bar for publishing: Description triggers correctly (test with 3+ natural phrasings) At least 3 concrete command examples with real output Error cases documented Eval pass rate ≥ 0.80 _meta.json complete ## Trust - Source: tencent - Verification: Indexed source record - Publisher: jeremysommerfeld8910-cpu - Version: 1.0.0 ## Source health - Status: healthy - Item download looks usable. - Yavira can redirect you to the upstream package for this item. - Health scope: item - Reason: direct_download_ok - Checked at: 2026-05-09T00:09:29.017Z - Expires at: 2026-05-16T00:09:29.017Z - Recommended action: Download for OpenClaw ## Links - [Detail page](https://openagent3.xyz/skills/skill-factory) - [Send to Agent page](https://openagent3.xyz/skills/skill-factory/agent) - [JSON manifest](https://openagent3.xyz/skills/skill-factory/agent.json) - [Markdown brief](https://openagent3.xyz/skills/skill-factory/agent.md) - [Download page](https://openagent3.xyz/downloads/skill-factory)