b794d0ad6b
- Add npx skills add commands for single, all, and non-interactive install - Document .git suffix requirement for Gitea-hosted repos - Add git clone step to manual installation - Use ln -sf for idempotent symlinks Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
67 lines
2.7 KiB
Markdown
67 lines
2.7 KiB
Markdown
# Agent Skills
|
|
|
|
Custom agent skills for Mosaic Stack and USC projects. Platform-aware — works with both GitHub (`gh`) and Gitea (`tea`) via our abstraction scripts.
|
|
|
|
## Skills
|
|
|
|
| Skill | Purpose | Origin |
|
|
|-------|---------|--------|
|
|
| `pr-reviewer` | Structured PR code review workflow | Adapted from [SpillwaveSolutions/pr-reviewer-skill](https://github.com/SpillwaveSolutions/pr-reviewer-skill) |
|
|
| `code-review-excellence` | Code review methodology and checklists | Adapted from [awesome-skills/code-review-skill](https://github.com/awesome-skills/code-review-skill) |
|
|
| `vercel-react-best-practices` | React/Next.js performance optimization | From [vercel-labs/agent-skills](https://github.com/vercel-labs/agent-skills) |
|
|
| `tailwind-design-system` | Tailwind CSS v4 design system patterns | Adapted from [wshobson/agents](https://github.com/wshobson/agents) |
|
|
|
|
## Installation
|
|
|
|
### Via npx (recommended)
|
|
|
|
Install individual skills into any agent:
|
|
|
|
```bash
|
|
# Install a single skill
|
|
npx skills add https://git.mosaicstack.dev/mosaic/agent-skills.git --skill pr-reviewer --agent claude-code
|
|
|
|
# Install all skills
|
|
npx skills add https://git.mosaicstack.dev/mosaic/agent-skills.git --agent claude-code
|
|
|
|
# Non-interactive (CI/scripting)
|
|
npx skills add https://git.mosaicstack.dev/mosaic/agent-skills.git --skill pr-reviewer --yes --agent claude-code
|
|
```
|
|
|
|
**Note:** The `.git` suffix on the URL is required for Gitea-hosted repos (forces git clone instead of well-known endpoint discovery).
|
|
|
|
### Manual (symlink from local clone)
|
|
|
|
```bash
|
|
# Clone the repo
|
|
git clone https://git.mosaicstack.dev/mosaic/agent-skills.git ~/src/agent-skills
|
|
|
|
# Symlink individual skills
|
|
ln -sf ~/src/agent-skills/skills/pr-reviewer ~/.claude/skills/pr-reviewer
|
|
ln -sf ~/src/agent-skills/skills/code-review-excellence ~/.claude/skills/code-review-excellence
|
|
ln -sf ~/src/agent-skills/skills/vercel-react-best-practices ~/.claude/skills/vercel-react-best-practices
|
|
ln -sf ~/src/agent-skills/skills/tailwind-design-system ~/.claude/skills/tailwind-design-system
|
|
```
|
|
|
|
### Per-Project
|
|
|
|
Symlink into a project's `.claude/skills/` directory for project-specific availability.
|
|
|
|
## Dependencies
|
|
|
|
- `~/.claude/scripts/git/` — Platform-aware git scripts (detect-platform, pr-view, pr-diff, pr-metadata, pr-review, etc.)
|
|
- `python3` — For review file generation
|
|
|
|
## Adapting Skills
|
|
|
|
When adding skills from the community:
|
|
|
|
1. Replace raw `gh`/`tea` calls with our `~/.claude/scripts/git/` scripts
|
|
2. Test on both GitHub and Gitea repos
|
|
3. Remove features that don't work cross-platform (e.g., GitHub-specific inline comments)
|
|
4. Document any platform-specific limitations
|
|
|
|
## License
|
|
|
|
Individual skills retain their original licenses. Adaptations are MIT.
|