Claude Skills Repository

Distribute Claude skills via GitHub with version control and one-line installation.

How It Works

skills/          →   package-skill.sh   →   dist/*.skill   →   GitHub Release   →   curl install
(source, git)                               (generated)

Quick Setup

# 1. Set metadata.version in skills/<skillname>/SKILL.md, then package
bash scripts/package-skill.sh <skillname>          # version read from frontmatter

# 2. Release (per-skill, namespaced tag)
git tag -a <skillname>/v1.0.0 -m "<skillname> v1.0.0"
git push origin <skillname>/v1.0.0
gh release create <skillname>/v1.0.0 --title "<skillname> v1.0.0"

# 3. Users install
curl -L https://raw.githubusercontent.com/webcane/skills/main/dist/<skillname>.skill \
  -o <skillname>.skill

Each skill is versioned and released independently. The version lives in the skill's SKILL.md frontmatter (metadata.version); release tags are <skillname>/v<version>.

For full setup instructions, see QUICK_START.md.

Local Build & Install (Reinstall)

Build a skill from source and install/reinstall it into your local Claude skills directory (~/.claude/skills by default) without going through GitHub releases:

# Pick a skill interactively from skills/
bash scripts/install-local.sh

# Or specify it directly
bash scripts/install-local.sh <skillname>

# Install elsewhere
INSTALL_DIR=/path/to/skills bash scripts/install-local.sh <skillname>

This packages the skill (version read from SKILL.md frontmatter) and re-extracts it over any existing local copy — safe to re-run after every local change to pick up edits.

Repository Structure

├── skills/content-writer-linkedin/   # Source (git tracked)
│   ├── SKILL.md                      # frontmatter holds metadata.version
│   ├── CHANGELOG.md                  # per-skill changelog
│   └── README.md
├── scripts/
│   ├── package-skill.sh              # skill dir → .skill file
│   └── install-skill.sh             # download & extract .skill
├── dist/                             # Generated, gitignored
├── .github/workflows/package-skills.yml
├── CHANGELOG.md
└── .gitignore

Skills

Skill	Description
content-writer-linkedin	Write authentic LinkedIn articles
playing-card-prompt	Interactive wizard that builds stylized playing card image prompts

Installation URLs

# Latest
curl -L https://raw.githubusercontent.com/webcane/skills/main/dist/content-writer-linkedin.skill \
  -o content-writer-linkedin.skill

# Pinned version (release tag is <skill>/v<version>)
curl -L https://github.com/webcane/skills/releases/download/content-writer-linkedin/v1.0.0/content-writer-linkedin-1.0.0.skill \
  -o content-writer-linkedin.skill