# Send Publisher 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. Then review README.md for any prerequisites, environment setup, or post-install checks. 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. Then review README.md for any prerequisites, environment setup, or post-install checks. Summarize what changed and any follow-up checks I should run.
```
## Machine-readable fields
```json
{
  "schemaVersion": "1.0",
  "item": {
    "slug": "publisher",
    "name": "Publisher",
    "source": "tencent",
    "type": "skill",
    "category": "开发工具",
    "sourceUrl": "https://clawhub.ai/TunaIssaCoding/publisher",
    "canonicalUrl": "https://clawhub.ai/TunaIssaCoding/publisher",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/publisher",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=publisher",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "README.md",
      "SKILL.md",
      "scripts/publish.sh"
    ],
    "downloadMode": "redirect",
    "sourceHealth": {
      "source": "tencent",
      "slug": "publisher",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-05-07T14:25:00.543Z",
      "expiresAt": "2026-05-14T14:25:00.543Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=publisher",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=publisher",
        "contentDisposition": "attachment; filename=\"publisher-1.0.6.zip\"",
        "redirectLocation": null,
        "bodySnippet": null,
        "slug": "publisher"
      },
      "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/publisher"
    },
    "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/publisher",
    "downloadUrl": "https://openagent3.xyz/downloads/publisher",
    "agentUrl": "https://openagent3.xyz/skills/publisher/agent",
    "manifestUrl": "https://openagent3.xyz/skills/publisher/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/publisher/agent.md"
  }
}
```
## Documentation

### publisher

Professional documentation and publishing for Clawdbot skills

Generate adoption-optimized READMEs and publish to GitHub + ClawdHub with one command.

### ⚠️ Requirements

bash
jq (for JSON parsing)
gh CLI (GitHub operations)
clawdhub CLI (publishing)
git

### 📋 What It Does

Automates the complete publishing workflow:

### Documentation Generation

Reads your SKILL.md to understand what the skill does
Generates 3 one-liner options using proven patterns
Creates a README following GitHub best practices:

Problem/solution upfront
Inverted pyramid structure
Emoji headers for scannability
Bold outcomes
Under 15% text highlighting


Updates SKILL.md frontmatter with chosen description

### Publishing

Creates GitHub repository (if doesn't exist)
Pushes code to GitHub
Publishes to ClawdHub with auto-detected version

### 🚀 Installation

clawdhub install skill-publisher

### 💡 Usage

cd ~/clawd/skills/your-skill
skill-publisher

The script will:

Show 3 one-liner options (choose or write your own)
Generate README preview
Ask for approval
Publish to GitHub + ClawdHub

### 🎯 One-Liner Generation Patterns

The tool generates options using three proven patterns:

### Pattern A: Continuous Benefit

Keep [thing] [desired state] [timeframe]

Example: "Keep your Claude access token fresh 24/7"

### Pattern B: Elimination

[Do thing] without [pain point]

Example: "Build cross-device tools without hardcoding paths"

### Pattern C: Automation

Automatically [action] [thing] [when]

Example: "Automatically refresh tokens before they expire"

### 📚 README Structure Generated

Follows the framework from GitHub's documentation best practices:

### Essential Sections (above the fold)

Title + subtitle
The problem: (1 sentence)
This tool: (1 sentence)
📋 Requirements
⚡ What It Does (outcome first, then features)
🚀 Installation
🔧 How It Works (result first, then process)

### Optional Sections (collapsible)

Configuration options
Troubleshooting
For Developers
Implementation details

### Phase 1: Analysis

Reads SKILL.md frontmatter (if exists)
Extracts key information: name, description, requirements
Parses scripts for dependencies

### Phase 2: One-Liner Generation

Analyzes your SKILL.md description and generates 3 options:

Pattern A: Continuous benefit format
Pattern B: Pain point elimination format
Pattern C: Automation format

Shows you all 3, lets you choose or write custom.

### Phase 3: README Generation

Uses the template from ~/clawd/templates/README-template.md:

Fills in title, problem, solution
Extracts requirements from SKILL.md
Generates "What It Does" from description
Creates installation steps
Builds "How It Works" with examples

### Phase 4: Publishing

Checks for gh CLI (guides setup if missing)
Reads VERSION file for version number
Creates GitHub repo (using gh repo create)
Commits and pushes all files
Publishes to ClawdHub with clawdhub publish

### 📁 File Structure Expected

your-skill/
├── SKILL.md           # Required: skill description
├── VERSION            # Required: version number (e.g., "1.0.0")
├── scripts/           # Optional: your scripts
│   └── main.sh
├── README.md          # Generated by this tool
└── .gitignore         # Optional

### ⚙️ Configuration

No configuration needed. The tool auto-detects everything from:

SKILL.md (name, description, requirements)
VERSION (version number)
scripts/ (code examples, dependencies)

### "gh: command not found"

Install GitHub CLI:

brew install gh
gh auth login

### "SKILL.md not found"

Create a minimal SKILL.md:

---
name: your-skill
description: Brief description of what it does
---

# your-skill

More details about your skill here.

### "VERSION file not found"

Create a VERSION file:

echo "1.0.0" > VERSION

### 📖 References

GitHub documentation best practices: https://docs.github.com/en/contributing/writing-for-github-docs/best-practices-for-github-docs
README template: ~/clawd/templates/README-template.md
One-liner formulas: See "One-Liner Generation Patterns" section above

### License

MIT
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: TunaIssaCoding
- Version: 1.0.6
## 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-07T14:25:00.543Z
- Expires at: 2026-05-14T14:25:00.543Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/publisher)
- [Send to Agent page](https://openagent3.xyz/skills/publisher/agent)
- [JSON manifest](https://openagent3.xyz/skills/publisher/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/publisher/agent.md)
- [Download page](https://openagent3.xyz/downloads/publisher)