My Skill

SkillsMP (fallback)

Use the skillsmp_search tool when the user explicitly asks for SkillsMP, or when Starchild Marketplace returns no relevant results.

Workflow

1. Always search Starchild Marketplace first via bash curl.
2. Present results with namespace, name, description, stars, installs.
3. If no good match found, search SkillsMP as fallback and tell the user.
4. Recommend based on: description match > installs > stars > recency.

2. Install

From Starchild Marketplace

Step 1: Fetch skill files as JSON

curl -s "https://skills-market-gateway.fly.dev/skills/NAMESPACE/SKILLNAME/install?format=json"

• NAMESPACE — without @ (e.g. alice, not @alice)
• Add &version=1.0.0 for a specific version (default: latest)
• The gateway downloads the published bundle.zip from GitHub Release and extracts it in memory — all files including nested subdirectories are returned in a single response

Step 2: Write files to local skills directory

python3 -c "
import json, os, urllib.request

url = 'https://skills-market-gateway.fly.dev/skills/NAMESPACE/SKILLNAME/install?format=json'
data = json.loads(urllib.request.urlopen(url).read())
skill_dir = f'./skills/{data[\"name\"]}'
for fname, content in data['files'].items():
    path = os.path.join(skill_dir, fname)
    os.makedirs(os.path.dirname(path), exist_ok=True)
    with open(path, 'w') as f:
        f.write(content)
print(f'Installed {data[\"namespace\"]}/{data[\"name\"]} v{data[\"version\"]} -> {skill_dir}')
"

Step 3: Call skill_refresh() to reload the skills cache.

From SkillsMP

npx skills add <githubUrl>

Use the GitHub field from skillsmp_search results. If npx skills isn't available, fall back to manual:

1. Extract raw SKILL.md URL from githubUrl
2. Fetch with web_fetch
3. Write to skills/<name>/SKILL.md
4. Call skill_refresh()

Post-Install

Always call skill_refresh() after installation from either source and confirm the skill appears in the refreshed list.

3. Publish

Upload a local skill to the Starchild Community Marketplace.

SKILL.md Requirements

Every skill must have YAML frontmatter:

---