Skip to content

v5.2.0: New /memory:skill-memory Command - SKILL Package Generator

Choose a tag to compare

View all tags
@catlog22 catlog22 released this 03 Nov 09:42
· 1370 commits to main since this release
v5.2.0
2547150

🎉 New Command: /memory:skill-memory - SKILL Package Generator

Automatically generates progressive-loading SKILL packages from project documentation with intelligent 4-phase orchestration and path mirroring.

🚀 Core Features

4-Phase Orchestrator

Fully automated workflow from documentation to SKILL package:

  1. Phase 1: Prepare - Parse arguments, check existing docs, handle --regenerate
  2. Phase 2: Plan - Call /memory:docs to create documentation tasks
  3. Phase 3: Execute - Call /workflow:execute to generate documentation files
  4. Phase 4: Index - Generate SKILL.md with progressive loading structure

Auto-Continue Mechanism: All phases run autonomously via TodoList tracking - zero manual steps required.

Progressive Loading (4 Levels)

Token-budgeted documentation access:

  • Level 0: Quick Start (~2K tokens) - README only
  • Level 1: Core Modules (~8K tokens) - Module READMEs
  • Level 2: Complete (~25K tokens) - All modules + Architecture
  • Level 3: Deep Dive (~40K tokens) - Everything + Examples

Path Mirroring Strategy

SKILL knowledge structure mirrors source code hierarchy:

Source: my_app/src/modules/auth/
  ↓
Docs: .workflow/docs/my_app/src/modules/auth/API.md
  ↓
SKILL: .claude/skills/my_app/knowledge/src/modules/auth/API.md

📋 Command Usage

/memory:skill-memory [path] [--tool <gemini|qwen|codex>] [--regenerate] [--mode <full|partial>] [--cli-execute]

Examples:

# Generate SKILL package for current project
/memory:skill-memory

# Force regeneration with Qwen
/memory:skill-memory --tool qwen --regenerate

# Partial mode (modules only)
/memory:skill-memory --mode partial

# CLI execution mode
/memory:skill-memory --cli-execute

📦 Output Structure

.claude/skills/{project_name}/
├── SKILL.md                    # Index with progressive loading levels
└── knowledge/                  # Mirrored documentation structure
    └── src/modules/auth/
        ├── API.md
        └── README.md

SKILL Package Features:

  • ✅ Progressive loading (2K → 40K tokens)
  • ✅ Path mirroring for easy navigation
  • ✅ Intelligent capability detection
  • ✅ Automatic trigger phrase generation
  • ✅ Regeneration support with single flag

🔄 Enhanced /memory:docs Command

Secondary improvements to documentation workflow:

  • ✅ Smart Task Grouping - ≤7 documents per task (up from 5)
  • ✅ Context Sharing - Prefer grouping 2 top-level directories for shared Gemini analysis
  • ✅ Batch Processing - Reduced task count through intelligent grouping
  • ✅ Dual Execution Modes - Agent Mode (default) and CLI Mode (--cli-execute)
  • ✅ Pre-computed Analysis - Phase 2 unified analysis eliminates redundant CLI calls
  • ✅ Conflict Resolution - Automatic splitting when exceeding document limit

⚡ Performance Benefits

SKILL Package Generation:

  • 📦 Zero manual steps - fully automated 4-phase workflow
  • 📦 Progressive loading - load only what you need
  • 📦 Auto-discovery - intelligent capability extraction

Documentation Workflow:

  • ⚡ Parallel processing - multiple directory groups execute concurrently
  • ⚡ Context sharing - single Gemini call per task group (2 directories)
  • ⚡ Efficient analysis - one-time analysis in Phase 2, reused by all tasks
  • ⚡ Predictable sizing - ≤7 docs per task ensures reliable completion

🛠️ Technical Details

New File:

  • .claude/commands/memory/skill-memory.md (822 lines)

Modified Files:

  • .claude/commands/memory/docs.md - Enhanced with batch processing and smart grouping
  • .claude/agents/doc-generator.md - Mode-aware execution support

Multi-Tool Support:

  • Gemini (default) - Comprehensive documentation
  • Qwen - Architecture analysis focus
  • Codex - Implementation validation

Previous Version: v5.1.0
Full Changelog: v5.1.0...v5.2.0

Assets 2
Loading