mosaic/agent-skills
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

feat: Expand fleet to 23 skills across all domains

Browse Source 
New skills (14):
- nestjs-best-practices: 40 priority-ranked rules (kadajett)
- fastapi: Pydantic v2, async SQLAlchemy, JWT auth (jezweb)
- architecture-patterns: Clean Architecture, Hexagonal, DDD (wshobson)
- python-performance-optimization: Profiling and optimization (wshobson)
- ai-sdk: Vercel AI SDK streaming and agent patterns (vercel)
- create-agent: Modular agent architecture with OpenRouter (openrouterteam)
- proactive-agent: WAL Protocol, compaction recovery, self-improvement (halthelobster)
- brand-guidelines: Brand identity enforcement (anthropics)
- ui-animation: Motion design with accessibility (mblode)
- marketing-ideas: 139 ideas across 14 categories (coreyhaines31)
- pricing-strategy: SaaS pricing and tier design (coreyhaines31)
- programmatic-seo: SEO at scale with playbooks (coreyhaines31)
- competitor-alternatives: Comparison page architecture (coreyhaines31)
- referral-program: Referral and affiliate programs (coreyhaines31)

README reorganized by domain: Code Quality, Frontend, Backend,
Auth, AI/Agent Building, Marketing, Design, Meta.

Mosaic Stack is not limited to coding — the Orchestrator serves
coding, business, design, marketing, writing, logistics, and analysis.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
This commit is contained in:
Jason Woltje
2026-02-16 16:22:53 -06:00
parent f6bcc86881
commit 861b28b965
85 changed files with 20895 additions and 25 deletions
Download Patch File Download Diff File Expand all files Collapse all files

77
README.md
View File

@@ -1,42 +1,77 @@
# 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.
Curated agent skill fleet for Mosaic Stack. Covers coding, business development, design, marketing, orchestration, and more. Platform-aware — works with both GitHub (`gh`) and Gitea (`tea`) via our abstraction scripts.
## Skills
## Skills (23)
### Code Quality & Review
| 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) |
| `verification-before-completion` | Evidence-based completion claims — no success without verification | From [obra/superpowers](https://github.com/obra/superpowers) |
| `pr-reviewer` | Structured PR code review workflow (Gitea/GitHub) | Adapted from [SpillwaveSolutions](https://github.com/SpillwaveSolutions/pr-reviewer-skill) |
| `code-review-excellence` | Code review methodology and checklists | Adapted from [awesome-skills](https://github.com/awesome-skills/code-review-skill) |
| `verification-before-completion` | Evidence-based completion claims — no success without verification | [obra/superpowers](https://github.com/obra/superpowers) |
### Frontend & UI
| Skill | Purpose | Origin |
|-------|---------|--------|
| `next-best-practices` | Next.js 15+ best practices — RSC, async patterns, self-hosting, data patterns | From [vercel-labs/next-skills](https://github.com/vercel-labs/next-skills) |
| `vercel-react-best-practices` | React/Next.js performance optimization (57 rules) | From [vercel-labs/agent-skills](https://github.com/vercel-labs/agent-skills) |
| `shadcn-ui` | shadcn/ui component patterns — forms, dialogs, tables, charts | From [giuseppe-trisciuoglio/developer-kit](https://github.com/giuseppe-trisciuoglio/developer-kit) |
| `next-best-practices` | Next.js 15+ — RSC, async patterns, self-hosting, data patterns | [vercel-labs/next-skills](https://github.com/vercel-labs/next-skills) |
| `vercel-react-best-practices` | React/Next.js performance optimization (57 rules) | [vercel-labs/agent-skills](https://github.com/vercel-labs/agent-skills) |
| `shadcn-ui` | Component patterns — forms, dialogs, tables, charts | [developer-kit](https://github.com/giuseppe-trisciuoglio/developer-kit) |
| `tailwind-design-system` | Tailwind CSS v4 design system patterns | Adapted from [wshobson/agents](https://github.com/wshobson/agents) |
| `ui-animation` | Motion design — performance, accessibility, easing curves | [mblode/agent-skills](https://github.com/mblode/agent-skills) |
### Backend & API
| Skill | Purpose | Origin |
|-------|---------|--------|
| `nestjs-best-practices` | NestJS — 40 rules across 10 categories, priority-ranked | [kadajett/agent-nestjs-skills](https://github.com/kadajett/agent-nestjs-skills) |
| `fastapi` | FastAPI with Pydantic v2, async SQLAlchemy 2.0, JWT auth | [jezweb/claude-skills](https://github.com/jezweb/claude-skills) |
| `architecture-patterns` | Clean Architecture, Hexagonal, DDD patterns | [wshobson/agents](https://github.com/wshobson/agents) |
| `python-performance-optimization` | Profiling, memory optimization, parallelization | [wshobson/agents](https://github.com/wshobson/agents) |
### Authentication
| Skill | Purpose | Origin |
|-------|---------|--------|
| `better-auth-best-practices` | Better-Auth integration — Drizzle adapter, sessions, plugins, security | From [better-auth/skills](https://github.com/better-auth/skills) |
| `better-auth-best-practices` | Better-Auth — Drizzle adapter, sessions, plugins, security | [better-auth/skills](https://github.com/better-auth/skills) |
### AI & Agent Building
| Skill | Purpose | Origin |
|-------|---------|--------|
| `ai-sdk` | Vercel AI SDK — streaming, multi-provider, agent patterns | [vercel/ai](https://github.com/vercel/ai) |
| `create-agent` | Modular agent architecture with OpenRouter multi-model access | [openrouterteam/agent-skills](https://github.com/openrouterteam/agent-skills) |
| `proactive-agent` | Proactive agent architecture — WAL Protocol, compaction recovery, self-improvement | [halthelobster/proactive-agent](https://github.com/halthelobster/proactive-agent) |
### Marketing & Business Development
| Skill | Purpose | Origin |
|-------|---------|--------|
| `marketing-ideas` | 139 proven marketing ideas across 14 categories | [coreyhaines31/marketingskills](https://github.com/coreyhaines31/marketingskills) |
| `pricing-strategy` | SaaS pricing — value metrics, tier design, research methods | [coreyhaines31/marketingskills](https://github.com/coreyhaines31/marketingskills) |
| `programmatic-seo` | SEO at scale — templates, playbooks, internal linking | [coreyhaines31/marketingskills](https://github.com/coreyhaines31/marketingskills) |
| `competitor-alternatives` | Competitor comparison pages — content architecture, templates | [coreyhaines31/marketingskills](https://github.com/coreyhaines31/marketingskills) |
| `referral-program` | Referral & affiliate programs — incentives, metrics, launch | [coreyhaines31/marketingskills](https://github.com/coreyhaines31/marketingskills) |
### Design & Brand
| Skill | Purpose | Origin |
|-------|---------|--------|
| `brand-guidelines` | Brand identity enforcement — fonts, colors, styling | [anthropics/skills](https://github.com/anthropics/skills) |
### Meta / Skill Authoring
| Skill | Purpose | Origin |
|-------|---------|--------|
| `writing-skills` | TDD-based methodology for creating and testing agent skills | From [obra/superpowers](https://github.com/obra/superpowers) |
| `writing-skills` | TDD-based methodology for creating and testing agent skills | [obra/superpowers](https://github.com/obra/superpowers) |
## Mosaic Stack Alignment
These skills are curated for the Mosaic Stack tech stack:
These skills are curated for the Mosaic Stack platform, which serves coding, business development, design, marketing, writing, logistics, analysis, and more. The Orchestrator and subagents can load any combination of skills based on the task at hand.
**Core tech stack:**
- **Backend:** NestJS + TypeScript
- **Frontend:** Next.js 15 + React 19 (App Router)
- **Styling:** Tailwind CSS v4 + shadcn/ui
@@ -45,17 +80,15 @@ These skills are curated for the Mosaic Stack tech stack:
- **CI/CD:** Woodpecker CI / Gitea
- **Deployment:** Docker Swarm
Skills are either used as-is (when framework-agnostic or matching our stack) or adapted with Mosaic Stack-specific notes where upstream assumptions differ (e.g., shadcn-ui references Tailwind v3 config patterns).
Skills are either used as-is (when framework-agnostic or matching our stack) or adapted with Mosaic Stack-specific notes where upstream assumptions differ.
## 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
npx skills add https://git.mosaicstack.dev/mosaic/agent-skills.git --skill nestjs-best-practices --agent claude-code
# Install all skills
npx skills add https://git.mosaicstack.dev/mosaic/agent-skills.git --agent claude-code
@@ -76,12 +109,6 @@ git clone https://git.mosaicstack.dev/mosaic/agent-skills.git ~/src/agent-skills
for skill in ~/src/agent-skills/skills/*/; do
ln -sf "$skill" ~/.claude/skills/$(basename "$skill")
done
# Or symlink individually
ln -sf ~/src/agent-skills/skills/pr-reviewer ~/.claude/skills/pr-reviewer
ln -sf ~/src/agent-skills/skills/next-best-practices ~/.claude/skills/next-best-practices
ln -sf ~/src/agent-skills/skills/better-auth-best-practices ~/.claude/skills/better-auth-best-practices
# ... etc
```
### Per-Project
@@ -90,8 +117,8 @@ Symlink into a project's `.claude/skills/` directory for project-specific availa
## Dependencies
- `~/.claude/scripts/git/` — Platform-aware git scripts (detect-platform, pr-view, pr-diff, pr-metadata, pr-review, etc.)
- `python3` — For review file generation (pr-reviewer)
- `~/.claude/scripts/git/` — Platform-aware git scripts (pr-reviewer only)
- `python3` — For review file generation (pr-reviewer only)
## Adapting Skills
@@ -99,8 +126,8 @@ 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. Add Mosaic Stack context notes where upstream assumptions differ from our stack
3. Remove features that don't work cross-platform
4. Add Mosaic Stack context notes where upstream assumptions differ
5. Document any platform-specific limitations
## License