@codihaus/claude-skills 1.6.19 → 1.6.21

package/bin/cli.js

@@ -23,6 +23,7 @@ program
   .option('--all', 'Install all skills (default)', true)
   .option('--no-deps', 'Skip dependency checking')
   .option('--no-hooks', 'Skip hooks setup')
+  .option('-k, --knowledge <path>', 'Path to custom knowledge base to install')
   .option('-y, --yes', 'Skip confirmation prompts')
   .action(init);
 

package/knowledge/stacks/_index.md

@@ -28,7 +28,7 @@ Each stack follows this structure:
 
 ```
 stacks/{stack-name}/
-├── _index.md           # Main knowledge file
+├── _index.md           # Main knowledge file (always read first)
 │   ├── Overview        # What it is, when to use
 │   ├── Best Practices  # Patterns to follow
 │   ├── Anti-Patterns   # What to avoid
@@ -37,17 +37,43 @@ stacks/{stack-name}/
 │   ├── For /dev-review # Review checklists
 │   └── Integration     # How it works with other stacks
 │
-├── references/         # Detailed documentation
+├── references/         # Detailed documentation (load as needed)
 │   ├── api.md          # API reference
 │   ├── patterns.md     # Common patterns
 │   └── performance.md  # Performance optimization
 │
-└── assets/             # Code templates
+└── assets/             # Code templates (load as needed)
     ├── composable.ts   # Example composable
     ├── component.vue   # Example component
     └── config.ts       # Example config
 ```
 
+## Loading Knowledge
+
+Skills can load knowledge in two ways:
+
+### 1. Quick Reference (Default)
+Load only `_index.md` for overview and skill-specific guidance:
+```
+Read knowledge/stacks/{stack}/_index.md
+```
+
+### 2. Deep Dive (When Needed)
+Use `_knowledge.json` to discover and load additional files:
+```
+1. Read knowledge/_knowledge.json → Get file list for {stack}
+2. Read knowledge/stacks/{stack}/_index.md → Main guidance
+3. Read knowledge/stacks/{stack}/references/patterns.md → Detailed patterns
+4. Read knowledge/stacks/{stack}/references/performance.md → Performance tips
+```
+
+### When to Load More Than _index.md
+
+- **Specs**: Usually `_index.md` is enough (high-level patterns)
+- **Coding**: Load `references/` when implementing complex features
+- **Review**: Load `references/performance.md` for performance reviews
+- **Architecture**: Load `references/` for deep architectural decisions
+
 ## How Skills Use Stack Knowledge
 
 ### /dev-scout

package/knowledge/stacks/nextjs/_index.md

@@ -637,6 +637,31 @@ if (process.env.NODE_ENV !== 'production') {
 }
 ```
 
+## Advanced RSC & Performance Patterns
+
+**See `references/rsc-patterns.md` for comprehensive Next.js optimization guide covering**:
+- Eliminating waterfalls (defer await, dependency parallelization, Promise.all)
+- Server-side performance (LRU caching, serialization, React.cache, after())
+- Bundle optimization (avoid barrel imports, dynamic imports, preloading)
+- Data fetching strategies (auto-deduplication, SWR, caching)
+- Server Actions best practices
+
+**Critical patterns**:
+- **Defer await until needed** - Don't block unused code paths
+- **Start promises early** - Enable parallelization in API routes
+- **Component composition** - Move async calls to components for parallel execution
+- **Minimize serialization** - Only pass needed fields across RSC boundary
+- **React.cache()** - Deduplicate DB queries, auth checks, heavy computations
+- **after()** - Schedule non-blocking work (analytics, logging)
+- **Avoid barrel imports** - Use optimizePackageImports or direct imports
+- **LRU caching** - Share data across requests (especially with Fluid Compute)
+
+**Impact metrics**:
+- Eliminating waterfalls: 2-10× faster
+- Avoiding barrel imports: 15-70% faster builds
+- LRU caching: Eliminates redundant queries
+- after() for non-blocking: 50-200ms faster responses
+
 ## Resources
 
 ### Official Docs
@@ -644,6 +669,11 @@ if (process.env.NODE_ENV !== 'production') {
 - App Router: https://nextjs.org/docs/app
 - Learn: https://nextjs.org/learn
 
+### Performance & Patterns
+- Vercel Best Practices: https://github.com/vercel/react-best-practices
+- See `references/rsc-patterns.md` - Detailed RSC & optimization guide
+- See `references/performance.md` - Next.js performance optimizations
+
 ### Context7 Queries
 
 ```
@@ -651,4 +681,6 @@ Query: "Next.js 15 App Router data fetching"
 Query: "Next.js Server Actions best practices"
 Query: "Next.js middleware authentication"
 Query: "Next.js Server Components patterns"
+Query: "Next.js RSC waterfall elimination"
+Query: "Next.js bundle optimization barrel imports"
 ```