claude-skills

My collection of Claude skills -- primarily used for the Claude.ai PaaS skill compute environment, mileage will vary if attempted used as Claude Code Agent Skills

Installing Skills

For Claude.ai (Web/Mobile)

1. To install a skill in Claude.ai you first need a paid account (Claude Pro or Team)
2. Download the skill ZIP from the Releases page
   • Note: Each release includes a direct download link for the skill ZIP - use that, not the "Source code" archives auto-generated by GitHub
3. Upload to Claude.ai Skills Settings
4. See official documentation for more details

For Claude Code (Automated Installation)

Install skills directly to your project with a single command:

curl -fsSL https://raw.githubusercontent.com/oaustegard/claude-skills/main/templates/installation/install-skills.sh | bash

Or download and customize which skills to install:

# Download the script
curl -O https://raw.githubusercontent.com/oaustegard/claude-skills/main/templates/installation/install-skills.sh

# Edit SKILLS array to select which skills to install
nano install-skills.sh

# Run installation
chmod +x install-skills.sh
./install-skills.sh

Features:

• ✅ Installs skills to .claude/skills/ directory
• ✅ Always pulls latest versions from main branch
• ✅ Automatic cleanup of workflow metadata
• ✅ Customizable skill selection

CI/CD Integration:

Set up automated skill updates with GitHub Actions:

mkdir -p .github/workflows
curl -o .github/workflows/install-skills.yml \
  https://raw.githubusercontent.com/oaustegard/claude-skills/main/templates/installation/install-skills.yml

Then trigger via: Actions → Install Claude Skills → Run workflow

For complete documentation, see templates/installation/README.md

Contributing Skills

(Not actually sure about the workflow for a forked repo back to mine -- someone will have to test and report, but within your own fork:...)

Via ZIP Upload (Easiest)

1. Create your skill folder with SKILL.md at the root
2. Package your skill:

   # Correct structure:
   your-skill.zip
     └── your-skill/
         ├── SKILL.md
         └── resources/  (optional)
   
   # NOTE: Do NOT include a VERSION file in your ZIP
   # VERSION files are workflow metadata and will be ignored
   

3. Upload the ZIP to the uploads/ directory
4. The workflow will automatically create a PR with your skill content
5. When ready to release, update the VERSION file separately (see "Releasing Skills" below)

Via Direct Development

1. Create a new branch
2. Add your skill folder at the repository root (SKILL.md and resources)
3. Submit a PR with your skill content
4. When ready to release, update the VERSION file separately (see "Releasing Skills" below)

Releasing Skills

Important: VERSION files are workflow metadata, separate from skill content.

• Releases are triggered explicitly by updating VERSION files on main branch
• Simply changing skill content does NOT trigger a release
• This separation allows you to iterate on skills without creating releases for every change

How It Works

1. Develop & Update: Upload ZIPs or edit skill files directly → PRs update skill content in repo
2. Release When Ready: Update VERSION file → Automatic release created with downloadable ZIP

Creating a New Release

1. Update the VERSION file in your skill folder:

   echo "1.1.0" > your-skill/VERSION
   

2. Commit and push (or merge PR):

   git add your-skill/VERSION
   git commit -m "chore: bump your-skill to v1.1.0"
   git push
   

3. The workflow will automatically:

   • Create a properly structured ZIP file (VERSION excluded - it's not part of the skill)
   • Generate a GitHub release with tag your-skill-v1.1.0
   • Attach the ZIP as a release asset
   • Generate release notes from recent commits
   • Users download this ZIP to install the skill

Manual Release

You can also trigger a release manually via GitHub Actions:

1. Go to Actions → Release Skill → Run workflow
2. Enter the skill folder name
3. Optionally specify a version (otherwise uses VERSION file)

Version Format

Use semantic versioning:

• 1.0.0 - Initial release
• 1.0.1 - Patch (bug fixes)
• 1.1.0 - Minor (new features, backward compatible)
• 2.0.0 - Major (breaking changes)

Resources

• https://www.anthropic.com/engineering/equipping-agents-for-the-real-world-with-agent-skills
• https://support.claude.com/en/articles/12512198-how-to-create-custom-skills