Promote Skill for Openclaw

A specialized agent skill designed to automate the validation, sanitization, and multi-platform publication of SKILL.md-style agent skills.

ralyodio
v1.0.0
Apr 30, 2026
0
607
0

Install & Download

1. ClawHub CLI

The fastest way to install a skill directly from the registry.

npx clawhub@latest install promote-skill

2. Manual Installation

Copy the skill folder to one of these locations

Global
~/.openclaw/skills/
Workspace
<project>/skills/

Priority: Workspace > Local > Bundled

3. Prompt Installation

Copy this prompt to OpenClaw to install it automatically.

Help me install promote-skill using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).

Prefer to download?

Get the raw skill files in a ZIP archive.

What is Promote Skill?

Promote Skill is an essential utility for developers looking to share their agent capabilities with the broader ecosystem. It provides a standardized workflow for turning a local SKILL.md file into a public marketplace listing, ensuring that all Openclaw Skills are properly formatted, secure, and ready for distribution. The skill orchestrates the entire lifecycle of promotion, from initial secret scanning to generating deployment commands for various agent platforms.

By leveraging this skill, developers can maintain a single source of truth for their agent logic while reaching multiple audiences. It integrates with popular tools like uGig and sh1pt to provide a centralized checklist for publishing across diverse environments, including GitHub, ClawHub, Goose, and VS Code Agent Skills. This ensures that your Openclaw Skills are discoverable and easy to install for users across different AI coding environments.

Promote Skill Use Cases

  • Publishing a newly developed agent skill to multiple public marketplaces like uGig or ClawHub simultaneously.
  • Sanitizing local SKILL.md files to ensure no private credentials or API keys are leaked during public distribution.
  • Generating a structured promotion manifest for Openclaw Skills to track availability across different platforms.
  • Automating the creation of GitHub repositories or Gists to host the raw source for skill auto-indexers.

How Promote Skill Works

  1. The agent validates the source SKILL.md file and performs a secrets scan to ensure the content is safe for public consumption.
  2. A public source URL is established, typically by creating a GitHub repository or a public Gist.
  3. The skill is first published to uGig, which serves as a central hub for scanning and generating a broader promotion checklist.
  4. Using sh1pt integration, a cross-marketplace command manifest is generated to handle distribution to platforms like Goose, Kilo, and LobeHub.
  5. The user or agent follows the generated checklist to complete platform-specific registrations, PRs, or API-based uploads.

Promote Skill Setup

To get started with promoting your Openclaw Skills, ensure you have the necessary CLIs installed for your target marketplaces:

# Install the uGig CLI for initial publishing
npm install -g @ugig/cli

# Initialize a promotion manifest with sh1pt
sh1pt skills new --skill-file ./SKILL.md --source-url "[YOUR_PUBLIC_RAW_URL]" --price 0

# Run a dry-run to see all required marketplace steps
sh1pt skills publish --all --dry-run

Promote Skill Data Schema & Taxonomy

The skill processes data using the following metadata taxonomy and file structures:

Attribute Description Location
name Display name of the skill SKILL.md Frontmatter
description Detailed value proposition SKILL.md Frontmatter
source-url Raw public URL for the SKILL.md file uGig / sh1pt.json
price Listing price in sats (0 for free) uGig / sh1pt.json
tags Categorization keywords for discovery SKILL.md Metadata
secret_scan Results of regex-based security audit CLI Output

Promote Skill Advanced Features

  • Integrated secrets scanning using regex patterns to detect accidental exposure of API keys, tokens, or private keys.
  • Automatic generation of sh1pt.skill.json manifests for complex, multi-agent orchestrations.
  • Support for dry-run modes that allow developers to verify marketplace commands before execution.
  • Cross-platform compatibility for Openclaw Skills across various agent-host environments like Hermes, Windsurf, and Claude Code.
  • Automated mapping of local file structures to marketplace-specific submission formats.

SKILL.md


Loading

Related Openclaw Skills

METADATA

Github Stars: 0
forks: 0

Featured*