Update /skills slash command documentation to v2.0

Comprehensive update of all slash command documentation to reflect current
gateway-based architecture and accurate skill counts.

Updated counts across all files:
- Skills: 284 → 292 (+8 diagram skills)
- Gateways: 27 → 28 (+discover-diagrams)
- Categories: 30 → 31 (+diagrams category)

Documentation improvements:
- README.md: Updated all examples, references, and counts
- QUICK_START.md: Modernized installation paths and examples
- PROJECT_STATUS.md: Complete rewrite with current architecture details
- install.sh: Updated verification thresholds and success message

Fixes:
- Replaced all references to old cc-slash-skill repo name with cc-polymath
- Changed _INDEX.md references to README.md (new architecture)
- Updated from monolithic to gateway-based progressive loading examples
- Added diagrams category to all relevant sections

Version bump: 1.0.0 → 2.0.0 to reflect architectural changes

All documentation now accurately describes the current state of:
- 292 skills across 31 categories
- 28 gateway skills for auto-discovery
- Progressive loading with 60-84% context reduction
- Gateway → Category → Skill loading pattern

Author: rand

slash-commands/install.sh

@@ -35,8 +35,8 @@ fi
 
 # Verify gateway architecture
 GATEWAY_COUNT=$(find "$REPO_ROOT/skills" -name "discover-*" -type d 2>/dev/null | wc -l | tr -d ' ')
-if [ "$GATEWAY_COUNT" -lt 25 ]; then
-    echo "⚠ Warning: Expected ~27 gateway skills, found $GATEWAY_COUNT"
+if [ "$GATEWAY_COUNT" -lt 26 ]; then
+    echo "⚠ Warning: Expected ~28 gateway skills, found $GATEWAY_COUNT"
     echo "  Gateway architecture may not be fully set up"
     echo ""
 fi
@@ -88,14 +88,15 @@ echo "━━━━━━━━━━━━━━━━━━━━━━━━
 echo "Installation complete!"
 echo ""
 echo "Skills Architecture:"
-echo "  284 skills across 30 categories"
-echo "  27 gateway skills for auto-discovery"
+echo "  292 skills across 31 categories"
+echo "  28 gateway skills for auto-discovery"
 echo "  Progressive loading (60-84% context reduction)"
 echo ""
 echo "Usage:"
-echo "  /skills              # Browse 284 skills, 27 categories"
+echo "  /skills              # Browse all skills and categories"
 echo "  /skills api          # View API skills gateway"
 echo "  /skills frontend     # View frontend skills"
+echo "  /skills diagrams     # View diagram/Mermaid skills"
 echo "  /skills ml           # View ML/AI skills"
 echo "  /skills postgres     # Search for Postgres skills"
 echo "  /skills list         # Show all categories"

slash-commands/skills/PROJECT_STATUS.md

@@ -1,50 +1,59 @@
 # Project Status: `/skills` Slash Command
 
-**Status:** ✅ **COMPLETE AND READY TO USE**
+**Status:** ✅ **PRODUCTION READY**
 
-**Version:** 1.0.0
-**Date:** 2025-10-25
-**Location:** `/Users/rand/src/cc-slash-skill`
+**Version:** 2.0.0
+**Date:** 2025-10-27
+**Location:** `/Users/rand/src/cc-polymath/slash-commands`
 
 ---
 
 ## What Was Built
 
-A context-aware skills discovery slash command for Claude Code that helps users discover and activate relevant skills from their `~/.claude/skills/` library.
+A context-aware skills discovery slash command for Claude Code that helps users discover and activate relevant skills from their `~/.claude/skills/` library using a gateway-based progressive loading architecture.
 
 ## Project Files
 
 ```
-cc-slash-skill/
-├── skills.md          # The slash command file (6.6 KB)
-├── install.sh         # One-click installation script
-├── uninstall.sh       # Clean removal script
-├── README.md          # Complete documentation (8.5 KB)
-├── QUICK_START.md     # 60-second getting started guide
-└── PROJECT_STATUS.md  # This file
+cc-polymath/slash-commands/
+├── skills/
+│   ├── skills.md          # The slash command file (~10 KB)
+│   ├── README.md          # Complete documentation
+│   ├── QUICK_START.md     # 60-second getting started guide
+│   └── PROJECT_STATUS.md  # This file
+├── install.sh             # Automated installation script
+└── uninstall.sh           # Clean removal script
 ```
 
-**Total:** 6 files, ~19 KB
+**Total:** 6 files
 
 ## Installation Status
 
-✅ **Already installed** at `~/.claude/commands/skills.md`
+✅ **Already installed** at `~/.claude/commands/skills.md` (symlinked)
 
-The command is ready to use immediately in your next Claude Code session.
+The command is ready to use immediately in your Claude Code sessions.
 
 ## Features Implemented
 
 ### ✅ Core Functionality
 - Context-aware skill recommendations based on project files
-- Category browsing (135+ skills across 15+ categories)
+- Gateway-based skill discovery (28 gateways)
+- Category browsing (292 skills across 31 categories)
 - Fuzzy search across skill names and descriptions
 - Full catalog listing with counts and descriptions
 
+### ✅ Progressive Loading Architecture
+- Gateway skills (~200 lines, ~2K tokens each)
+- Category indexes (~300 lines, ~3K tokens)
+- Individual skills (~300-450 lines, ~2-3K tokens)
+- 60-84% context reduction vs monolithic index
+
 ### ✅ User Experience
-- CLI-optimized output (fits in one screen)
-- Unicode box drawing for clean sections
-- Actionable next steps in every view
+- CLI-optimized output (concise and actionable)
+- Clear bash commands for loading skills
+- Gateway-first recommendations
 - Graceful fallbacks for edge cases
+- Read-only, non-destructive
 
 ### ✅ Safety & Compatibility
 - Read-only operations (never modifies skills)
@@ -58,15 +67,33 @@ The command is ready to use immediately in your next Claude Code session.
 - Installation and uninstallation scripts
 - Troubleshooting guide
 
+## Skills Architecture
+
+### Categories (31 total)
+- **Backend & Data:** API (7), Database (8), Data (5), Caching (7)
+- **Frontend & Mobile:** Frontend (8), Mobile (4)
+- **Testing & Documentation:** Testing (6), Diagrams (8)
+- **Infrastructure:** Containers (5), CI/CD (4), Cloud (13), Infra (6), Observability (8), Debugging (14), Build Systems (8), Deployment (6), Realtime (4)
+- **Specialized:** ML (30), Math (19), PLT (13), Formal (10), WASM (4), eBPF (4), IR (5), Modal (2)
+- **Engineering:** Engineering (4), Product (4), Collab (5)
+
+### Gateway Skills (28 total)
+Each discover-* gateway provides:
+- Keyword-based auto-activation
+- Quick reference to category skills
+- Common workflow combinations
+- Integration guidance
+
 ## Testing
 
 ### Verified Contexts
 ✅ Empty directories (provides general recommendations)
 ✅ JavaScript/TypeScript projects (detects package.json)
 ✅ Go projects (detects go.mod)
 ✅ Python projects (detects pyproject.toml, requirements.txt)
+✅ Rust projects (detects Cargo.toml)
 ✅ Multi-language projects (detects all technologies)
-✅ Projects with Beads (detects .beads/)
+✅ Projects with specific tools (Docker, Kubernetes, etc.)
 
 ### Command Variants Tested
 ✅ `/skills` (default, context-aware view)
@@ -80,44 +107,44 @@ The command is ready to use immediately in your next Claude Code session.
 ```
 /skills
 ```
-Shows context-aware recommendations for current project.
+Shows context-aware gateway recommendations for current project.
 
 ### Category Browsing
 ```
 /skills frontend
 /skills database
-/skills testing
+/skills diagrams
 ```
-Displays all skills in the specified category.
+Displays gateway overview and available skills in category.
 
 ### Searching
 ```
 /skills postgres
+/skills mermaid
 /skills authentication
-/skills docker
 ```
-Finds skills matching the search term.
+Finds gateway and specific skills matching the search term.
 
 ## Installation Instructions
 
 ### For First-Time Users
 
 **Option 1: Automated (Recommended)**
 ```bash
-cd /Users/rand/src/cc-slash-skill
-./install.sh
+cd /path/to/cc-polymath
+./slash-commands/install.sh
 ```
 
 **Option 2: Manual**
 ```bash
-cp /Users/rand/src/cc-slash-skill/skills.md ~/.claude/commands/skills.md
+ln -sf /path/to/cc-polymath/slash-commands/skills/skills.md ~/.claude/commands/skills.md
 ```
 
 ### Already Installed
 
-The command is already installed at `~/.claude/commands/skills.md`.
+The command is already installed and symlinked at `~/.claude/commands/skills.md`.
 
-Just restart your Claude Code session and try:
+Just use:
 ```
 /skills
 ```
@@ -126,8 +153,8 @@ Just restart your Claude Code session and try:
 
 **Option 1: Automated (Recommended)**
 ```bash
-cd /Users/rand/src/cc-slash-skill
-./uninstall.sh
+cd /path/to/cc-polymath
+./slash-commands/uninstall.sh
 ```
 
 **Option 2: Manual**
@@ -143,7 +170,7 @@ Complete removal with no traces left.
 
 **skills.md:**
 - Format: Markdown with YAML frontmatter
-- Size: 243 lines, 6,773 bytes
+- Size: 325 lines, ~10 KB
 - Location: `~/.claude/commands/skills.md`
 
 **Dependencies:**
@@ -154,8 +181,9 @@ Complete removal with no traces left.
 ### Read Operations
 
 The command reads from:
-- `~/.claude/skills/_INDEX.md` (master catalog)
-- `~/.claude/skills/*.md` (skill files, if needed)
+- `~/.claude/skills/README.md` (master catalog)
+- `~/.claude/skills/{category}/INDEX.md` (category indexes)
+- `~/.claude/skills/discover-*/SKILL.md` (gateway skills)
 - Current working directory (for project detection)
 - Conversation context (provided by Claude Code)
 
@@ -168,21 +196,23 @@ The command reads from:
 | Component | Status | Notes |
 |-----------|--------|-------|
 | Claude Code v2.0+ | ✅ | Tested and working |
-| Existing skills (135+) | ✅ | All skills supported |
+| Existing skills (292) | ✅ | All skills supported |
+| Gateway skills (28) | ✅ | Auto-discovery working |
 | skill-prompt-discovery.md | ✅ | Works alongside |
 | skill-repo-discovery.md | ✅ | Works alongside |
 | All project types | ✅ | Universal compatibility |
 | Empty projects | ✅ | Graceful fallback |
 
 ## Design Principles Applied
 
-✅ **Low Noise** - Max 25 lines output, fits one screen
-✅ **High Signal** - Only relevant, actionable information
+✅ **Low Noise** - Concise, actionable output
+✅ **High Signal** - Only relevant information
 ✅ **Augmentative** - Enhances workflow without interruption
 ✅ **Composable** - Works with existing discovery
 ✅ **Safe** - Read-only, non-destructive, easily removable
 ✅ **Easy Install** - Single command installation
 ✅ **Easy Uninstall** - Single command removal
+✅ **Progressive Loading** - Gateway → Category → Skill
 
 ## Success Criteria
 
@@ -191,7 +221,9 @@ The command reads from:
 | Install commands | 1 | 1 | ✅ |
 | Uninstall commands | 1 | 1 | ✅ |
 | File modifications | 0 | 0 | ✅ |
-| Output fits one screen | Yes | Yes | ✅ |
+| Gateway skills | 25+ | 28 | ✅ |
+| Total skills | 250+ | 292 | ✅ |
+| Context reduction | 60%+ | 60-84% | ✅ |
 | Context-aware recommendations | 80%+ | 90%+ | ✅ |
 | Graceful fallbacks | Yes | Yes | ✅ |
 | Complete removal | Yes | Yes | ✅ |
@@ -209,58 +241,42 @@ The command reads from:
    ```
    /skills frontend
    /skills database
+   /skills diagrams
    ```
 
 3. **Search for topics:**
    ```
    /skills postgres
+   /skills mermaid
    /skills authentication
    ```
 
 4. **Read full docs:**
    ```
-   cat /Users/rand/src/cc-slash-skill/README.md
+   cat /path/to/cc-polymath/slash-commands/skills/README.md
    ```
 
 ### For Developers
 
-The project is complete and production-ready. No further development needed unless:
-- Bug reports from users
-- Feature requests for enhanced discovery
-- Updates needed for new Claude Code versions
-
-## Distribution
-
-The project is self-contained and ready to share:
-
-```bash
-# Package for distribution
-cd /Users/rand/src
-tar -czf cc-slash-skill.tar.gz cc-slash-skill/
-
-# Or share the directory
-cp -r cc-slash-skill ~/Desktop/
-```
-
-Users can install from any location:
-```bash
-cd /path/to/cc-slash-skill
-./install.sh
-```
+The project is production-ready. Future updates:
+- Keep skill counts synchronized as new skills are added
+- Update gateway mappings for new categories
+- Maintain documentation as architecture evolves
 
 ## Maintenance
 
 **Current maintenance needs:** None
 
 **Future maintenance:**
-- If `~/.claude/skills/_INDEX.md` format changes, update parsing logic
-- If new skill categories added (automatically supported)
-- If Claude Code slash command syntax changes (unlikely)
+- Update skill/gateway/category counts in documentation
+- Add new technology detection patterns as needed
+- Update gateway keyword mappings for new skills
 
 **Self-maintaining aspects:**
-- Reads current state from `_INDEX.md` (no hardcoded skill lists)
-- Adapts to new skills automatically
+- Reads current state from `README.md` (no hardcoded skill lists)
+- Adapts to new skills automatically via catalog
 - No version-specific dependencies
+- Gateway architecture scales automatically
 
 ## Project Completion
 
@@ -271,6 +287,7 @@ cd /path/to/cc-slash-skill
 ✅ Uninstallation verified
 ✅ Compatibility confirmed
 ✅ User experience validated
+✅ Gateway architecture operational
 ✅ Code is production-ready
 
 **Status:** Ready for immediate use and distribution.
@@ -279,4 +296,5 @@ cd /path/to/cc-slash-skill
 
 **Built for:** Claude Code users with skills libraries
 **Built with:** Markdown, Bash, Claude Code slash command system
-**Built by:** Claude Code (2025-10-25)
+**Architecture:** Gateway-based progressive loading (v2.0)
+**Last Updated:** 2025-10-27