# Send Skillcraft 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": "skillcraft",
    "name": "Skillcraft",
    "source": "tencent",
    "type": "skill",
    "category": "通讯协作",
    "sourceUrl": "https://clawhub.ai/jmz1/skillcraft",
    "canonicalUrl": "https://clawhub.ai/jmz1/skillcraft",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/skillcraft",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=skillcraft",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "SKILL.md",
      "patterns/api-wrapper.md",
      "patterns/cli-wrapper.md",
      "patterns/composable-examples.md",
      "patterns/monitor.md"
    ],
    "downloadMode": "redirect",
    "sourceHealth": {
      "source": "tencent",
      "slug": "skillcraft",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-05-01T08:43:34.246Z",
      "expiresAt": "2026-05-08T08:43:34.246Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=skillcraft",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=skillcraft",
        "contentDisposition": "attachment; filename=\"skillcraft-1.0.0.zip\"",
        "redirectLocation": null,
        "bodySnippet": null,
        "slug": "skillcraft"
      },
      "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/skillcraft"
    },
    "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/skillcraft",
    "downloadUrl": "https://openagent3.xyz/downloads/skillcraft",
    "agentUrl": "https://openagent3.xyz/skills/skillcraft/agent",
    "manifestUrl": "https://openagent3.xyz/skills/skillcraft/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/skillcraft/agent.md"
  }
}
```
## Documentation

### Skillcraft — OpenClaw Skill Designer

An opinionated guide for creating OpenClaw skills. Focuses on OpenClaw-specific integration — message routing, cron scheduling, memory persistence, channel formatting, frontmatter gating — not generic programming advice.

Docs: https://docs.openclaw.ai/tools/skills · https://docs.openclaw.ai/tools/creating-skills

### Model Notes

This skill is written for frontier-class models (Opus, Sonnet). If you're running a cheaper model and find a stage underspecified, expand it yourself — the design sequence is a scaffold, not a script. Cheaper models should:

Read the pattern files in {baseDir}/patterns/ more carefully before architecting
Spend more time on Stage 2 (capability discovery) — enumerate OpenClaw features explicitly
Be more methodical in Stage 4 (spec) — write out the full structure before implementing
Consult https://docs.openclaw.ai when unsure about any OpenClaw feature

### Stage 0: Inventory (Extraction Only)

Skip if building from scratch. Use when packaging existing functionality (scripts, TOOLS.md sections, conversation patterns, repeated instructions) into a skill.

Gather what exists, where it lives, what works, what's fragile. Then proceed to Stage 1.

### Stage 1: Problem Understanding

Work through with the user:

What does this skill do? (one sentence)
When should it load? Example phrases, mid-task triggers, scheduled triggers
What does success look like? Concrete outcomes per example

### Stage 2: Capability Discovery

Generalisability

Ask early: Is this for your setup, or should it work on any OpenClaw instance?

ChoiceImplicationsUniversalGeneric paths, no local assumptions, ClawHub-readyParticularCan reference local skills, tools, workspace config

Skill Synergy (Particular Only)

Scan <available_skills> from the system prompt for complementary capabilities. Read promising skills to understand composition opportunities.

OpenClaw Features

Review the docs with the skill's needs in mind. Think compositionally — OpenClaw's primitives combine in powerful ways. Key docs to check:

NeedDocMessages/concepts/messagesCron/scheduling/automation/cron-jobsSubagents/tools/subagentsBrowser/tools/browserCanvas UI/tools/ (canvas)Node devices/nodes/Slash commands/tools/slash-commands

See {baseDir}/patterns/composable-examples.md for inspiration on combining these.

### Stage 3: Architecture

Based on Stages 1–2, identify which patterns apply:

If the skill...PatternWraps a CLI tool{baseDir}/patterns/cli-wrapper.mdWraps a web API{baseDir}/patterns/api-wrapper.mdMonitors and notifies{baseDir}/patterns/monitor.md

Load all that apply and synthesise. Most skills combine patterns.

Script vs. instructions split: Scripts handle deterministic mechanics (API calls, data gathering, file processing). SKILL.md instructions handle judgment (interpreting results, choosing approaches, composing output). The boundary is: could a less intelligent system do this reliably? If yes → script.

### Stage 4: Design Specification

Present proposed architecture for user review:

Skill structure — files and directories
SKILL.md outline — sections and key content
Components — scripts, modules, wrappers
State — stateless, session-stateful, or persistent (and where it lives)
OpenClaw integration — which features, how they interact
Secrets — env vars, keychain, config file (document in setup section, never hardcode)

State locations:

<workspace>/memory/ — user-facing context
{baseDir}/state.json — skill-internal state (travels with skill)
<workspace>/state/<skill>.json — skill state in common workspace area

If extracting: include migration notes (what moves, what workspace files need updating).

Validate: Does it handle all Stage 1 examples? Any contradictions? Edge cases?

Iterate until the user is satisfied. This is where design problems surface cheaply.

### Stage 5: Implementation

Default: same-session. Work through the spec with user review at each step. Reserve subagent handoff for complex script subcomponents only — SKILL.md and integration logic stay in the main session.

Create skill directory + SKILL.md skeleton (frontmatter + sections)
Scripts (if any) — get them working and tested
SKILL.md body — complete instructions
Test against Stage 1 examples

If extracting: update workspace files, clean up old locations, verify standalone operation.

### Crafting the Frontmatter

The frontmatter determines discoverability and gating. Format follows the AgentSkills spec with OpenClaw extensions.

---
name: my-skill
description: [description optimised for discovery — see below]
homepage: https://github.com/user/repo  # optional
metadata: {"openclaw":{"emoji":"🔧","requires":{"bins":["tool"],"env":["API_KEY"]},"primaryEnv":"API_KEY","install":[...]}}
---

Critical: metadata must be a single-line JSON object (parser limitation).

### Description — Write for Discovery

The description determines whether the skill gets loaded. Include:

Core capability — what it does
Trigger keywords — terms users would say
Contexts — situations where it applies

Test: would the agent select this skill for each of your Stage 1 example phrases?

### Frontmatter Keys

KeyPurposenameSkill identifier (required)descriptionDiscovery text (required)homepageURL for docs/repouser-invocabletrue/false — expose as slash command (default: true)disable-model-invocationtrue/false — exclude from model prompt (default: false)command-dispatchtool — bypass model, dispatch directly to a toolcommand-toolTool name for direct dispatchcommand-arg-moderaw — forward raw args to tool

### Metadata Gating

OpenClaw filters skills at load time using metadata.openclaw:

FieldEffectalways: trueSkip all gates, always loademojiDisplay in macOS Skills UIosPlatform filter (darwin, linux, win32)requires.binsAll must exist on PATHrequires.anyBinsAt least one must existrequires.envEnv var must exist or be in configrequires.configConfig paths must be truthyprimaryEnvMaps to skills.entries.<name>.apiKeyinstallInstaller specs for auto-setup (brew/node/go/uv/download)

Sandbox note: requires.bins checks the host at load time. If sandboxed, the binary must also exist inside the container.

### Token Budget

Each eligible skill adds ~97 chars + name + description + location path to the system prompt. Keep descriptions informative but not bloated — every character costs tokens on every turn.

### Install Specs

"install": [
  {"id": "brew", "kind": "brew", "formula": "tap/tool", "bins": ["tool"], "label": "Install via brew"},
  {"id": "npm", "kind": "node", "package": "tool", "bins": ["tool"]},
  {"id": "uv", "kind": "uv", "package": "tool", "bins": ["tool"]},
  {"id": "go", "kind": "go", "package": "github.com/user/tool@latest", "bins": ["tool"]},
  {"id": "dl", "kind": "download", "url": "https://...", "archive": "tar.gz"}
]

### Path Conventions

TokenMeaning{baseDir}This skill's directory (OpenClaw resolves at runtime)<workspace>/Agent's workspace root

Use {baseDir} for skill-internal references (scripts, state, patterns)
Use <workspace>/ for workspace files (TOOLS.md, memory/, etc.)
Never hardcode absolute paths — workspaces are portable
For subagent scenarios, include path context in the task description (sandbox mounts differ)

### References

Pattern files: {baseDir}/patterns/ (cli-wrapper, api-wrapper, monitor, composable-examples)
OpenClaw docs: https://docs.openclaw.ai/tools/skills
ClawHub: https://clawhub.com
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: jmz1
- 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-01T08:43:34.246Z
- Expires at: 2026-05-08T08:43:34.246Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/skillcraft)
- [Send to Agent page](https://openagent3.xyz/skills/skillcraft/agent)
- [JSON manifest](https://openagent3.xyz/skills/skillcraft/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/skillcraft/agent.md)
- [Download page](https://openagent3.xyz/downloads/skillcraft)