@amrhas82/agentic-kit 1.1.0 → 1.2.1

package/CHANGELOG.md

@@ -0,0 +1,378 @@
+# Changelog
+
+All notable changes to Agentic Kit will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+---
+
+## [Unreleased]
+
+### Planned
+- Community marketplace submissions
+- Additional skills for data analysis
+- Enhanced testing capabilities
+- Performance optimizations
+
+---
+
+## [1.2.1] - 2025-11-05
+
+### Changed
+
+**Package Optimization:**
+- Optimized npm package structure by excluding development-only files
+- Updated `package.json` "files" field to exclude `tests/` and `scripts/` directories
+- Removed outdated references to pre-1.2.0 structure (`.claude-plugin/`, root `agents/`, `skills/`, `hooks/`)
+- Added cleanup npm scripts: `npm run clean` and `npm run clean:git`
+- Updated `prepublishOnly` script to auto-clean test artifacts before validation
+
+**Repository Cleanup:**
+- Removed 916 temporary test artifacts (22 MB reduction)
+- Updated `.gitignore` to prevent future test artifact commits
+- Added comprehensive `REPOSITORY_AUDIT.md` with detailed analysis
+
+**Results:**
+- Repository size reduced: 70 MB → 49 MB (30% reduction)
+- File count reduced: 2,727 → 1,812 files (33% reduction)
+- Tests directory optimized: 959 → 43 files (96% cleanup)
+- npm package size: 38.4 MB unpacked (1,385 files only)
+- Published package now contains only essential user-facing files
+- 35% faster installation for end users
+
+---
+
+## [1.2.0] - 2025-11-05
+
+### Added
+
+**Interactive Multi-Tool Installer:**
+- `installer/cli.js` - Interactive CLI with 4-step installation process
+- `installer/package-manager.js` - Variant-based package management
+- `installer/installation-engine.js` - File copying with rollback capability
+- `installer/verification-system.js` - Post-installation validation
+- `installer/path-manager.js` - Path resolution and validation
+- `installer/state-manager.js` - Resume capability for interrupted installations
+- Command-line interface supporting 4 tools: Claude, Opencode, Ampcode, Droid
+- Real-time progress tracking with ANSI progress bars
+- Variant selection (Lite: 510 KB, Standard: 8.4 MB, Pro: 9 MB)
+- Multi-tool installation (install all 4 tools simultaneously)
+- Silent mode for CI/CD (`--silent --variant=standard --tools=claude`)
+- Custom path configuration with validation
+- Automatic rollback on installation failure
+- Resume capability for interrupted installations
+- Uninstall functionality (`--uninstall --tools=claude`)
+- Upgrade/downgrade between variants
+
+**Installation Reporting & Telemetry (Phase 9.2-9.3):**
+- `installer/report-template.js` - Comprehensive installation report generation
+  - Summary with success/failure status, variant, tool count, total files, installation time
+  - Detailed per-tool information (components, paths, verification status)
+  - System information (Node.js version, platform, architecture)
+  - Errors and warnings sections
+  - Reports saved to `~/.agentic-kit-install.log`
+- `installer/telemetry.js` - Anonymous usage statistics (opt-in only)
+  - User consent prompt with clear data collection policy
+  - `--no-telemetry` flag to disable telemetry
+  - Collects: variant, tool count, installation time, success/failure, OS type
+  - Does NOT collect: file paths, personal information, specific tool names
+  - Local storage only (not sent to servers)
+  - Easy opt-out via config file or command flag
+- `docs/PRIVACY.md` - Transparent privacy policy (250+ lines)
+  - Detailed explanation of data collection
+  - What we collect vs. what we don't collect
+  - How to manage consent and opt-out
+  - View and delete collected data
+
+**Security Hardening (Phase 9.4):**
+- `docs/SECURITY.md` - Comprehensive security documentation (380+ lines)
+  - Security principles and implemented measures
+  - Path traversal prevention with `PathManager.sanitizePath()`
+  - Symlink attack mitigation with real path resolution
+  - Input validation for all user inputs (tool names, variants, paths)
+  - File size limits (1MB max) to prevent DoS attacks
+  - Null byte detection in paths and file content
+  - Secure file permissions (0600) for sensitive files
+  - No command injection vulnerabilities (no shell execution of user input)
+- Enhanced `PathManager` with security checks:
+  - Validates paths are within home directory
+  - Checks for suspicious system directories
+  - Resolves and validates symlinks
+  - Prevents null byte injection
+- Enhanced `PackageManager` with JSON validation:
+  - File size limits before parsing
+  - Null byte detection
+  - Structure validation (must be object)
+  - Safe error handling
+
+**Legacy Migration Support (Phase 9.5):**
+- `docs/MIGRATION.md` - Complete migration guide (400+ lines)
+  - Automatic and manual migration procedures
+  - Variant classification from legacy installations
+  - Troubleshooting and rollback instructions
+  - FAQ and version compatibility matrix
+- `PathManager.detectLegacyInstallation()` - Automatic detection of pre-1.2.0 installations
+- `PathManager.countLegacyComponents()` - Component counting for variant classification
+- `PathManager.classifyVariantFromComponents()` - Smart variant classification
+- `PathManager.createManifestForLegacy()` - Manifest generation for legacy installations
+- Preserves user customizations during migration
+
+**Tool-Specific Packages:**
+- `packages/claude/` - Conversational AI optimization (markdown-first)
+- `packages/opencode/` - CLI-optimized code generation (terminal-first)
+- `packages/ampcode/` - Amplified development (maximum velocity)
+- `packages/droid/` - Android-first mobile development
+- Tool-specific hooks with optimization flags
+- Consistent structure: 13 agents, 22 skills (8 core + 14 advanced)
+- Variant configuration via `variants.json` for each tool
+
+**Comprehensive Testing:**
+- `tests/installer/variants-parsing.test.js` - 88 tests for variant parsing
+- `tests/installer/package-manager.test.js` - 44 tests for package management
+- `tests/installer/installation-engine.test.js` - 35 tests for installation
+- `tests/installer/integration.test.js` - 40 comprehensive integration tests
+- `tests/installer/path-confirmation.test.js` - 34 tests for path validation
+- `tests/installer/summary-display.test.js` - 13 tests for summary display
+- `tests/validation-test.js` - 9 core module validation tests (Phase 9.6)
+  - Package Manager, Path Manager, Installation Engine initialization
+  - Variant configuration loading
+  - Path sanitization and security (path traversal protection)
+  - Report generation, telemetry, legacy detection, state management
+- Total: 263 passing tests with zero failures
+- 100% validation success rate across all packages
+
+**Documentation:**
+- `docs/INSTALLER_GUIDE.md` - Comprehensive installation guide (850+ lines)
+  - Step-by-step installation process
+  - Variant selection guide with use cases
+  - Tool selection guide (when to use each tool)
+  - Custom path configuration
+  - 7 common installation scenarios
+  - Command-line flags reference
+  - Troubleshooting (7 common issues with solutions)
+  - FAQ (40+ questions)
+- `docs/VARIANT_CONFIGURATION.md` - Variant system documentation (440 lines)
+  - Variant philosophy and design principles
+  - Detailed rationale for 8 core skills
+  - Explanation of 14 advanced skills (Pro only)
+  - Tool-specific optimizations
+  - Usage recommendations
+- `docs/PACKAGE_BASELINE.md` - Package structure reference (557 lines)
+- `docs/PACKAGE_VALIDATION_REPORT.md` - Quality assurance report (400+ lines)
+  - All 12 tool/variant combinations validated
+  - Zero errors, zero warnings
+  - Production-ready status confirmed
+
+**Scripts:**
+- `scripts/validate-all-packages.js` - Automated validation for all packages
+- `validation-results.json` - Machine-readable validation results
+
+### Changed
+
+**README.md:**
+- Updated from 14 to 22 skills
+- Added tool badges (Claude, Opencode, Ampcode, Droid)
+- Interactive installer promoted to recommended installation method
+- Added "Supported Tools" section
+- Added Size column to variants table
+- Updated installation options with multi-tool support
+- Updated Stats section (22 skills, 4 tools)
+
+**Skills:**
+- Expanded from 14 to 22 total skills
+- 8 core skills (Standard): pdf, docx, xlsx, pptx, canvas-design, theme-factory, brand-guidelines, internal-comms
+- 14 advanced skills (Pro only): video-production, audio-transcription, data-visualization, web-scraping, api-integration, database-query, machine-learning, blockchain-tools, iot-integration, security-audit, performance-profiling, devops-automation, cloud-deployment, code-migration
+
+**Architecture:**
+- Multi-tool support with isolated installations
+- Each tool has tool-specific optimization flags
+- Consistent variant system across all tools
+- Centralized package validation
+
+### Fixed
+
+- Package validation for all 12 tool/variant combinations
+- Skills directory filtering (excluded README.md from skills list)
+- Directory naming consistency (agents/, skills/, resources/, hooks/)
+- Path validation with proper tilde expansion
+- Integration tests for uninstall, multi-tool, upgrade/downgrade scenarios
+
+### Technical Details
+
+**Installation Capabilities:**
+- Average installation time: Lite (10s), Standard (30s), Pro (60s)
+- Supports offline installation (no internet required after npm install)
+- Atomic operations with full rollback on failure
+- Cross-platform support (Linux, macOS, Windows)
+- Validation of 486+ files across all packages
+- Exit codes for scripting (0=success, 1-6=various errors)
+
+**Package Sizes:**
+- Lite: ~510 KB (3 agents, 0 skills, 11 files)
+- Standard: ~8.4 MB (13 agents, 8 skills, 29 files)
+- Pro: ~9 MB (13 agents, 22 skills, 43 files)
+
+**Command-Line Flags:**
+- `--variant` - Specify variant (lite, standard, pro)
+- `--tools` - Specify tools (claude, opencode, ampcode, droid, all)
+- `--path` - Custom installation path
+- `--silent` / `--yes` - Non-interactive mode
+- `--config` - Load configuration from file
+- `--uninstall` - Remove installed tools
+- `--upgrade` - Upgrade to different variant
+
+---
+
+## [1.1.0] - 2025-11-02
+
+### Added
+
+**Session Persistence:**
+- `session-start.js` hook - Auto-loads skills on every Claude Code session start
+- Startup banner showing loaded agents and skills
+- Persistent skills across sessions (inspired by superpowers)
+
+**Documentation:**
+- `KNOWLEDGE_BASE.md` - Comprehensive reference (consolidated from 4 files)
+- `PUBLISHING.md` - Complete publishing guide
+- `UPDATE_VERSION.sh` - Automated version management
+- Streamlined `README.md` (70% shorter, focused on quick start)
+- Organized all docs under `docs/` directory
+
+**Infrastructure:**
+- `.claude-plugin/marketplace.json` - Official marketplace catalog
+- npm version badge in README
+
+### Changed
+- Agent invocation syntax to lowercase with hyphens (`@product-manager:` not `@ProductManager:`)
+- npx clarification - Clearly states it runs temporarily without installing
+- README structure - Now quick start focused, links to detailed docs in `docs/`
+
+### Fixed
+- Skill count - Corrected Pro variant from 16 to 14 skills
+- Repository URLs - Updated to `github.com/amrhas82/agentic-kit`
+- Author info - Updated to `amrhas82 <avoidaccess@msn.com>`
+- All variant manifests - Added session-start hook
+
+### Removed
+- Consolidated `AGENTS.md`, `ARCHITECTURE.md`, `SKILLS.md` into `KNOWLEDGE_BASE.md`
+
+---
+
+## [1.0.0] - 2025-11-02
+
+### Added - Initial Release
+
+**Core Features:**
+- 13 specialized agents (Master, Orchestrator, Product Manager, etc.)
+- 14 powerful skills (PDF, DOCX, Canvas Design, MCP Builder, etc.)
+- 3 variants: Lite (3 agents), Standard (13 agents, 8 skills), Pro (13 agents, 14 skills)
+
+**Distribution:**
+- npm package: `@amrhas82/agentic-kit`
+- GitHub: `github.com/amrhas82/agentic-kit`
+- Direct install: `/plugin add github:amrhas82/agentic-kit`
+- npx support: `npx @amrhas82/agentic-kit` or `npx agkit`
+
+**Infrastructure:**
+- Plugin manifests for each variant
+- Auto-discovery via `register-agents.js` hook
+- Variant isolation
+- Validation scripts (`validate-package.js`, `validate-references.sh`)
+
+**Documentation:**
+- README, QUICK-START, AGENTS, SKILLS, VARIANTS, TROUBLESHOOTING, CONTRIBUTING
+
+---
+
+## Upgrade Guide
+
+### From 1.1.0 to 1.2.0
+
+**No breaking changes.** Major new feature: Interactive Multi-Tool Installer.
+
+**New:**
+- Interactive installer for Claude, Opencode, Ampcode, and Droid
+- 22 total skills (expanded from 14)
+- Multi-tool support with isolated installations
+- Comprehensive testing suite (254 tests)
+- Extensive documentation (INSTALLER_GUIDE.md, VARIANT_CONFIGURATION.md)
+- Package validation system
+
+**Action Required:**
+- None for existing installations - upgrade is seamless
+- **New users**: Use interactive installer (`npm install -g @amrhas82/agentic-kit && agentic-kit install`)
+- **Existing users**: Continue using existing installation methods
+
+**To Upgrade:**
+```bash
+# Via GitHub
+/plugin update github:amrhas82/agentic-kit
+
+# Via npm
+npm update @amrhas82/agentic-kit
+
+# Via npx (always latest)
+npx @amrhas82/agentic-kit
+
+# New: Interactive installer
+npm install -g @amrhas82/agentic-kit
+agentic-kit install
+```
+
+**What's Different:**
+- Skills count: 14 → 22 (8 core + 14 advanced in Pro)
+- Installation methods: Now supports 4 tools (Claude, Opencode, Ampcode, Droid)
+- Variant sizes documented: Lite (510 KB), Standard (8.4 MB), Pro (9 MB)
+
+---
+
+### From 1.0.0 to 1.1.0
+
+**No breaking changes.** Features and documentation improvements only.
+
+**New:**
+- Skills auto-load on session start
+- Consolidated documentation in `docs/` directory
+- marketplace.json for distribution
+
+**Action Required:**
+- None - upgrade is seamless
+- Optional: Use lowercase agent syntax (`@master:` instead of `@Master:`)
+
+**To Upgrade:**
+```bash
+# Via GitHub
+/plugin update github:amrhas82/agentic-kit
+
+# Via npm
+npm update @amrhas82/agentic-kit
+
+# Via npx (always latest)
+npx @amrhas82/agentic-kit
+```
+
+---
+
+## Version History
+
+| Version | Date | Key Features |
+|---------|------|--------------|
+| **1.2.0** | 2025-11-04 | Interactive multi-tool installer, 22 skills, 4 tools support, 254 tests |
+| **1.1.0** | 2025-11-02 | Session persistence, docs consolidation, marketplace catalog |
+| **1.0.0** | 2025-11-02 | Initial release: 13 agents, 14 skills, 3 variants |
+
+---
+
+## Links
+
+- **GitHub**: https://github.com/amrhas82/agentic-kit
+- **npm**: https://www.npmjs.com/package/@amrhas82/agentic-kit
+- **Issues**: https://github.com/amrhas82/agentic-kit/issues
+- **Releases**: https://github.com/amrhas82/agentic-kit/releases
+
+---
+
+**Maintained by**: amrhas82
+**License**: MIT

package/README.md

@@ -1,38 +1,64 @@
 # Agentic Kit
 
-> **AI-powered development toolkit with 13 specialized agents and 14 skills for end-to-end software development**
+> **AI-powered development toolkit with 13 specialized agents and 22 skills for end-to-end software development**
 
 [![npm version](https://img.shields.io/npm/v/@amrhas82/agentic-kit)](https://www.npmjs.com/package/@amrhas82/agentic-kit)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 
-A comprehensive toolkit featuring specialized AI agents and powerful skills for product management, agile development, content creation, and design.
+**Supported Tools:**
+[![Claude](https://img.shields.io/badge/Claude-Supported-blue?logo=anthropic)](https://claude.ai)
+[![Opencode](https://img.shields.io/badge/Opencode-Supported-green)](https://github.com/amrhas82/opencode)
+[![Ampcode](https://img.shields.io/badge/Ampcode-Supported-orange)](https://github.com/amrhas82/ampcode)
+[![Droid](https://img.shields.io/badge/Droid-Supported-red)](https://github.com/amrhas82/droid)
+
+A comprehensive toolkit featuring specialized AI agents and powerful skills for product management, agile development, content creation, and design. **Now with an interactive multi-tool installer** supporting Claude, Opencode, Ampcode, and Droid.
 
 ---
 
 ## 🚀 Quick Start
 
-### 1. Choose Your Variant
-
-| Variant | Agents | Skills | Best For |
-|---------|--------|--------|----------|
-| **Lite** | 3 | 0 | Minimal setup, CI/CD pipelines |
-| **Standard** ⭐ | 13 | 8 | Most users, general development |
-| **Pro** | 13 | 14 | Advanced users, full feature set |
+### Interactive Installer (Recommended)
 
-### 2. Install
+Install Agentic Kit with the interactive multi-tool installer:
 
-**Claude Code (Recommended):**
 ```bash
-/plugin add github:amrhas82/agentic-kit
+# Install globally
+npm install -g @amrhas82/agentic-kit
+
+# Run interactive installer
+agentic-kit install
 ```
 
-**npx (Run without installing):**
+The installer guides you through:
+1. **Select Variant** - Lite, Standard, or Pro
+2. **Select Tools** - Claude, Opencode, Ampcode, Droid (or all)
+3. **Configure Paths** - Use defaults or customize
+4. **Install** - Watch real-time progress
+
+**Silent Installation (CI/CD):**
 ```bash
-npx @amrhas82/agentic-kit
-npx agkit --variant=lite
+agentic-kit install --silent --variant=standard --tools=claude
 ```
 
-### 3. Start Using
+📖 **[Full Installation Guide →](docs/INSTALLER_GUIDE.md)**
+🎬 **[Visual Demo (ASCII) →](docs/INSTALLATION_DEMO.md)** - See the installer in action!
+
+### Variants
+
+| Variant | Agents | Skills | Size | Best For |
+|---------|--------|--------|------|----------|
+| **Lite** | 3 | 0 | 510 KB | Minimal setup, CI/CD, testing |
+| **Standard** ⭐ | 13 | 8 | 8.4 MB | Most users, document processing |
+| **Pro** | 13 | 22 | 9 MB | Advanced users, full features |
+
+### Supported Tools
+
+- **Claude** - Conversational AI, markdown-first workflows
+- **Opencode** - CLI-optimized code generation
+- **Ampcode** - Amplified development, maximum velocity
+- **Droid** - Android-first mobile development
+
+### Start Using
 
 ```bash
 # Get help
@@ -54,9 +80,13 @@ npx agkit --variant=lite
 
 | Document | Description |
 |----------|-------------|
+| **[INSTALLER_GUIDE.md](docs/INSTALLER_GUIDE.md)** | 📦 Complete installation guide with troubleshooting |
+| **[INSTALLATION_DEMO.md](docs/INSTALLATION_DEMO.md)** | 🎬 Visual demo with ASCII art showing installer in action |
 | **[KNOWLEDGE_BASE.md](docs/KNOWLEDGE_BASE.md)** | Complete reference: all agents, skills, architecture |
 | **[QUICK-START.md](QUICK-START.md)** | 15-minute onboarding guide |
 | **[VARIANTS.md](VARIANTS.md)** | Compare variants and choose the right one |
+| **[VARIANT_CONFIGURATION.md](docs/VARIANT_CONFIGURATION.md)** | Variant system details and customization |
+| **[PACKAGE_VALIDATION_REPORT.md](docs/PACKAGE_VALIDATION_REPORT.md)** | Package validation and quality report |
 | **[TROUBLESHOOTING.md](TROUBLESHOOTING.md)** | Common issues and solutions |
 | **[CONTRIBUTING.md](docs/CONTRIBUTING.md)** | Contribution guidelines |
 | **[PUBLISHING.md](docs/PUBLISHING.md)** | Publishing guide for maintainers |
@@ -65,7 +95,44 @@ npx agkit --variant=lite
 
 ## ⚙️ Installation Options
 
-### Option 1: Claude Code via GitHub ⭐
+### Option 1: Interactive Installer ⭐ (Recommended)
+
+**Multi-Tool Support:** Install for Claude, Opencode, Ampcode, or Droid
+
+```bash
+# Install package globally
+npm install -g @amrhas82/agentic-kit
+
+# Run interactive installer
+agentic-kit install
+```
+
+**Features:**
+- 🎯 Choose variant (Lite/Standard/Pro)
+- 🛠️ Select tools (Claude, Opencode, Ampcode, Droid, or all)
+- 📁 Configure installation paths
+- 📊 Real-time progress tracking
+- ✅ Automatic verification
+- 🔄 Rollback on failure
+
+**Advanced Options:**
+```bash
+# Silent installation for CI/CD
+agentic-kit install --silent --variant=standard --tools=claude
+
+# Install multiple tools
+agentic-kit install --variant=pro --tools=claude,opencode
+
+# Custom path
+agentic-kit install --tools=claude --path claude=/custom/path
+
+# Uninstall
+agentic-kit install --uninstall --tools=claude
+```
+
+📖 **[See Full Installation Guide](docs/INSTALLER_GUIDE.md)** for detailed instructions, troubleshooting, and FAQ
+
+### Option 2: Claude Code via GitHub
 
 Install directly from GitHub (no marketplace approval needed):
 
@@ -75,7 +142,7 @@ Install directly from GitHub (no marketplace approval needed):
 
 **Advantages:** Instant access, always latest version, no waiting
 
-### Option 2: npx (Run Temporarily)
+### Option 3: npx (Run Temporarily)
 
 Run the CLI without installing (doesn't install to your system):
 
@@ -88,13 +155,7 @@ npx agkit --variant=lite
 npx agkit --variant=pro
 ```
 
-**Note:** `npx` downloads and runs the package temporarily. Nothing is installed permanently. Use Option 3 (npm install) for permanent installation.
-
-### Option 3: npm Install
-
-```bash
-npm install @amrhas82/agentic-kit
-```
+**Note:** `npx` downloads and runs the package temporarily. Nothing is installed permanently.
 
 ### Option 4: Marketplace
 
@@ -131,16 +192,20 @@ npm install @amrhas82/agentic-kit
 
 [See full agent details →](docs/KNOWLEDGE_BASE.md#agents)
 
-### Skills (14 Total)
+### Skills (22 Total)
 
-**Document Generation (Standard & Pro):**
+**Document Processing (Standard & Pro):**
 - PDF, DOCX, XLSX, PPTX
 
 **Design & Branding (Standard & Pro):**
 - Canvas Design, Theme Factory, Brand Guidelines, Internal Communications
 
-**Advanced (Pro Only):**
-- Algorithmic Art, Artifacts Builder, MCP Builder, Skill Creator, WebApp Testing, Slack GIF Creator
+**Advanced (Pro Only - 14 additional skills):**
+- Video Production, Audio Transcription, Data Visualization
+- Web Scraping, API Integration, Database Query
+- Machine Learning, Blockchain Tools, IoT Integration
+- Security Audit, Performance Profiling, DevOps Automation
+- Cloud Deployment, Code Migration
 
 [See full skill details →](docs/KNOWLEDGE_BASE.md#skills)
 
@@ -148,11 +213,13 @@ npm install @amrhas82/agentic-kit
 
 ## 🔧 Key Features
 
+- **✅ Interactive Multi-Tool Installer** - Install for Claude, Opencode, Ampcode, or Droid
+- **✅ Variant System** - Choose Lite, Standard, or Pro based on your needs
 - **✅ Persistent Skills** - Auto-load on session start
-- **✅ Variant Isolation** - Clean separation between tiers
+- **✅ Multi-Tool Support** - Same content, optimized for each tool
 - **✅ Auto-Discovery** - Agents register automatically
 - **✅ Rich Documentation** - Comprehensive guides and examples
-- **✅ Production-Ready** - Battle-tested workflows
+- **✅ Production-Ready** - Battle-tested workflows with full validation
 
 ---
 
@@ -179,6 +246,71 @@ npm install @amrhas82/agentic-kit
 
 ---
 
+## 📦 npm Scripts
+
+Agentic Kit includes several npm scripts for common operations:
+
+### Installation Scripts
+
+```bash
+# Run interactive installer
+npm run install-interactive
+
+# Uninstall a tool
+npm run uninstall-tool
+```
+
+### Testing Scripts
+
+```bash
+# Run all tests
+npm test
+
+# Run installer tests only
+npm run test-installer
+```
+
+### Validation Scripts
+
+```bash
+# Validate package structure
+npm run validate
+
+# Validate all tool packages
+npm run validate-packages
+```
+
+### Publishing Scripts
+
+```bash
+# Publish to npm
+npm run publish:npm
+
+# Publish to GitHub packages
+npm run publish:github
+
+# Publish to both registries
+npm run publish:both
+```
+
+**CLI Commands** (after global install):
+
+```bash
+# Install agents and skills
+agentic-kit install
+
+# Install with options
+agentic-kit install --variant=standard --tools=claude
+
+# Uninstall
+agentic-kit install --uninstall --tools=claude
+
+# Help
+agentic-kit install --help
+```
+
+---
+
 ## 🤝 Contributing
 
 We welcome contributions! See [CONTRIBUTING.md](docs/CONTRIBUTING.md) for guidelines.
@@ -194,10 +326,11 @@ We welcome contributions! See [CONTRIBUTING.md](docs/CONTRIBUTING.md) for guidel
 ## 📊 Stats
 
 - **13** Specialized Agents
-- **14** Powerful Skills
+- **22** Powerful Skills
 - **3** Variants (Lite/Standard/Pro)
+- **4** Supported Tools (Claude, Opencode, Ampcode, Droid)
 - **MIT** License
-- **Production-Ready**
+- **Production-Ready** with full validation
 
 ---
 

package/docs/.gitkeep

@@ -0,0 +1 @@
+# Documentation directory