# 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

### Manual (symlink into Claude Code)

```bash
# Symlink individual skills
ln -s ~/src/agent-skills/skills/pr-reviewer ~/.claude/skills/pr-reviewer
ln -s ~/src/agent-skills/skills/code-review-excellence ~/.claude/skills/code-review-excellence
ln -s ~/src/agent-skills/skills/vercel-react-best-practices ~/.claude/skills/vercel-react-best-practices
ln -s ~/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.