$share-skill

---
name: share-skill
description: Publish local Agent Skills to SkillURL and return public install links.
---

# Share Skill

Use this skill when the user wants to share one or more local Agent Skills publicly.

The job is narrow:

> Resolve local Agent Skills, upload them to SkillURL, and return the public links.

## When To Use

Use this skill when the user asks things like:

- "Share my `$claude` skill."
- "Upload this skill to SkillURL."
- "Give me a public link for this `SKILL.md`."
- "Share these skills: critique, claude, todo."
- "Publish this skill folder and return the link."

Do not use this skill for generic file hosting, package registries, discovery pages, SEO work, or marketplace tasks.

## Inputs To Accept

Accept any of these:

- A path to a `SKILL.md` file.
- A path to a skill directory containing `SKILL.md`.
- A skill name from a known local skills directory.
- Several paths or skill names.
- The current draft `SKILL.md` in the working directory.

Known local skill roots often include:

- `~/.codex/skills`
- `~/.claude/skills`
- `/Users/piny/Personal/agent-skills/codex/skills`

## Workflow

1. Resolve each requested skill to a local path.
2. Confirm the skill has a `SKILL.md`.
3. If the skill is only a single `SKILL.md`, upload the markdown file.
4. If the skill folder has supporting files, upload a ZIP package.
5. Use the SkillURL API:

```bash
curl -X POST https://skillurl.com/api/skills \
  -F skillFile=@/path/to/skill.zip
```

or:

```bash
curl -X POST https://skillurl.com/api/skills \
  -H 'Content-Type: text/markdown' \
  --data-binary @/path/to/SKILL.md
```

6. Return the result clearly:

```text
$skill-name
https://skillurl.com/s/...
install $skill-name from https://skillurl.com/s/...
```

Include the raw URL and package URL only when useful.

## Helper Script

Prefer the bundled helper when available:

```bash
scripts/share-skill.sh /path/to/skill-or-SKILL.md [...]
```

The helper:

- Detects `SKILL.md` files and skill directories.
- Zips skill directories when supporting files are present.
- Excludes common junk files.
- Uploads each skill to SkillURL.
- Prints the API response.

## Safety And Scope

- Do not modify the skill before uploading unless the user explicitly asks.
- Do not upload unrelated files such as `.git`, `node_modules`, logs, caches, or temporary files.
- Do not infer permission to share private or sensitive skills. If the requested skill appears to include secrets, private credentials, customer data, or internal-only content, stop and ask before uploading.
- Do not create discovery pages or marketing content.
- Do not install anything on the user's machine.

## Output Style

Be concise. For each uploaded skill, return:

- Display name.
- Public SkillURL.
- Install prompt.

If an upload fails, report the exact error and the path that failed.