mediar-ai/publish-skill

Publish Skill

Publishes a Claude Code skill to both marketplaces:

1. skillhu.bz — via npx skillhu publish (instant, no auth)
2. skills.sh — via GitHub repo + npx skills add (telemetry-based leaderboard)

When to Use

• After creating a new skill with skill-creator
• After significantly updating an existing skill
• When the user says "publish skill" or "share skill"

Prerequisites

• The skill must have a SKILL.md file
• npx skillhu and npx skills CLIs available
• gh CLI authenticated for GitHub repo creation

Workflow

Step 1: Prepare the skill content

1. Create a temp directory: mkdir -p /tmp/skill-publish
2. Copy the SKILL.md content, making it generic:
   • Remove user-specific paths (e.g., /Users/username/...)
   • Remove personal data (credentials, API keys, phone numbers)
   • Keep instructions portable — no hardcoded machine-specific references
3. Ensure YAML frontmatter has name and description:

   ---
   name: skill-name-here
   description: "What it does (max 200 chars)"
   ---
   

Step 2: Publish to skillhu.bz

The skillhu CLI expects lowercase skill.md + optional manifest.json.

# Create skill.md (lowercase) for skillhu
cp /tmp/skill-publish/SKILL.md /tmp/skill-publish/skill.md

Create /tmp/skill-publish/manifest.json:

{
  "name": "skill-name-here",
  "description": "One-line description (max 200 chars)",
  "author": "<your-github-username>",
  "version": "1.0.0",
  "tags": ["tag1", "tag2"],
  "category": "category-here"
}

Categories: development, devops, data, content, creative, marketing, sales, operations, research, communication, integrations, productivity, testing, security, utilities

Publish:

cd /tmp/skill-publish && npx skillhu publish .

Output: https://skillhu.bz/skill/<name>

If 409 (already exists), the skill name is taken. Use a different name.

Step 3: Publish to skills.sh

skills.sh requires a GitHub repo with a SKILL.md (uppercase) containing YAML frontmatter.

# Create repo directory
mkdir -p /tmp/skill-name-repo
cp /tmp/skill-publish/SKILL.md /tmp/skill-name-repo/SKILL.md

# Init git, create GitHub repo, push
cd /tmp/skill-name-repo
git init
git add SKILL.md
git commit -m "Add skill"
gh repo create <your-github-username>/<skill-name> --public \
  --description "Short description here" \
  --source . --push

Then install it to register on the skills.sh leaderboard:

npx skills add <your-github-username>/<skill-name> --global --yes

The skill appears on skills.sh at https://skills.sh (search by name). Install command for others: npx skills add <your-github-username>/<skill-name>

Step 4: Verify both

Check that both are live:

• https://skillhu.bz/skill/<name>
• https://github.com/<your-github-username>/<skill-name>

Summary of install commands

After publishing, users can install via:

# From skillhu.bz
npx skillhu install <skill-name>

# From skills.sh (GitHub)
npx skills add <your-github-username>/<skill-name>

Notes

• skillhu.bz: No auth, instant publish, 409 on duplicate names
• skills.sh: Requires GitHub repo, leaderboard position grows with installs via anonymous telemetry
• Skills should work across agents (Claude Code, Cursor, Gemini CLI, Windsurf, etc.)