Initial commit

2025-11-30 08:49:41 +08:00
commit 735ee8165d
17 changed files with 1350 additions and 0 deletions
--- a/commands/skills.md
+++ b/commands/skills.md
@@ -0,0 +1,324 @@
+---
+description: Discover and activate relevant skills (292 skills, 28 gateways)
+argument-hint: [category|search-term] (optional)
+---
+
+# Skills Discovery Assistant
+
+You are helping the user discover and activate relevant skills from their skills library.
+
+## Your Task
+
+**User's Request:** `$ARGUMENTS`
+
+Follow these steps:
+
+### 1. Read Skills Catalog
+
+Read the master catalog:
+```bash
+cat ~/.claude/plugins/cc-polymath/skills/README.md
+```
+
+### 2. Detect Project Context
+
+Analyze the current directory to understand the project:
+```bash
+# List files to detect project type
+ls -la | head -30
+
+# Check for language/framework indicators
+ls *.{json,md,go,py,rs,swift,zig,toml,yaml,yml} 2>/dev/null | head -20
+```
+
+**Technology Detection → Gateway Mapping:**
+- `package.json` → **discover-frontend** (React, Next.js, TypeScript)
+- `go.mod` → **discover-backend** (Go), may also need discover-api
+- `requirements.txt`, `pyproject.toml`, `uv.lock` → **discover-backend** (Python), **discover-ml** if ML work
+- `Cargo.toml` → **discover-backend** (Rust), **discover-wasm** if WASM
+- `build.zig` → Zig skills at root level
+- `*.swift`, `*.xcodeproj` → **discover-mobile** (iOS/Swift)
+- `Dockerfile`, `docker-compose.yml` → **discover-containers**
+- `.beads/` → Beads workflow skills (root level)
+- `tests/`, `__tests__/` → **discover-testing**
+- Database files → **discover-database**
+
+### 3. Analyze Conversation Context
+
+Review the current conversation for:
+- Technologies mentioned (frameworks, tools, databases)
+- Problems discussed (performance, debugging, deployment)
+- Explicit skill requests
+- Work phase (planning, implementation, testing, deployment)
+
+Map to gateway keywords:
+- "REST API" → **discover-api**
+- "GraphQL" → **discover-api**
+- "Postgres", "MongoDB", "Redis" → **discover-database**
+- "Docker", "Kubernetes" → **discover-containers**
+- "CI/CD", "GitHub Actions" → **discover-cicd**
+- "observability", "logging", "metrics" → **discover-observability**
+- "caching", "CDN" → **discover-caching**
+- "debugging", "GDB", "profiling" → **discover-debugging**
+- "build", "Make", "CMake" → **discover-build-systems**
+- "ML", "model", "training" → **discover-ml**
+- "math", "linear algebra" → **discover-math**
+- "compiler", "parser", "AST" → **discover-plt**
+- "diagram", "flowchart", "Mermaid", "visualization" → **discover-diagrams**
+
+### 4. Provide Contextual Recommendations
+
+Based on the argument provided:
+
+**If NO ARGUMENT (default view):**
+
+Display in this format:
+```
+RECOMMENDED FOR THIS PROJECT:
+→ discover-[category]
+  cat ~/.claude/plugins/cc-polymath/skills/discover-[category]/SKILL.md
+
+→ discover-[category]
+  cat ~/.claude/plugins/cc-polymath/skills/discover-[category]/SKILL.md
+
+CATEGORIES (292 skills):
+Frontend (8) | Database (8) | API (7) | Testing (6) | Diagrams (8) | ML (30)
+Math (19) | Debugging (14) | Build Systems (8) | Caching (7) | Observability (8)
+Containers (5) | CI/CD (4) | PLT (13) | Formal (10) | Cloud (13)
+
+COMMANDS:
+/skills api              - View API skills
+/skills frontend         - View frontend skills
+/skills postgres         - Search for 'postgres'
+/skills list             - Show all categories
+```
+
+Recommend 2-4 gateway skills that match:
+- Detected technologies in the current directory
+- Topics discussed in conversation
+- Common workflows for the project type
+
+### Gateway-First Recommendations:
+
+**Format:**
+```
+RECOMMENDED GATEWAYS:
+→ discover-api
+  Keywords: REST, GraphQL, authentication, authorization, rate limiting
+  cat ~/.claude/plugins/cc-polymath/skills/discover-api/SKILL.md
+
+→ discover-database
+  Keywords: PostgreSQL, MongoDB, Redis, query optimization
+  cat ~/.claude/plugins/cc-polymath/skills/discover-database/SKILL.md
+```
+
+**If ARGUMENT = category name:**
+
+Two scenarios:
+
+**A) If discover-{category} gateway exists:**
+```
+{CATEGORY} SKILLS
+Total: [N] skills
+Keywords: [comma-separated keywords]
+
+KEY SKILLS:
+[List 3-5 key skills with one-line descriptions]
+
+LOAD:
+cat ~/.claude/plugins/cc-polymath/skills/{category}/INDEX.md          # All skills in category
+cat ~/.claude/plugins/cc-polymath/skills/discover-{category}/SKILL.md # Gateway overview
+```
+
+**B) If searching root-level skills:**
+Check for skills like:
+- `skill-*.md` (meta skills)
+- `beads-*.md` (workflow skills)
+- Root-level technology skills
+
+Display similarly but note they're at root level.
+
+**Example for `/skills api`:**
+```
+API SKILLS (7 total)
+Keywords: REST, GraphQL, authentication, authorization, rate limiting
+
+SKILLS:
+1. rest-api-design - RESTful resource modeling, HTTP semantics
+2. graphql-schema-design - GraphQL types, resolvers, N+1 prevention
+3. api-authentication - JWT, OAuth 2.0, API keys, sessions
+4. api-authorization - RBAC, ABAC, policy engines
+5. api-rate-limiting - Token bucket, sliding window algorithms
+6. api-versioning - API versioning, deprecation, compatibility
+7. api-error-handling - RFC 7807, validation errors
+
+LOAD:
+cat ~/.claude/plugins/cc-polymath/skills/api/INDEX.md                  # Full details
+cat ~/.claude/plugins/cc-polymath/skills/discover-api/SKILL.md         # Gateway overview
+cat ~/.claude/plugins/cc-polymath/skills/api/rest-api-design.md        # Specific skill
+```
+
+**If ARGUMENT = search term:**
+
+Search across:
+- Gateway skill descriptions (discover-*/SKILL.md)
+- Category INDEX.md files
+- skills/README.md catalog
+- Root-level skill filenames
+
+Display matching gateway categories FIRST, then specific skills:
+```
+SEARCH: 'postgres'
+
+GATEWAY:
+→ discover-database
+  Keywords: PostgreSQL, MongoDB, Redis, query optimization
+  cat ~/.claude/plugins/cc-polymath/skills/discover-database/SKILL.md
+
+SKILLS:
+→ postgres-query-optimization.md
+  Debug slow queries, EXPLAIN plans, index design
+  cat ~/.claude/plugins/cc-polymath/skills/database/postgres-query-optimization.md
+
+→ postgres-migrations.md
+  Schema changes, zero-downtime deployments
+  cat ~/.claude/plugins/cc-polymath/skills/database/postgres-migrations.md
+
+→ postgres-schema-design.md
+  Designing schemas, relationships, data types
+  cat ~/.claude/plugins/cc-polymath/skills/database/postgres-schema-design.md
+
+RELATED: discover-observability, discover-caching
+```
+
+**If ARGUMENT = "list":**
+
+Show all 28 gateway categories:
+```
+ALL CATEGORIES (292 skills)
+
+BACKEND & DATA:
+  discover-api (7)         - REST, GraphQL, auth, rate limiting
+  discover-database (8)    - Postgres, MongoDB, Redis, optimization
+  discover-data (5)        - ETL, streaming, batch processing
+  discover-caching (7)     - Redis, CDN, HTTP caching, invalidation
+
+FRONTEND & MOBILE:
+  discover-frontend (8)    - React, Next.js, state management, a11y
+  discover-mobile (4)      - iOS, Swift, SwiftUI, concurrency
+
+TESTING & DOCUMENTATION:
+  discover-testing (6)     - Unit, integration, e2e, TDD, coverage
+  discover-diagrams (8)    - Mermaid flowcharts, sequence, ER, architecture, Gantt
+
+INFRASTRUCTURE:
+  discover-containers (5)  - Docker, Kubernetes, security
+  discover-cicd (4)        - GitHub Actions, pipelines
+  discover-cloud (13)      - Modal, AWS, GCP, serverless
+  discover-infra (6)       - Terraform, IaC, Cloudflare Workers
+  discover-observability (8) - Logging, metrics, tracing, alerts
+  discover-debugging (14)  - GDB, LLDB, profiling, memory leaks
+  discover-build-systems (8) - Make, CMake, Gradle, Maven, Bazel
+  discover-deployment (6)  - Netlify, Heroku, platforms
+  discover-realtime (4)    - WebSockets, SSE, pub/sub
+
+SPECIALIZED:
+  discover-ml (30)         - Training, RAG, embeddings, evaluation
+  discover-math (19)       - Linear algebra, topology, category theory
+  discover-plt (13)        - Compilers, type systems, verification
+  discover-formal (10)     - SAT/SMT, Z3, Lean, theorem proving
+  discover-wasm (4)        - WebAssembly fundamentals, Rust to WASM
+  discover-ebpf (4)        - eBPF tracing, networking, security
+  discover-ir (5)          - LLVM IR, compiler optimizations
+  discover-modal (2)       - Modal functions, scheduling
+  discover-engineering (4) - Code review, documentation, leadership
+  discover-product (4)     - Product strategy, roadmaps
+  discover-collab (5)      - Collaboration, code review, pair programming
+
+AGENT SKILLS (Root):
+  elegant-design          - UI/UX design, accessibility, design systems
+  anti-slop               - Detect/eliminate AI-generated patterns
+  typed-holes-refactor    - Systematic TDD-based refactoring
+
+META SKILLS (Root):
+  skill-*.md              - Discovery and creation
+  beads-*.md              - Workflow and task management
+```
+
+### 5. Output Requirements
+
+**Format Guidelines:**
+- Keep output concise and scannable
+- Use `→` for list items
+- Include clear, copy-paste commands
+- Group related items logically
+- Show only relevant categories/skills for the context
+
+**Tone:**
+- Direct and helpful
+- Low noise, high signal
+- Focus on what the user needs now
+- Don't explain the system unless asked
+
+**DO NOT:**
+- Modify any skill files
+- Create new skills
+- Change README.md or INDEX files
+- Make assumptions about skills you haven't read
+- Display full skill contents (only summaries)
+- Reference _INDEX.md (it's archived)
+
+### 6. Graceful Fallbacks
+
+**If skills/README.md not found:**
+```
+Skills catalog not found at skills/README.md
+
+Expected structure:
+skills/
+├── README.md              (Master catalog)
+├── discover-*/SKILL.md    (27 gateway skills)
+└── {category}/INDEX.md    (Category indexes)
+
+Is your repository in a different location?
+```
+
+**If no matches for search:**
+```
+No skills found matching '$ARGUMENTS'
+
+Try:
+- Broader search term
+- View all gateways: /skills list
+- Browse full catalog: cat ~/.claude/plugins/cc-polymath/skills/README.md
+- Check a category: /skills api
+```
+
+**If empty project directory:**
+```
+━━━ SKILLS DISCOVERY ━━━
+
+No project files detected in current directory.
+
+GENERAL-PURPOSE GATEWAYS:
+→ discover-collab - Collaboration, documentation, CodeTour walkthroughs
+  Load: cat ~/.claude/plugins/cc-polymath/skills/discover-collab/SKILL.md
+
+ROOT-LEVEL SKILLS:
+→ beads-workflow.md - Multi-session task management
+→ skill-creation.md - Creating new atomic skills
+→ skill-repo-discovery.md - Discover skills for repositories
+
+[View all: /skills list]
+[Browse catalog: cat ~/.claude/plugins/cc-polymath/skills/README.md]
+```
+
+## Remember
+
+- Read skills/README.md to get accurate information (NOT _INDEX.md - that's archived)
+- Recommend gateway skills first, then specific skills
+- Match skills to project context when possible
+- Keep output concise and actionable
+- Never modify the skills library
+- Provide clear, copy-paste commands
+- The catalog has: 292 skills, 28 gateways, 31 categories