agentic-flow 1.6.5 → 1.7.2

package/CHANGELOG.md

@@ -5,6 +5,77 @@ All notable changes to this project 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).
 
+## [1.7.2] - 2025-10-19
+
+### Added
+- **Skills System Integration** - Full CLI support for Claude Code Skills management
+  - `npx agentic-flow skills list` - List all installed skills (personal + project)
+  - `npx agentic-flow skills init` - Initialize skills directories (~/.claude/skills and .claude/skills)
+  - `npx agentic-flow skills create` - Create agentic-flow example skills (AgentDB, swarm, reasoningbank)
+  - `npx agentic-flow skills init-builder` - Install skill-builder framework for creating custom skills
+  - `npx agentic-flow skills help` - Show comprehensive skills command documentation
+  - Skills automatically discovered by Claude Code across all surfaces (Claude.ai, CLI, SDK, API)
+
+### Changed
+- **README Updates** - Added comprehensive Skills System documentation
+  - New Skills System section with Quick Start guide
+  - Updated Quick Navigation table to highlight Skills
+  - Updated CLI Commands section with all 5 skills commands
+  - Added skill structure examples with YAML frontmatter
+  - Listed 5 built-in skills: skill-builder, agentdb-memory-patterns, agentdb-vector-search, reasoningbank-intelligence, swarm-orchestration
+
+### Documentation
+- Updated both main README.md and npm package README.md with identical Skills documentation
+- Added skills to Quick Navigation for easy discovery
+- Included benefits: reusable, discoverable, structured, progressive, validated
+
+## [1.7.1] - 2025-10-19
+
+### Fixed
+- **CRITICAL: Skills Top-Level Installation** - Fixed skills to install at top level for Claude Code discovery
+  - **Claude Code requires**: `~/.claude/skills/[skill-name]/` (top level)
+  - **NOT supported**: `~/.claude/skills/namespace/[skill-name]/` (nested subdirectories)
+  - All skills now correctly install at top level: `~/.claude/skills/skill-builder/`, `~/.claude/skills/swarm-orchestration/`, etc.
+  - Skills are now properly discovered by Claude Code after restart
+  - Reverted incorrect v1.7.0 namespace changes that broke skill discovery
+
+### Changed
+- Updated `skills-manager.ts` to install all skills at top level (removed nested namespace)
+- Moved skill source files from `agentic-flow/` subdirectory to top level in `.claude/skills/`
+- Simplified source detection paths
+
+### Documentation
+- Added `docs/plans/skills/SKILLS_TOP_LEVEL_FIX.md` - Explanation of fix and testing
+- Updated `docs/plans/skills/SKILL_INSTALLATION_ANALYSIS.md` - Corrected with top-level requirement
+- Deprecated `docs/plans/skills/MIGRATION_v1.7.0.md` - Namespace approach was incorrect
+
+### Migration
+If you installed skills with v1.7.0:
+```bash
+# Move skills from namespace to top level
+cd ~/.claude/skills
+for skill in agentic-flow/*; do
+  mv "agentic-flow/$skill" "$(basename $skill)"
+done
+rm -rf agentic-flow
+# Restart Claude Code
+```
+
+Or simply reinstall:
+```bash
+npx agentic-flow skills init personal --with-builder
+```
+
+## [1.6.6] - 2025-10-18
+
+### Changed
+
+- **AgentDB v1.0.5** - Updated to latest version with browser bundle support
+  - Now includes `dist/agentdb.min.js` (196KB) and `dist/agentdb.js` (380KB) for CDN usage
+  - Browser bundles support direct import via unpkg/jsDelivr
+  - Source maps included for debugging
+  - WASM backend fully functional in browser environments
+
 ## [1.6.5] - 2025-10-18
 
 ### Changed

package/README.md

@@ -17,7 +17,7 @@
 |-------------|---------------|---------------|
 | [Quick Start](#-quick-start) | [Agent Booster](#-core-components) | [Agent List](#-agent-types) |
 | [Deployment Options](#-deployment-options) | [ReasoningBank](#-core-components) | [MCP Tools](#-mcp-tools-213-total) |
-| [Model Optimization](#-model-optimization) | [Multi-Model Router](#-using-the-multi-model-router) | [Complete Docs](https://github.com/ruvnet/agentic-flow/tree/main/docs) |
+| [Model Optimization](#-model-optimization) | [Skills System](#-skills-system-claude-code-integration) | [Complete Docs](https://github.com/ruvnet/agentic-flow/tree/main/docs) |
 
 ---
 
@@ -248,10 +248,18 @@ npx agentic-flow mcp status  # Check server status
 npx agentic-flow --list              # List all 79 agents
 npx agentic-flow agent info coder    # Get agent details
 npx agentic-flow agent create        # Create custom agent
+
+# Skills management (NEW in v1.5.11+)
+npx agentic-flow skills list         # List all installed skills
+npx agentic-flow skills init         # Initialize skills directories
+npx agentic-flow skills create       # Create agentic-flow example skills
+npx agentic-flow skills init-builder # Install skill-builder framework
+npx agentic-flow skills help         # Show skills help
 ```
 
 **Built-in MCP Tools** (7): agent execution, list agents, create agent, agent info, conflicts check, model optimizer, list all agents
 **External MCP Servers**: claude-flow (101 tools), flow-nexus (96 tools), agentic-payments (10 tools)
+**Skills System**: Create reusable AI workflows with YAML frontmatter and progressive disclosure
 
 ---
 
@@ -367,6 +375,76 @@ for (const file of files) {
 
 ---
 
+## 🎓 Skills System (Claude Code Integration)
+
+**NEW in v1.5.11+**: Create reusable AI workflows with proper YAML frontmatter, progressive disclosure, and Claude Code integration.
+
+### What Are Skills?
+
+Skills are structured AI workflows that Claude can autonomously discover and execute across all surfaces (Claude.ai, Claude Code, SDK, API). Each skill is a self-contained SKILL.md file with YAML frontmatter defining its capabilities.
+
+### Quick Start
+
+```bash
+# Initialize skills directories
+npx agentic-flow skills init         # Creates ~/.claude/skills and .claude/skills
+
+# Install skill-builder framework (for creating custom skills)
+npx agentic-flow skills init-builder # Adds skill-builder to your project
+
+# Create example agentic-flow skills
+npx agentic-flow skills create       # Creates AgentDB, swarm, reasoningbank skills
+
+# List all installed skills
+npx agentic-flow skills list         # Shows personal and project skills
+
+# Get help
+npx agentic-flow skills help         # Show all commands and usage
+```
+
+### Skill Structure
+
+Every skill requires a SKILL.md file with YAML frontmatter:
+
+```yaml
+---
+name: "Skill Name"                    # REQUIRED: Max 64 chars
+description: "What this skill does    # REQUIRED: Max 1024 chars
+and when Claude should use it."       # Include BOTH what & when
+---
+
+# Skill Name
+
+## What This Skill Does
+[Instructions for Claude]
+
+## Quick Start
+[Basic usage examples]
+
+## Prerequisites
+[Requirements]
+```
+
+### Built-in Skills
+
+- **skill-builder** - Create new Claude Code Skills with proper structure
+- **agentdb-memory-patterns** - Persistent memory patterns for AI agents
+- **agentdb-vector-search** - Semantic search with AgentDB
+- **reasoningbank-intelligence** - Adaptive learning and pattern recognition
+- **swarm-orchestration** - Multi-agent coordination workflows
+
+### Benefits
+
+- ✅ **Reusable**: Share skills across projects and teams
+- ✅ **Discoverable**: Claude finds and uses skills automatically
+- ✅ **Structured**: YAML frontmatter ensures consistency
+- ✅ **Progressive**: Expand details only when needed
+- ✅ **Validated**: Built-in validation catches errors early
+
+**Learn More:** [Skills Documentation](https://github.com/ruvnet/agentic-flow/tree/main/agentic-flow/.claude/skills)
+
+---
+
 ## 🎛️ Programmatic API
 
 ### Multi-Model Router