# claude-skills A collection of Claude skills distributed as a **Claude Code plugin marketplace**. Skills are primarily designed for the Claude.ai PaaS skill compute environment; mileage will vary if used as Claude Code Agent Skills. ## Installing as a Plugin Marketplace (Claude Code) Add this repository as a plugin marketplace in Claude Code: ``` /plugin marketplace add oaustegard/claude-skills ``` Then browse and install individual plugins: ``` /plugin install skill-name@oaustegard-claude-skills ``` Update all marketplace plugins to latest: ``` /plugin marketplace update ``` ## Installing Skills for Claude.ai (Web/Mobile) 1. You need a paid Claude account (Pro or Team) 2. Download the skill ZIP from the [Releases page](../../releases) - **Note:** Use the direct download link for the skill ZIP, not the "Source code" archives auto-generated by GitHub 3. Upload to [Claude.ai Customize › Skills](https://claude.ai/customize/skills) 4. See [official documentation](https://support.claude.com/en/articles/12512198-how-to-create-custom-skills) for more details ### Automated Installation (Claude Code) Install skills directly to your project with a single command: ```bash curl -fsSL https://raw.githubusercontent.com/oaustegard/claude-skills/main/templates/installation/install-skills.sh | bash ``` Or download and customize which skills to install: ```bash curl -O https://raw.githubusercontent.com/oaustegard/claude-skills/main/templates/installation/install-skills.sh nano install-skills.sh # Edit SKILLS array chmod +x install-skills.sh && ./install-skills.sh ``` **CI/CD Integration:** ```bash mkdir -p .github/workflows curl -o .github/workflows/install-skills.yml \ https://raw.githubusercontent.com/oaustegard/claude-skills/main/templates/installation/install-skills.yml ``` For complete documentation, see [templates/installation/README.md](templates/installation/README.md) ## Adding Skills ### Via ZIP Upload (Easiest) 1. Create your skill folder with `SKILL.md` at the root 2. Package your skill: ```bash your-skill.zip └── your-skill/ ├── SKILL.md └── resources/ (optional) ``` 3. Upload the ZIP to the `.uploads/` directory 4. The workflow will automatically create a PR with your skill content ### 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 ## Releasing Skills Releases are triggered by updating `metadata.version` in SKILL.md frontmatter on main branch. ### Version Format Use [semantic versioning](https://semver.org/): - `0.1.0` - Initial release - `0.1.1` - Patch (bug fixes) - `0.2.0` - Minor (new features, backward compatible) - `1.0.0` - Major (breaking changes) ## Resources - [Introducing Agent Skills](https://www.anthropic.com/news/skills) - [Claude Code Plugin Marketplaces](https://code.claude.com/docs/en/plugin-marketplaces) - [Creating Custom Skills](https://support.claude.com/en/articles/12512198-how-to-create-custom-skills)