Install Global Skill From ClawHub#

Install or update one ClawHub skill with the official CLI, then promote the staged copy into the global skill directory.

Rules#

• Treat <openclaw-home>/skills/<slug> as the final destination.
• Treat <openclaw-home>/workspaces/<agent>/skills/<slug> as a temporary staging location used by the CLI.
• Resolve <openclaw-home> from --openclaw-home, then OPENCLAW_HOME, else $HOME/.openclaw.
• Resolve <agent> from --agent, then OPENCLAW_AGENT, else lan.
• Derive the workspace as <openclaw-home>/workspaces/<agent>.
• Prefer scripts/install-global-skill.js over manual file operations.
• Try openclaw skills update first; if the skill is not tracked, use openclaw skills install --force.
• Backup an existing global skill before replacement unless the user explicitly says otherwise.
• Promote through a temporary directory, then rename into place.
• Remove the staged copy after promotion unless the user wants to keep it.
• For destructive actions such as deleting an existing global skill or staging copy, ask for confirmation unless the user already asked for replacement or upgrade.
• Do not modify or create Agents. This skill only manages skill files.
• Keep the workflow focused on one slug at a time unless the user explicitly asks for a batch.

Workflow#

1. Confirm the target skill slug.
2. Prefer running node scripts/install-global-skill.js --slug <slug>.
3. Verify the staged origin file at <openclaw-home>/workspaces/<agent>/skills/<slug>/.clawhub/origin.json.
4. Backup the current global directory when it exists.
5. Promote the staged copy into <openclaw-home>/skills/<slug>.
6. Verify the global origin file and installed version after promotion.
7. Report the result.

Verification#

• <openclaw-home>/skills/<slug>/SKILL.md exists
• <openclaw-home>/skills/<slug>/.clawhub/origin.json exists
• installedVersion in the global copy matches the staged copy

Delivery#

• target slug
• final global path
• installed version
• whether update or install was used
• backup path if one was created
• whether the staging copy was removed
• any blocker, such as CLI failure or missing ClawHub package