Create a module that installs and manages Claude/OpenCode AI agent skills into a repository, bringing modern development patterns from the AI ecosystem.

[MaximilianoAcri]

Motivation

There are 80+ highly curated skills for AI coding agents (Claude, OpenCode, Cursor, etc.) that provide:

• Framework-specific patterns (React 19, Next.js 15, Angular, Django, etc.)
• Testing patterns (Playwright, Vitest, Pytest)
• Database ORMs (Prisma, Supabase)
• State management (Zustand, Zustand 5)
• CSS frameworks (Tailwind 4, NativeWind)
• DevOps (GitHub Actions, GCP, Docker, Cron)
• Plus persistent memory (Engram) and SDD workflow

Currently these skills live in the AI agent's config, not in the repository. A module could sync these patterns into the repo so all developers (human + AI) benefit from the same conventions.

Proposal

Create a claude-skills-sync module that:

1. Installs skill patterns - Copies skill documentation into repo as docs/skills/
2. Updates on schedule - Checks for skill updates periodically
3. Integrates with existing patterns - Merges with any existing conventions
4. Documents what's installed - Maintains a registry of patterns

What Could Be Installed

Skill	Description	Value
react-19	React 19 with compiler patterns	No more useMemo/useCallback
nextjs-15	Next.js 15 App Router	Server Actions, partial prerendering
prisma	Type-safe ORM	Full TypeScript integration
playwright	E2E testing	Page Objects, selectors
tailwind-4	Modern CSS	cn(), no var() in className
zustand-5	State management	New simplified API
supabase	Firebase alternative	BaaS with PostgreSQL
sdd	Spec-Driven Development	opspec workflow
engram	Persistent memory	Cross-session context
30+ more	Various frameworks	Full stack coverage

Documentation Sync (Design System, etc.)

Beyond skills, this module can also sync project documentation:

Document	Description
DESIGN.md	Complete design system (colors, typography, components)
docs/API.md	API conventions
docs/CONTRIBUTING.md	Contribution guidelines
docs/ARCHITECTURE.md	Architecture decisions

Example for DESIGN.md:

• 550+ lines of design system
• Color palette (primary, neutral, semantic)
• Typography scale
• Component patterns
• Spacing system

This ensures all AI agents (and developers) follow the same conventions.

Module Structure

modules/claude-skills-sync/
  module.yaml
  entry.sh              # Main sync logic
  skills.yaml           # List of skills to sync
  templates/
    gitignore patterns
    README.md

Features

1. Selective install - Install only needed skills
2. Version pinning - Lock to specific skill versions
3. Custom skills - Allow custom skill directories
4. Auto-update - Configurable update schedule
5. Documentation - Generate docs/skills/README.md

Example Usage

# Install all recommended skills for this repo type
sz skills install --recommend

# Install specific skills
sz skills install react-19 nextjs-15 tailwind-4

# List installed skills
sz skills list

# Check for updates
sz skills update

# Configure auto-update
sz config set skills.auto_update weekly

Integration

This module works great with:

• skill-library-ce - Existing skill catalog
• approval-gate (proposed) - Approve skill updates
• heartbeat - Schedule automatic updates

Why This Matters

Instead of each developer/AI learning framework quirks separately, the repository itself contains the conventions. Any AI agent (Claude, OpenCode, Cursor, etc.) can read docs/skills/ and follow the same patterns.

This creates consistent code across the team, regardless of which AI tool is used.

---

Happy to contribute this! I have experience with these skills from the OpenCode ecosystem.