@techwavedev/agi-agent-kit 1.3.6 → 1.4.2

package/CHANGELOG.md

@@ -5,6 +5,87 @@ 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.4.2]
+
+- **Fixed README links** — ./skills/SKILLS_CATALOG.md updated to ./templates/skills/SKILLS_CATALOG.md (closes #15)
+- **Removed Stitch Nested Duplicates** — Removed nested design-md/design-md, react-components/react-components, stitch-loop/stitch-loop (closes #16) - 2026-02-20
+
+### Added
+
+- **Workflow Engine** — `execution/workflow_engine.py` — executes multi-skill playbooks from `data/workflows.json` with state persistence, progress tracking, and branching logic (closes #13)
+- **Playbook Protocol in AGENTS.md** — Agents now know how to discover, start, and step through playbooks via the `/playbook` command
+- **4 Missing Slash Commands** — Created `setup.md`, `setup-memory.md`, `update.md`, `checkup.md` workflow files (closes #8)
+- **All 19 Agent Personas Documented** — README now lists all 19 agents instead of only 8 (closes #9)
+
+### Fixed
+
+- **README Skill Counts** — 853→878 (was stale since v1.3.7); breakdown: 4 core + 89 knowledge + 785 extended (closes #6)
+- **README Platform Counts** — Fixed inconsistencies (4/8/9) to consistent 9 platforms everywhere (closes #10)
+- **README Trigger Keywords** — Fixed ghost skill names (`aws`→`aws-skills`, `aws-terraform`→`terraform-skill`, removed `consul`/`opensearch` EC-scoped refs) (closes #11)
+- **10 Skills Missing AGI Framework Integration** — Added `🧠 AGI Framework Integration` section to 10 knowledge skills that lacked it (closes #7)
+- **init.js Skill Counts** — Updated 793→785 to match actual after removals
+- **SKILLS_CATALOG.md Header** — Updated 886→878 to match actual
+
+### Removed
+
+- **8 Duplicate Skills** — Finally removed 8 skills that v1.3.7 CHANGELOG claimed were removed but still existed (closes #12):
+  - `pptx-official`, `docx-official` (duplicates of `pptx`, `docx`)
+  - `brand-guidelines-community`, `brand-guidelines-anthropic` (merged into `brand-guidelines`)
+  - `internal-comms-community`, `internal-comms-anthropic` (merged into `internal-comms`)
+  - `mcp-builder-ms`, `skill-creator-ms` (merged into `mcp-builder`, `skill-creator`)
+- **Skill Count** — 886→878 (net -8 duplicates)
+
+## [1.4.1] - 2026-02-20
+
+### Added
+
+- **11 New Upstream Skills** — Imported and adapted from `antigravity-awesome-skills` latest:
+  - `crypto-bd-agent` — Autonomous crypto business development patterns
+  - `dbos-golang`, `dbos-python`, `dbos-typescript` — DBOS durable workflow SDKs
+  - `ddd-context-mapping`, `ddd-strategic-design`, `ddd-tactical-patterns`, `domain-driven-design` — Domain-Driven Design suite
+  - `laravel-expert`, `laravel-security-audit` — Laravel development and security
+  - `react-flow-architect` — ReactFlow interactive graph applications
+- **Release Gate UX** — Added progress indicators to secret scanning and syntax checking
+
+### Fixed
+
+- **Skill Count Update** — Total skills 875→886, Extended 782→793
+
+## [1.4.0] - 2026-02-20
+
+### Added
+
+- **Workflows Metadata** — Added `data/workflows.json` with 4 guided multi-skill playbooks:
+  - `ship-saas-mvp` — 5-step SaaS delivery
+  - `security-audit-web-app` — 4-step AppSec review
+  - `build-ai-agent-system` — 4-step AI agent design
+  - `qa-browser-automation` — 3-step E2E testing
+
+### Fixed
+
+- **Skill Count Correction** — Updated SKILLS_CATALOG.md and init.js from stale 862/76 to actual 875/89. Core: 4, Knowledge (Medium): 89, Extended (Full): 782.
+
+## [1.3.8] - 2026-02-20
+
+### Fixed
+
+- **Memory System Path Resolution** — Fixed `ModuleNotFoundError` for `embedding_utils` in `memory_manager.py` and `session_init.py` by implementing an adaptive multi-candidate path approach. This ensures correct script initialization inside natively customized workspaces and `npx`-bootstrapped agent projects.
+
+## [1.3.7] - 2026-02-17
+
+### Fixed
+
+- **Skill Conflict Resolution** — Resolved 8 conflicting skill pairs detected in Gemini CLI:
+  - **6 duplicates removed**: `xlsx-official`, `pdf-official`, `pptx-official`, `docx-official`, `brand-guidelines-community`, `internal-comms-community` (identical SKILL.md content, only `__pycache__` differed)
+  - **2 MS-specialized skills merged**: `mcp-builder-ms` → `mcp-builder` (added C#/.NET SDK, Azure MCP ecosystem, Foundry remote MCP), `skill-creator-ms` → `skill-creator` (added Azure SDK Appendix with auth patterns, verb patterns, product categories)
+  - **2 skills renamed**: `brand-guidelines-anthropic` → `brand-guidelines`, `internal-comms-anthropic` → `internal-comms`
+
+### Changed
+
+- **Skill count**: 861 → 853 (8 redundant skill directories removed, 0 content lost)
+- **`mcp-builder`**: Now includes Microsoft MCP ecosystem section (Azure MCP Server, Foundry MCP, Fabric MCP), C#/.NET language support, and transport selection tables
+- **`skill-creator`**: Now includes Azure SDK Skill Patterns appendix with DefaultAzureCredential patterns, standard verb patterns, and product area categories
+
 ## [1.3.6] - 2026-02-16
 
 ### Security

package/README.md

@@ -24,7 +24,7 @@ Most AI coding setups give you a prompt and hope for the best. AGI Agent Kit giv
 
 - 🧠 **Hybrid Memory** — Qdrant vectors + BM25 keywords: semantic similarity for concepts, exact matching for error codes and IDs (90-100% token savings)
 - 🎯 **19 Specialist Agents** — Domain-bounded experts (Frontend, Backend, Security, Mobile, Game Dev...) with enforced file ownership
-- ⚡ **861 Curated Skills** — 4 core + 75 professional + 782 community skills across 16 domain categories
+- ⚡ **878 Curated Skills** — 4 core + 89 professional + 785 community skills across 16 domain categories
 - 🔒 **Verification Gates** — No task completes without evidence. TDD enforcement. Two-stage code review.
 - 🌐 **9 Platforms, One Config** — Write once, run on Claude Code, Gemini CLI, Codex CLI, Cursor, Copilot, OpenCode, AdaL CLI, Antigravity IDE, OpenClaw
 
@@ -47,8 +47,8 @@ npx @techwavedev/agi-agent-kit init
 You'll be prompted to choose a pack:
 
 - **core** — 4 essential skills (webcrawler, pdf-reader, qdrant-memory, documentation)
-- **medium** — Core + 75 specialized skills in 16 categories + `.agent/` structure (API, Security, Design, Architecture)
-- **full** — Complete suite: Medium + 782 community skills from [antigravity-awesome-skills](https://github.com/sickn33/antigravity-awesome-skills) (861 total)
+- **medium** — Core + 89 specialized skills in 16 categories + `.agent/` structure (API, Security, Design, Architecture)
+- **full** — Complete suite: Medium + 785 community skills from [antigravity-awesome-skills](https://github.com/sickn33/antigravity-awesome-skills) (878 total)
 
 After installation, run the **one-shot setup wizard** to auto-configure your environment:
 
@@ -73,7 +73,7 @@ This checks Qdrant, Ollama, embedding models, and collections — auto-fixing an
 | Feature                       | Description                                                                                   |
 | ----------------------------- | --------------------------------------------------------------------------------------------- |
 | **Deterministic Execution**   | Separates business logic (Python scripts) from AI reasoning (Directives)                      |
-| **Modular Skill System**      | 861 plug-and-play skills across 3 tiers, organized in 16 domain categories                    |
+| **Modular Skill System**      | 878 plug-and-play skills across 3 tiers, organized in 16 domain categories                    |
 | **Structured Plan Execution** | Batch or subagent-driven execution with two-stage review (spec + quality)                     |
 | **TDD Enforcement**           | Iron-law RED-GREEN-REFACTOR cycle — no production code without failing test                   |
 | **Verification Gates**        | Evidence before claims — no completion without fresh verification output                      |
@@ -96,15 +96,15 @@ The agi framework adopts all best patterns from [obra/superpowers](https://githu
 | Systematic Debugging         |        ✅        | ✅ Adapted + `debugger` agent  |
 | Verification Gates           |        ✅        | ✅ Adapted + 12 audit scripts  |
 | Two-Stage Code Review        |        ✅        |  ✅ Adapted into orchestrator  |
-| Multi-Platform Orchestration |  ❌ Claude only  |         ✅ 4 platforms         |
+| Multi-Platform Orchestration |  ❌ Claude only  |         ✅ 9 platforms         |
 | Semantic Memory (Qdrant)     |        ❌        |    ✅ 90-100% token savings    |
 | 19 Specialist Agents         |        ❌        |      ✅ Domain boundaries      |
 | Agent Boundary Enforcement   |        ❌        |     ✅ File-type ownership     |
 | Dynamic Question Generation  |        ❌        |   ✅ Trade-offs + priorities   |
 | Memory-First Protocol        |        ❌        |       ✅ Auto cache-hit        |
-| Skill Creator + Catalog      |        ❌        |    ✅ 861 composable skills    |
+| Skill Creator + Catalog      |        ❌        |    ✅ 878 composable skills    |
 | Platform Setup Wizard        |        ❌        |       ✅ One-shot config       |
-| Multi-Platform Symlinks      |  ❌ Claude only  |         ✅ 8 platforms         |
+| Multi-Platform Symlinks      |  ❌ Claude only  |         ✅ 9 platforms         |
 
 ---
 
@@ -220,10 +220,10 @@ your-project/
 ├── CLAUDE.md → AGENTS.md
 ├── OPENCODE.md → AGENTS.md
 ├── COPILOT.md → AGENTS.md
-├── skills/                # Up to 861 skills (depends on pack)
+├── skills/                # Up to 878 skills (depends on pack)
 │   ├── webcrawler/        # Documentation harvesting
 │   ├── qdrant-memory/     # Semantic caching & memory
-│   └── ...                # 860 more skills in full pack
+│   └── ...                # 877 more skills in full pack
 ├── .claude/skills → skills/   # Platform-specific symlinks
 ├── .gemini/skills → skills/
 ├── .codex/skills → skills/
@@ -408,43 +408,54 @@ Use these keywords, commands, and phrases to trigger specific capabilities:
 
 ### Agent Mentions (`@agent`)
 
-| Mention                | Specialist              | When To Use                               |
-| ---------------------- | ----------------------- | ----------------------------------------- |
-| `@orchestrator`        | Multi-agent coordinator | Complex multi-domain tasks                |
-| `@project-planner`     | Planning specialist     | Roadmaps, task breakdowns, phase planning |
-| `@frontend-specialist` | UI/UX architect         | Web interfaces, React, Next.js            |
-| `@mobile-developer`    | Mobile specialist       | iOS, Android, React Native, Flutter       |
-| `@backend-specialist`  | API/DB engineer         | Server-side, databases, APIs              |
-| `@security-auditor`    | Security expert         | Vulnerability scanning, audits, hardening |
-| `@debugger`            | Debug specialist        | Complex bug investigation                 |
-| `@game-developer`      | Game dev specialist     | 2D/3D games, multiplayer, VR/AR           |
+| Mention                   | Specialist              | When To Use                                |
+| ------------------------- | ----------------------- | ------------------------------------------ |
+| `@orchestrator`           | Multi-agent coordinator | Complex multi-domain tasks                 |
+| `@project-planner`        | Planning specialist     | Roadmaps, task breakdowns, phase planning  |
+| `@frontend-specialist`    | UI/UX architect         | Web interfaces, React, Next.js             |
+| `@backend-specialist`     | API/DB engineer         | Server-side, databases, APIs               |
+| `@mobile-developer`       | Mobile specialist       | iOS, Android, React Native, Flutter        |
+| `@security-auditor`       | Security expert         | Vulnerability scanning, audits, hardening  |
+| `@debugger`               | Debug specialist        | Complex bug investigation                  |
+| `@game-developer`         | Game dev specialist     | 2D/3D games, multiplayer, VR/AR            |
+| `@devops-engineer`        | DevOps specialist       | CI/CD, containers, cloud infrastructure    |
+| `@database-architect`     | Database specialist     | Schema design, migrations, optimization    |
+| `@documentation-writer`   | Docs specialist         | Technical writing, API docs, READMEs       |
+| `@test-engineer`          | Testing specialist      | Test strategy, automation, coverage        |
+| `@qa-automation-engineer` | QA specialist           | E2E testing, regression, quality gates     |
+| `@performance-optimizer`  | Performance specialist  | Profiling, bottlenecks, optimization       |
+| `@seo-specialist`         | SEO specialist          | Search optimization, meta tags, rankings   |
+| `@penetration-tester`     | Pen testing specialist  | Red team exercises, exploit verification   |
+| `@product-manager`        | Product specialist      | Requirements, user stories, prioritization |
+| `@code-archaeologist`     | Legacy code specialist  | Understanding old codebases, migrations    |
+| `@explorer-agent`         | Discovery specialist    | Codebase exploration, dependency mapping   |
 
 ### Skill Trigger Keywords (Natural Language)
 
-| Category           | Trigger Words / Phrases                                                | Skill Activated                     |
-| ------------------ | ---------------------------------------------------------------------- | ----------------------------------- |
-| **Memory**         | "don't use cache", "no cache", "skip memory", "fresh"                  | Memory opt-out                      |
-| **Research**       | "research my docs", "check my notebooks", "deep search", "@notebooklm" | `notebooklm-rag`                    |
-| **Documentation**  | "update docs", "regenerate catalog", "sync documentation"              | `documentation`                     |
-| **Quality**        | "lint", "format", "check", "validate", "static analysis"               | `lint-and-validate`                 |
-| **Testing**        | "write tests", "run tests", "TDD", "test coverage"                     | `testing-patterns` / `tdd-workflow` |
-| **TDD**            | "test first", "red green refactor", "failing test"                     | `test-driven-development`           |
-| **Plan Execution** | "execute plan", "run the plan", "batch execution"                      | `executing-plans`                   |
-| **Verification**   | "verify", "prove it works", "evidence", "show me the output"           | `verification-before-completion`    |
-| **Debugging**      | "debug", "root cause", "investigate", "why is this failing"            | `systematic-debugging`              |
-| **Architecture**   | "design system", "architecture decision", "ADR", "trade-off"           | `architecture`                      |
-| **Security**       | "security scan", "vulnerability", "audit", "OWASP"                     | `red-team-tactics`                  |
-| **Performance**    | "lighthouse", "bundle size", "core web vitals", "profiling"            | `performance-profiling`             |
-| **Design**         | "design UI", "color scheme", "typography", "layout"                    | `frontend-design`                   |
-| **Deployment**     | "deploy", "rollback", "release", "CI/CD"                               | `deployment-procedures`             |
-| **API**            | "REST API", "GraphQL", "tRPC", "API design"                            | `api-patterns`                      |
-| **Database**       | "schema design", "migration", "query optimization"                     | `database-design`                   |
-| **Planning**       | "plan this", "break down", "task list", "requirements"                 | `plan-writing`                      |
-| **Brainstorming**  | "explore options", "what are the approaches", "pros and cons"          | `brainstorming`                     |
-| **Code Review**    | "review this", "code quality", "best practices"                        | `code-review-checklist`             |
-| **i18n**           | "translate", "localization", "RTL", "locale"                           | `i18n-localization`                 |
-| **AWS**            | "terraform", "EKS", "Lambda", "S3", "CloudFront"                       | `aws` / `aws-terraform`             |
-| **Infrastructure** | "Consul", "service mesh", "OpenSearch"                                 | `consul` / `opensearch`             |
+| Category           | Trigger Words / Phrases                                                | Skill Activated                       |
+| ------------------ | ---------------------------------------------------------------------- | ------------------------------------- |
+| **Memory**         | "don't use cache", "no cache", "skip memory", "fresh"                  | Memory opt-out                        |
+| **Research**       | "research my docs", "check my notebooks", "deep search", "@notebooklm" | `notebooklm-rag`                      |
+| **Documentation**  | "update docs", "regenerate catalog", "sync documentation"              | `documentation`                       |
+| **Quality**        | "lint", "format", "check", "validate", "static analysis"               | `lint-and-validate`                   |
+| **Testing**        | "write tests", "run tests", "TDD", "test coverage"                     | `testing-patterns` / `tdd-workflow`   |
+| **TDD**            | "test first", "red green refactor", "failing test"                     | `test-driven-development`             |
+| **Plan Execution** | "execute plan", "run the plan", "batch execution"                      | `executing-plans`                     |
+| **Verification**   | "verify", "prove it works", "evidence", "show me the output"           | `verification-before-completion`      |
+| **Debugging**      | "debug", "root cause", "investigate", "why is this failing"            | `systematic-debugging`                |
+| **Architecture**   | "design system", "architecture decision", "ADR", "trade-off"           | `architecture`                        |
+| **Security**       | "security scan", "vulnerability", "audit", "OWASP"                     | `red-team-tactics`                    |
+| **Performance**    | "lighthouse", "bundle size", "core web vitals", "profiling"            | `performance-profiling`               |
+| **Design**         | "design UI", "color scheme", "typography", "layout"                    | `frontend-design`                     |
+| **Deployment**     | "deploy", "rollback", "release", "CI/CD"                               | `deployment-procedures`               |
+| **API**            | "REST API", "GraphQL", "tRPC", "API design"                            | `api-patterns`                        |
+| **Database**       | "schema design", "migration", "query optimization"                     | `database-design`                     |
+| **Planning**       | "plan this", "break down", "task list", "requirements"                 | `plan-writing`                        |
+| **Brainstorming**  | "explore options", "what are the approaches", "pros and cons"          | `brainstorming`                       |
+| **Code Review**    | "review this", "code quality", "best practices"                        | `code-review-checklist`               |
+| **i18n**           | "translate", "localization", "RTL", "locale"                           | `i18n-localization`                   |
+| **AWS**            | "terraform", "EKS", "Lambda", "S3", "CloudFront"                       | `aws-skills` / `terraform-skill`      |
+| **Infrastructure** | "service mesh", "Kubernetes", "Helm"                                   | `docker-expert` / `server-management` |
 
 ### Memory System Commands
 
@@ -462,7 +473,7 @@ Use these keywords, commands, and phrases to trigger specific capabilities:
 ## 📚 Documentation
 
 - **[AGENTS.md](./AGENTS.md)** — Complete architecture and operating principles
-- **[skills/SKILLS_CATALOG.md](./skills/SKILLS_CATALOG.md)** — Skill catalog
+- **[skills/SKILLS_CATALOG.md](./templates/skills/SKILLS_CATALOG.md)** — Skill catalog
 - **[CHANGELOG.md](./CHANGELOG.md)** — Version history
 - **[THIRD-PARTY-LICENSES.md](./THIRD-PARTY-LICENSES.md)** — Third-party attributions
 
@@ -470,7 +481,7 @@ Use these keywords, commands, and phrases to trigger specific capabilities:
 
 ## 🤝 Community Skills & Credits
 
-The **Full** tier includes 782 community skills adapted from the [Antigravity Awesome Skills](https://github.com/sickn33/antigravity-awesome-skills) project (v5.4.0) by [@sickn33](https://github.com/sickn33), distributed under the MIT License.
+The **Full** tier includes 774 community skills adapted from the [Antigravity Awesome Skills](https://github.com/sickn33/antigravity-awesome-skills) project (v5.4.0) by [@sickn33](https://github.com/sickn33), distributed under the MIT License.
 
 This collection aggregates skills from 50+ open-source contributors and organizations including Anthropic, Microsoft, Vercel Labs, Supabase, Trail of Bits, Expo, Sentry, Neon, fal.ai, and many more. For the complete attribution ledger, see [SOURCES.md](https://github.com/sickn33/antigravity-awesome-skills/blob/main/docs/SOURCES.md).
 
@@ -484,7 +495,18 @@ If these community skills help you, consider [starring the original repo](https:
 
 ---
 
-## 🛡️ Security
+## �️ Roadmap
+
+| Feature                             | Status     | Description                                                                                                                                                                                                                                                           |
+| ----------------------------------- | ---------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| **Federated Agent Memory**          | 🔬 Design  | Cross-agent knowledge sharing via project-scoped Qdrant collections. Agents working on the same project read each other's decisions, errors, and patterns — building collective intelligence across sessions and platforms.                                           |
+| **Blockchain-Authenticated Memory** | 🔬 Design  | Cryptographic trust layer for shared memory using enterprise blockchains (Hyperledger Fabric, MultiChain, or Quorum) — self-hosted, no fees, no cryptocurrency. Agent writes are signed, content hashes are anchored on-chain, and access is token-gated per project. |
+| **Event-Driven Agent Streaming**    | 🔬 Design  | Real-time agent communication via Kafka/Flink. Agents publish decisions and observations to topics, enabling reactive workflows — e.g., a security agent triggers remediation when a vulnerability scan agent publishes findings.                                     |
+| **Workflow Engine**                 | 📋 Planned | Execute `data/workflows.json` playbooks as guided multi-skill sequences with progress tracking and branching logic.                                                                                                                                                   |
+
+---
+
+## �🛡️ Security
 
 This package includes a pre-flight security scanner that checks for private terms before publishing. All templates are sanitized for public use.
 

package/bin/init.js

@@ -9,8 +9,8 @@
  *
  * Packs:
  *   core   - Base framework + common skills (webcrawler, pdf-reader, qdrant-memory)
- *   medium - Core + 76 specialized skills + .agent structure
- *   full   - Medium + 782 community skills (complete suite)
+ *   medium - Core + 89 specialized skills + .agent structure
+ *   full   - Medium + 785 community skills (complete suite)
  *
  * Options:
  *   --path=<dir>    Target directory (default: current)
@@ -54,14 +54,14 @@ const PACKS = {
   medium: {
     name: "Medium",
     description:
-      "Core + 76 specialized skills + .agent structure (API, Security, Design, AI, Architecture)",
+      "Core + 89 specialized skills + .agent structure (API, Security, Design, AI, Architecture)",
     skills: ["core", "knowledge"],
     includeAgent: true,
   },
   full: {
     name: "Full Suite",
     description:
-      "Complete suite (Medium + 782 community skills from antigravity-awesome-skills)",
+      "Complete suite (Medium + 785 community skills from antigravity-awesome-skills v5.4.0)",
     skills: ["core", "knowledge", "extended"],
     includeAgent: true,
   },
@@ -113,10 +113,10 @@ ${colors.bright}Packs:${colors.reset}
   ${colors.green}core${colors.reset}      Base framework + common skills
            (webcrawler, pdf-reader, qdrant-memory, documentation)
 
-  ${colors.blue}medium${colors.reset}    Core + 76 specialized skills + .agent/ structure
+  ${colors.blue}medium${colors.reset}    Core + 89 specialized skills + .agent/ structure
            (API, Security, Design, AI, Architecture, Testing...)
   
-  ${colors.yellow}full${colors.reset}      Complete suite (Medium + 782 community skills)
+  ${colors.yellow}full${colors.reset}      Complete suite (Medium + 785 community skills)
            (All antigravity-awesome-skills, AGI-adapted)
 
 ${colors.bright}Examples:${colors.reset}
@@ -143,10 +143,10 @@ async function promptPackSelection() {
       `  1. ${colors.green}core${colors.reset}      Essential skills (webcrawler, pdf-reader, qdrant-memory, documentation)`,
     );
     console.log(
-      `  2. ${colors.blue}medium${colors.reset}    Core + 76 specialized skills + .agent/ structure`,
+      `  2. ${colors.blue}medium${colors.reset}    Core + 89 specialized skills + .agent/ structure`,
     );
     console.log(
-      `  3. ${colors.yellow}full${colors.reset}      Complete suite (Medium + 782 community skills)\n`,
+      `  3. ${colors.yellow}full${colors.reset}      Complete suite (Medium + 785 community skills from antigravity-awesome-skills)\n`,
     );
 
     rl.question(
@@ -254,7 +254,10 @@ function copySkills(targetPath, pack, templatesPath) {
           // Category directory (e.g., knowledge/frontend/) — recurse one level
           const categorySkills = fs
             .readdirSync(entryPath, { withFileTypes: true })
-            .filter((d) => d.isDirectory() && isSkillDir(path.join(entryPath, d.name)));
+            .filter(
+              (d) =>
+                d.isDirectory() && isSkillDir(path.join(entryPath, d.name)),
+            );
 
           for (const skill of categorySkills) {
             const src = path.join(entryPath, skill.name);
@@ -317,6 +320,15 @@ function copyBaseFiles(targetPath, templatesPath, options) {
     copyDirSync(srcSkillCreator, destSkillCreator);
     log.success("Installed skill-creator/");
   }
+
+  // Copy data (workflows metadata)
+  const srcData = path.join(templatesPath, "base", "data");
+  const destData = path.join(targetPath, "data");
+
+  if (fs.existsSync(srcData)) {
+    copyDirSync(srcData, destData);
+    log.success("Installed data/ (workflows metadata)");
+  }
 }
 
 // Create symlinks for multi-platform support
@@ -391,9 +403,13 @@ function createSymlinks(targetPath) {
       // Create relative symlink: .claude/skills → ../skills
       const relativeTarget = path.relative(parentDir, skillsDir);
       fs.symlinkSync(relativeTarget, linkPath);
-      log.success(`Created skill symlink: ${platform} → skills/ (${platformName})`);
+      log.success(
+        `Created skill symlink: ${platform} → skills/ (${platformName})`,
+      );
     } catch (err) {
-      log.warn(`Failed to create skill symlink for ${platformName}: ${err.message}`);
+      log.warn(
+        `Failed to create skill symlink for ${platformName}: ${err.message}`,
+      );
     }
   }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@techwavedev/agi-agent-kit",
-  "version": "1.3.6",
+  "version": "1.4.2",
   "description": "Enterprise-Grade Agentic Framework - Modular skill-based AI assistant toolkit with deterministic execution, semantic memory, and platform-adaptive orchestration.",
   "bin": {
     "agi-agent-kit": "./bin/init.js"

package/templates/base/AGENTS.md

@@ -411,6 +411,65 @@ For frequently-used processes, create workflows in `.agent/workflows/`:
 
 ---
 
+## Playbook Engine (Multi-Skill Sequences)
+
+For complex, multi-step tasks, use **playbooks** — pre-defined sequences of skills that guide you through a complete workflow with progress tracking.
+
+### How It Works
+
+Playbooks are defined in `data/workflows.json`. Each playbook is a sequence of steps, and each step recommends specific skills to use. The Workflow Engine (`execution/workflow_engine.py`) manages state, tracks progress, and tells you which skills to activate at each step.
+
+### Quick Start
+
+```bash
+# 1. See available playbooks
+python3 execution/workflow_engine.py list
+
+# 2. Start a playbook
+python3 execution/workflow_engine.py start ship-saas-mvp
+
+# 3. The engine shows Step 1 with recommended skills — execute them
+
+# 4. When step is done, mark it complete and get next step
+python3 execution/workflow_engine.py complete --notes "Planned scope with brainstorming skill"
+
+# 5. Check overall progress at any time
+python3 execution/workflow_engine.py status
+```
+
+### Agent Protocol for Playbooks
+
+When a user says `/playbook`, "run a playbook", or asks for a multi-step workflow:
+
+1. **List playbooks**: `python3 execution/workflow_engine.py list`
+2. **Ask the user** which playbook to run (or auto-select if the intent is clear)
+3. **Start it**: `python3 execution/workflow_engine.py start <id>`
+4. **For each step**:
+   a. Read the step's `goal` and `recommendedSkills` from the engine output
+   b. Read the relevant `SKILL.md` files for the recommended skills
+   c. Execute the step using those skills' instructions
+   d. Mark complete: `python3 execution/workflow_engine.py complete --notes "what was done"`
+5. **If a step is not applicable**, skip it: `python3 execution/workflow_engine.py skip --reason "why"`
+6. **If the user wants to stop**, abort: `python3 execution/workflow_engine.py abort`
+
+### Commands Reference
+
+| Command    | Description                             | When to Use                  |
+| ---------- | --------------------------------------- | ---------------------------- |
+| `list`     | Show all available playbooks            | User asks "what playbooks?"  |
+| `start`    | Begin a playbook, get Step 1            | User selects a playbook      |
+| `next`     | Show current step details               | Need to re-read current step |
+| `status`   | Show progress bar and step statuses     | User asks "where are we?"    |
+| `complete` | Mark current step done, advance to next | Step work is finished        |
+| `skip`     | Skip current step with reason           | Step not applicable          |
+| `abort`    | Cancel the active playbook              | User wants to stop           |
+
+> **State persistence:** Progress is saved in `.tmp/playbook_state.json`. If a session ends mid-playbook, the next session can resume with `python3 execution/workflow_engine.py next`.
+
+> **Skill availability:** The engine checks which recommended skills are actually installed and flags missing ones with ⚠️ so you can adapt.
+
+---
+
 ## Best Practices for Execution Scripts
 
 ### Script Template

package/templates/base/README.md

@@ -23,7 +23,7 @@ Most AI coding setups give you a prompt and hope for the best. AGI Agent Kit giv
 
 - 🧠 **Semantic Memory** — Qdrant-powered caching that eliminates redundant LLM calls (90-100% token savings)
 - 🎯 **19 Specialist Agents** — Domain-bounded experts (Frontend, Backend, Security, Mobile, Game Dev...) with enforced file ownership
-- ⚡ **861 Curated Skills** — 4 core + 75 professional + 782 community skills across 16 domain categories
+- ⚡ **853 Curated Skills** — 4 core + 75 professional + 774 community skills across 16 domain categories
 - 🔒 **Verification Gates** — No task completes without evidence. TDD enforcement. Two-stage code review.
 - 🌐 **8 Platforms, One Config** — Write once, run on Claude Code, Gemini CLI, Codex CLI, Cursor, Copilot, OpenCode, AdaL CLI, Antigravity IDE
 
@@ -47,7 +47,7 @@ You'll be prompted to choose a pack:
 
 - **core** — 4 essential skills (webcrawler, pdf-reader, qdrant-memory, documentation)
 - **medium** — Core + 75 specialized skills in 16 categories + `.agent/` structure (API, Security, Design, Architecture)
-- **full** — Complete suite: Medium + 782 community skills from [antigravity-awesome-skills](https://github.com/sickn33/antigravity-awesome-skills) (861 total)
+- **full** — Complete suite: Medium + 774 community skills from [antigravity-awesome-skills](https://github.com/sickn33/antigravity-awesome-skills) (853 total)
 
 After installation, run the **one-shot setup wizard** to auto-configure your environment:
 
@@ -72,7 +72,7 @@ This checks Qdrant, Ollama, embedding models, and collections — auto-fixing an
 | Feature                       | Description                                                                                   |
 | ----------------------------- | --------------------------------------------------------------------------------------------- |
 | **Deterministic Execution**   | Separates business logic (Python scripts) from AI reasoning (Directives)                      |
-| **Modular Skill System**      | 861 plug-and-play skills across 3 tiers, organized in 16 domain categories                    |
+| **Modular Skill System**      | 853 plug-and-play skills across 3 tiers, organized in 16 domain categories                    |
 | **Structured Plan Execution** | Batch or subagent-driven execution with two-stage review (spec + quality)                     |
 | **TDD Enforcement**           | Iron-law RED-GREEN-REFACTOR cycle — no production code without failing test                   |
 | **Verification Gates**        | Evidence before claims — no completion without fresh verification output                      |
@@ -101,7 +101,7 @@ The agi framework adopts all best patterns from [obra/superpowers](https://githu
 | Agent Boundary Enforcement   |        ❌        |     ✅ File-type ownership     |
 | Dynamic Question Generation  |        ❌        |   ✅ Trade-offs + priorities   |
 | Memory-First Protocol        |        ❌        |       ✅ Auto cache-hit        |
-| Skill Creator + Catalog      |        ❌        |    ✅ 861 composable skills    |
+| Skill Creator + Catalog      |        ❌        |    ✅ 853 composable skills    |
 | Platform Setup Wizard        |        ❌        |       ✅ One-shot config       |
 | Multi-Platform Symlinks      |  ❌ Claude only  |         ✅ 8 platforms         |
 
@@ -219,10 +219,10 @@ your-project/
 ├── CLAUDE.md → AGENTS.md
 ├── OPENCODE.md → AGENTS.md
 ├── COPILOT.md → AGENTS.md
-├── skills/                # Up to 861 skills (depends on pack)
+├── skills/                # Up to 853 skills (depends on pack)
 │   ├── webcrawler/        # Documentation harvesting
 │   ├── qdrant-memory/     # Semantic caching & memory
-│   └── ...                # 860 more skills in full pack
+│   └── ...                # 852 more skills in full pack
 ├── .claude/skills → skills/   # Platform-specific symlinks
 ├── .gemini/skills → skills/
 ├── .codex/skills → skills/
@@ -452,7 +452,7 @@ Use these keywords, commands, and phrases to trigger specific capabilities:
 
 ## 🤝 Community Skills & Credits
 
-The **Full** tier includes 782 community skills adapted from the [Antigravity Awesome Skills](https://github.com/sickn33/antigravity-awesome-skills) project (v5.4.0) by [@sickn33](https://github.com/sickn33), distributed under the MIT License.
+The **Full** tier includes 774 community skills adapted from the [Antigravity Awesome Skills](https://github.com/sickn33/antigravity-awesome-skills) project (v5.4.0) by [@sickn33](https://github.com/sickn33), distributed under the MIT License.
 
 This collection aggregates skills from 50+ open-source contributors and organizations including Anthropic, Microsoft, Vercel Labs, Supabase, Trail of Bits, Expo, Sentry, Neon, fal.ai, and many more. For the complete attribution ledger, see [SOURCES.md](https://github.com/sickn33/antigravity-awesome-skills/blob/main/docs/SOURCES.md).