# Skills Index

## 🏗️ Architecture & Setup

- [Architecture Patterns](./architecture-patterns.md) - Common architectural patterns and structures
- [Monorepo Management](./monorepo-management.md) - Managing multi-repo workspaces

## 🔧 Development Workflows

- [Debug Service](./debug-service.md) - Systematic debugging methodology
- [Local Development Setup](./local-development.md) - Starting services locally
- [GH Account Routing](./gh-account-routing.md) - Auto-route `gh` CLI to personal vs work account by directory
- [Docker Compose](./docker-compose.md) - Full stack containerization
- [Production Readiness](./production-readiness.md) - Pre-release validation
- [Backup Main Branch](./backup-main-branch.md) - Smart backup with duplicate detection

## 📱 Mobile Development

- [Mobile Code Quality](./mobile-code-quality.md) - Cross-platform mobile standards
- [iOS Development](./ios-development.md) - SwiftUI + Xcode patterns
- [Android Development](./android-development.md) - Kotlin + Jetpack Compose
- [KMP Development](./kmp-development.md) - Kotlin Multiplatform best practices

## 🚀 Release & Deployment

- [Desktop Release](./desktop-release.md) - Cross-platform desktop packaging
- [iOS Release](./ios-release.md) - TestFlight and App Store deployment
- [Service Deployment](./service-deployment.md) - Microservice deployment
- [Dashboard Deployment](./dashboard-deployment.md) - Next.js production deployment
- [Generate Store Assets](./generate-store-assets.md) - App store artwork generation

## 🧪 Testing & Quality

- [Test Strategies](./test-strategies.md) - Unit, integration, and E2E testing
- [Test Desktop App](./test-desktop-app.md) - Desktop application testing
- [Test iOS App](./test-ios-app.md) - iOS simulator testing
- [Code Quality](./code-quality.md) - Linting, formatting, static analysis
- [Security Auditing](./security-auditing.md) - Security checks and best practices
- [Performance Monitoring](./performance-monitoring.md) - Metrics and performance budgets

## 📚 Documentation & Communication

- [Agent Behavior Guidelines](./agent-behavior-guidelines.md) - Canonical agent behavior rules (Karpathy + ByteLyst)
- [Agent Onboarding](./agent-onboarding.md) - Read-order index for agents
- Update agent docs across repos — see `../../.windsurf/workflows/repo_update-agent-docs.md`
- [Scan Repo Context](./scan-repo-context.md) - Generate comprehensive project context
- [API Documentation](./api-documentation.md) - REST API documentation patterns
- [Architecture Documentation](./architecture-documentation.md) - System design docs
- [Onboarding Documentation](./onboarding-documentation.md) - Developer onboarding

## 🔍 Quick Reference

| Need                            | Skill                                                 | Location                         |
| ------------------------------- | ----------------------------------------------------- | -------------------------------- |
| Fix a failing service           | [Debug Service](./debug-service.md)                   | 🔧 Development Workflows         |
| Prepare for release             | [Production Readiness](./production-readiness.md)     | 🧪 Testing & Quality             |
| Start all services              | [Local Development Setup](./local-development.md)     | 🔧 Development Workflows         |
| Backup main branch              | [Backup Main Branch](./backup-main-branch.md)         | 🔧 Development Workflows         |
| Release desktop app             | [Desktop Release](./desktop-release.md)               | 🚀 Release & Deployment          |
| Release iOS app                 | [iOS Release](./ios-release.md)                       | 🚀 Release & Deployment          |
| Generate store assets           | [Generate Store Assets](./generate-store-assets.md)   | 🚀 Release & Deployment          |
| Mobile code quality             | [Mobile Code Quality](./mobile-code-quality.md)       | 📱 Mobile Development            |
| Test desktop app                | [Test Desktop App](./test-desktop-app.md)             | 🧪 Testing & Quality             |
| Test iOS app                    | [Test iOS App](./test-ios-app.md)                     | 🧪 Testing & Quality             |
| Update AI docs                  | `../../.windsurf/workflows/repo_update-agent-docs.md` | 📚 Documentation & Communication |
| Scan repo for context           | [Scan Repo Context](./scan-repo-context.md)           | 📚 Documentation & Communication |
| Write tests                     | [Test Strategies](./test-strategies.md)               | 🧪 Testing & Quality             |
| Docker full stack               | [Docker Compose](./docker-compose.md)                 | 🔧 Development Workflows         |
| Security audit                  | [Security Auditing](./security-auditing.md)           | 🧪 Testing & Quality             |
| Architecture patterns           | [Architecture Patterns](./architecture-patterns.md)   | 🏗️ Architecture & Setup          |
| Route `gh` CLI to right account | [GH Account Routing](./gh-account-routing.md)         | 🔧 Development Workflows         |

## Skill Levels

### 🟢 Beginner

- [Local Development Setup](./local-development.md)
- [Debug Service](./debug-service.md)
- [Test Strategies](./test-strategies.md)
- [GH Account Routing](./gh-account-routing.md)

### 🟡 Intermediate

- [Production Readiness](./production-readiness.md)
- [Docker Compose](./docker-compose.md)
- [Mobile Code Quality](./mobile-code-quality.md)
- [Security Auditing](./security-auditing.md)

### 🔴 Advanced

- [Architecture Patterns](./architecture-patterns.md)
- [Desktop Release](./desktop-release.md)
- [Service Deployment](./service-deployment.md)
- [Performance Monitoring](./performance-monitoring.md)

## Contributing

To add a new skill:

1. Create a new markdown file in this directory
2. Follow the established format (description, when to use, steps, notes)
3. Add it to this index
4. Update the README.md
5. Commit with message: `docs: add <skill-name> skill`

## Tags

Each skill includes tags for easy discovery:

- `#beginner` - Easy to get started
- `#intermediate` - Requires some experience
- `#advanced` - Complex topics
- `#critical` - Essential for production
- `#automation` - Can be automated
- `#security` - Security-related
- `#performance` - Performance-related
