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

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

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