Publish Skills to Marketplaces

Platform Comparison

/learn @owner/repo

npx skills add owner/repo

Prerequisites

1. GitHub repo is public with a valid

   SKILL.md

   at a discoverable path (root or

   .cursor/skills/<name>/

   )
2. SKILL.md has proper frontmatter:

---
name: your-skill-name          # lowercase, hyphens, max 64 chars
description: >-                 # English, max 1024 chars
  What it does and when to use it.
license: MIT
compatibility: Requirements and supported agents.
metadata:
  author: github-username
  version: "1.0"
  tags: tag1 tag2 tag3
---

1. Description is in English — both platforms have international audiences
2. Body content is in English — skills.sh renders the full SKILL.md as the listing page

Step 1: Publish to agentskill.sh

First-time submission

1. Navigate to

   https://agentskill.sh/submit

2. Paste the GitHub repo URL (e.g.

   https://github.com/owner/repo

   )
3. Click Analyze & Import — wait for security scan to complete
4. Verify the result card shows the correct skill name and description

Verify listing

https://agentskill.sh/q/<skill-name>

• Skill name matches

  name

  field in frontmatter
• Description matches

  description

  field
• Security score is displayed (aim for 100/100)

https://agentskill.sh/@owner/skill-name

Install command for users

/learn @owner/skill-name

Step 2: Publish to skills.sh

First-time submission

npx skills add owner/repo --yes

--yes

• Clones the repo
• Detects all SKILL.md files
• Installs to all compatible agent directories
• Sends anonymous telemetry to skills.sh (registers the skill)

Verify listing

https://skills.sh/owner/repo/skill-name

Install command for users

npx skills add owner/repo

npx skills add owner/repo --skill skill-name

Step 3: Update Listings After Changes

/submit

npx skills add owner/repo --yes

Quick update script

# 1. Push changes to GitHub
git add -A && git commit -m "update skill listing" && git push

# 2. Re-submit to agentskill.sh (browser)
# Navigate to https://agentskill.sh/submit → paste repo URL → Analyze & Import

# 3. Trigger skills.sh refresh
TMPDIR=$(mktemp -d)
cd "$TMPDIR"
npx skills add owner/repo --yes
rm -rf "$TMPDIR"

Troubleshooting

skills.sh shows stale content

• Run a fresh install via

  npx skills add

  to send new telemetry
• Allow 12–24 hours for the platform to aggregate and refresh
• If still stale after 48h, contact the platform

skills.sh shows old skill name

1. Push the updated SKILL.md with the new

   name

   field
2. Run

   npx skills add owner/repo --yes

   to send fresh telemetry
3. Wait for platform cache refresh (may take 24–48h)

agentskill.sh not showing updates

https://agentskill.sh/submit

Security score issues

• Socket alert: Usually minor dependency concerns — review and assess
• Snyk warning: Check for known vulnerabilities in scripts
• Gen Agent Trust Hub: Automated content safety check — ensure no harmful patterns

Checklist

Publishing Checklist:
- [ ] SKILL.md has valid YAML frontmatter (name, description)
- [ ] Description is in English, specific, includes trigger terms
- [ ] Body content is in English for international visibility
- [ ] GitHub repo is public
- [ ] Submitted to agentskill.sh via /submit
- [ ] Verified agentskill.sh listing and security score
- [ ] Triggered skills.sh listing via npx skills add
- [ ] Verified skills.sh detail page
- [ ] Updated README with install commands for both platforms