# Send ClawHub Skill Guide — Scanner Compliance 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": "clawhub-skill-guide", "name": "ClawHub Skill Guide — Scanner Compliance", "source": "tencent", "type": "skill", "category": "安全合规", "sourceUrl": "https://clawhub.ai/tdavis009/clawhub-skill-guide", "canonicalUrl": "https://clawhub.ai/tdavis009/clawhub-skill-guide", "targetPlatform": "OpenClaw" }, "install": { "downloadUrl": "/downloads/clawhub-skill-guide", "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=clawhub-skill-guide", "sourcePlatform": "tencent", "targetPlatform": "OpenClaw", "packageFormat": "ZIP package", "primaryDoc": "SKILL.md", "includedAssets": [ "SKILL.md", "assets/templates/basic-skill.md", "assets/templates/skill-with-config.md", "assets/templates/skill-with-scripts.md", "references/frontmatter-schema.md", "references/publish-workflow.md" ], "downloadMode": "redirect", "sourceHealth": { "source": "tencent", "slug": "clawhub-skill-guide", "status": "healthy", "reason": "direct_download_ok", "recommendedAction": "download", "checkedAt": "2026-04-29T03:12:21.238Z", "expiresAt": "2026-05-06T03:12:21.238Z", "httpStatus": 200, "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=clawhub-skill-guide", "contentType": "application/zip", "probeMethod": "head", "details": { "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=clawhub-skill-guide", "contentDisposition": "attachment; filename=\"clawhub-skill-guide-1.0.0.zip\"", "redirectLocation": null, "bodySnippet": null, "slug": "clawhub-skill-guide" }, "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/clawhub-skill-guide" }, "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/clawhub-skill-guide", "downloadUrl": "https://openagent3.xyz/downloads/clawhub-skill-guide", "agentUrl": "https://openagent3.xyz/skills/clawhub-skill-guide/agent", "manifestUrl": "https://openagent3.xyz/skills/clawhub-skill-guide/agent.json", "briefUrl": "https://openagent3.xyz/skills/clawhub-skill-guide/agent.md" } } ``` ## Documentation ### ClawHub Skill Guide Publish OpenClaw skills to ClawHub with clean security scanner ratings. This guide supplements the built-in skill-creator skill with ClawHub-specific publishing knowledge — especially frontmatter schema and scanner compliance. Note: The built-in skill-creator says "Do not include any other fields in YAML frontmatter." That guidance is outdated. ClawHub supports and the scanner requires additional fields like env, metadata, requires, etc. This guide documents the complete frontmatter schema. ### Skill Anatomy my-skill/ ├── SKILL.md # Core instructions (required, under 500 lines) ├── scripts/ # Executable code (optional) ├── references/ # Docs loaded on demand (optional) └── assets/ # Templates, images, non-context files (optional) ### Frontmatter Fields FieldRequiredPurposename✅Lowercase, hyphens, under 64 charsdescription✅Trigger text with keywordsenvWhen credentials neededArray of env var declarationsmetadataAlternative env formatOpenClaw-specific metadatarequiresWhen dependencies existHuman-readable requirement listhomepageOptionalSource/docs URLcategoryOptionalSkill categoryemojiOptionalDisplay emojiversionOptionalSemver (can also set via CLI) → Full schema: references/frontmatter-schema.md ### Scanner Categories #CategoryKey Requirement1PURPOSE & CAPABILITYDescription matches functionality; credentials declared2INSTRUCTION SCOPEInstructions on-topic; no auto-config language3INSTALL MECHANISMNo external downloads; scripts write within workspace4CREDENTIALSAll env vars declared in frontmatter; sensitive marked5PERSISTENCE & PRIVILEGENo always:true; config as templates for manual review → Deep dive: references/scanner-compliance.md ### Step 1: Plan Structure Decide what goes where: Content TypeLocationCore workflow, key instructionsSKILL.md bodyDetailed reference materialreferences/Executable automationscripts/Templates, images, boilerplateassets/ Keep SKILL.md under 500 lines. Move detailed docs to references. ### Step 2: Write Frontmatter This is where most scanner issues originate. Get frontmatter right first. Important: The local packager (package_skill.py) only allows these top-level frontmatter keys: name, description, license, metadata, allowed-tools. The env: key works on ClawHub's registry but fails local validation. Use the metadata.openclaw format for compatibility with both. Minimal frontmatter (no credentials needed): --- name: my-skill description: > What this skill does. Include trigger keywords so the agent knows when to activate it. Use when: scenario1, scenario2. --- With credentials (packager-compatible format): --- name: my-api-skill description: > Integrates with Example API for data retrieval and analysis. Use when: querying example data, generating reports from Example API. metadata: openclaw: requires: env: - EXAMPLE_API_KEY bins: - curl primaryEnv: EXAMPLE_API_KEY env: - name: EXAMPLE_API_KEY description: "API key for Example service" required: true - name: EXAMPLE_BASE_URL description: "Base URL for Example API (default: https://api.example.com)" required: false --- Note: If you skip the local packager and publish directly with npx clawhub publish, the direct env: top-level array also works (some published skills use this). But the metadata.openclaw format works everywhere. → All supported fields and formats: references/frontmatter-schema.md ### Step 3: Write Body Structure the body for progressive disclosure: Quick Start — Minimal steps to use the skill Prerequisites — Table of requirements (if any) Security Notes — Script safety, credential handling (if applicable) How It Works — Core instructions File Reference — List bundled resources with descriptions Keep instructions imperative. Challenge every paragraph: "Does the agent really need this?" ### Step 4: Add Scripts (If Needed) Follow safe patterns to pass the scanner: Only write within the skill workspace No network calls unless explicitly declared and justified No obfuscated code Document line count and purpose in SKILL.md Include "inspect before running" warning → Full patterns: references/script-safety.md ### Step 5: Validate and Package # Validate structure python3 ~/.npm-global/lib/node_modules/openclaw/skills/skill-creator/scripts/package_skill.py ./my-skill # Check manually: # - Frontmatter has name + description # - env declarations match actual credential usage # - No personal data or test artifacts # - SKILL.md under 500 lines ### Step 6: Publish and Check Scanner # Verify auth npx clawhub whoami # Publish npx clawhub publish ./my-skill \\ --slug my-skill \\ --name "My Skill" \\ --version 1.0.0 \\ --changelog "Initial release" \\ --tags latest # Check scanner results npx clawhub inspect my-skill → Full workflow: references/publish-workflow.md ### The Three Env Declaration Formats ClawHub supports three ways to declare environment variables. All are valid; the metadata.openclaw format is recommended for compatibility with both the local packager and the ClawHub scanner. Format 1 — Direct env: array (richest data, but fails local packager): env: - name: MY_API_KEY description: "API key for the service" required: true sensitive: true Works with npx clawhub publish but NOT with package_skill.py validation. Format 2 — metadata.openclaw.env (recommended — works everywhere): metadata: openclaw: env: - name: MY_API_KEY description: "API key for the service" required: false Format 3 — metadata.openclaw.requires: metadata: openclaw: requires: env: - MY_API_KEY bins: - curl primaryEnv: MY_API_KEY Format 1 gives the scanner the most information (including sensitive flag) and produces the cleanest scan results. ### Description Best Practices The description is the primary trigger mechanism. Include: What the skill does (concrete actions) Keywords matching user queries "Use when:" clause listing activation scenarios Bad: "Helps with APIs." Good: description: > Query and manage Example API resources including users, projects, and billing data. Generates reports, monitors usage, and handles authentication. Use when: querying Example API, generating usage reports, managing API resources, checking billing status. ### 1. PURPOSE & CAPABILITY ✓ Description accurately reflects what the skill does All credentials declared in frontmatter env or metadata No undeclared external service dependencies ### 2. INSTRUCTION SCOPE ✓ Instructions stay on-topic for the skill's stated purpose No language about automatically applying config changes Privileged operations marked as "requires manual review" If using requireMention:false, document data exposure implications ### 3. INSTALL MECHANISM ✓ No curl, wget, or network downloads in scripts Scripts only write within the skill workspace directory Include "inspect before running" notes for all scripts No obfuscated or minified executable code ### 4. CREDENTIALS ✓ Every env var the skill uses is declared in frontmatter Sensitive credentials marked sensitive: true No requests for credentials unrelated to the skill's purpose Prerequisites table lists all required accounts/keys ### 5. PERSISTENCE & PRIVILEGE ✓ No always:true in config recommendations Config changes presented as templates for manual review Multi-user skills recommend agent isolation (separate OpenClaw agent) No persistent background processes or daemons → Deep dive with case study: references/scanner-compliance.md ### Command Reference # Publish a skill npx clawhub publish ./skill-dir \\ --slug my-skill \\ --name "Display Name" \\ --version 1.0.0 \\ --changelog "What changed" \\ --tags latest # Inspect published skill npx clawhub inspect my-skill npx clawhub inspect my-skill --files npx clawhub inspect my-skill --file SKILL.md # Browse and search npx clawhub explore npx clawhub search "keyword" # Auth npx clawhub whoami ### Version Bumping When fixing scanner warnings, bump the version and republish: npx clawhub publish ./skill-dir \\ --slug my-skill \\ --version 1.1.0 \\ --changelog "Fix: declared env vars in frontmatter for clean scan" \\ --tags latest ### Common Pitfalls MistakeScanner ImpactFixNo env declarations when skill uses credentials! CREDENTIALSAdd env vars via metadata.openclaw.env in frontmatter"Agent automatically applies config" language! INSTRUCTION SCOPEChange to "manual review required"Scripts without inspection warningℹ INSTALL MECHANISMAdd "inspect before running" noteNo agent isolation for multi-user skillsℹ PERSISTENCEAdd security model sectionrequireMention:false without data exposure docsℹ INSTRUCTION SCOPEDocument what data the skill seesDescription too short / missing keywordsPoor discoverabilityExpand with trigger scenariosShipping test DBs or generated filesBloatClean before publishingPersonal data in examplesPrivacy riskUse generic examples ### Templates Ready-to-use SKILL.md templates: Basic skill — Minimal SKILL.md Skill with scripts — Scripts + env vars Skill with config — Gateway config changes Copy, fill in the placeholders, publish. ### File Reference FilePurposereferences/frontmatter-schema.mdComplete YAML frontmatter field documentationreferences/scanner-compliance.mdScanner categories deep dive with case studyreferences/script-safety.mdSafe script patterns for publicationreferences/publish-workflow.mdStep-by-step publish and iterate workflowassets/templates/basic-skill.mdMinimal SKILL.md templateassets/templates/skill-with-scripts.mdTemplate with scripts and env varsassets/templates/skill-with-config.mdTemplate for config-changing skills ## Trust - Source: tencent - Verification: Indexed source record - Publisher: tdavis009 - 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-04-29T03:12:21.238Z - Expires at: 2026-05-06T03:12:21.238Z - Recommended action: Download for OpenClaw ## Links - [Detail page](https://openagent3.xyz/skills/clawhub-skill-guide) - [Send to Agent page](https://openagent3.xyz/skills/clawhub-skill-guide/agent) - [JSON manifest](https://openagent3.xyz/skills/clawhub-skill-guide/agent.json) - [Markdown brief](https://openagent3.xyz/skills/clawhub-skill-guide/agent.md) - [Download page](https://openagent3.xyz/downloads/clawhub-skill-guide)