@neyugn/agent-kits 0.2.4 → 0.2.6

package/README.md

@@ -370,143 +370,11 @@ After installation, find documentation in your project:
 
 ## 🤝 Contributing
 
-Contributions are welcome! Please see our [Contributing Guide](CONTRIBUTING.md).
+Contributions are welcome! Please see our [Contributing Guide](CONTRIBUTING.md) for detailed instructions on:
 
-### Creating a New Kit
-
-Follow this detailed guide to create a new kit for Agent Kits:
-
-#### Step 1: Create Kit Directory Structure
-
-```bash
-mkdir -p kits/my-kit/{agents,skills,workflows}
-```
-
-```
-kits/my-kit/
-├── ARCHITECTURE.md          # Kit documentation (required)
-├── GEMINI.md                # AI rule file (required)
-├── agents/                  # Agent personas
-│   ├── orchestrator.md
-│   └── specialist.md
-├── skills/                  # Domain skills
-│   └── core-skill/
-│       └── SKILL.md
-└── workflows/               # Slash commands
-    └── main.md
-```
-
-#### Step 2: Create ARCHITECTURE.md
-
-```markdown
-# My Kit Architecture
-
-## 🎯 Purpose
-
-[Describe what this kit is for]
-
-## 🤖 Agents
-
-| Agent | Description |
-| ----- | ----------- |
-| ...   | ...         |
-
-## 🧩 Skills
-
-| Skill | Description |
-| ----- | ----------- |
-| ...   | ...         |
-
-## 📜 Workflows
-
-| Command | Description |
-| ------- | ----------- |
-| ...     | ...         |
-
-## 🔗 Common Skills
-
-This kit inherits from the **Common Skills Layer**. See `common/COMMON.md`.
-```
-
-#### Step 3: Create GEMINI.md (AI Rule File)
-
-```markdown
----
-trigger: manual
----
-
-# GEMINI.md - My Kit
-
-> [Kit description]
-
-## 🎯 Purpose
-
-[Purpose description]
-
-## 🤖 AGENT ROUTING
-
-[Agent selection logic]
-
-## 📜 WORKFLOWS
-
-[Available slash commands]
-
-## 🛠️ SKILL LOADING
-
-[Skill loading protocol]
-```
-
-#### Step 4: Register Kit in CLI
-
-Edit `src/config.ts`:
-
-```typescript
-export const KITS: Kit[] = [
-  {
-    id: "coder",
-    name: "Coder Kit",
-    description: "Complete toolkit for software development",
-    path: "kits/coder",
-  },
-  {
-    id: "my-kit",
-    name: "My Kit",
-    description: "Description of my kit",
-    path: "kits/my-kit",
-  },
-];
-```
-
-#### Step 5: Test Your Kit
-
-```bash
-# Build CLI
-pnpm build
-
-# Test installation
-node dist/cli.js
-
-# Select your new kit and verify installation
-```
-
-#### Step 6: Submit Pull Request
-
-1. Fork the repository
-2. Create feature branch: `git checkout -b feat/my-kit`
-3. Commit changes: `git commit -m "feat: add my-kit"`
-4. Push and create PR
-
-### Creating New Skills/Agents
-
-Inside a kit:
-
-```bash
-# Add agent
-python3 kits/coder/skills/agent-creator/scripts/init_agent.py my-agent
-
-# Add skill
-python3 kits/coder/skills/skill-creator/scripts/init_skill.py my-skill
-```
+- Creating new kits
+- Adding agents and skills
+- Submitting pull requests
 
 <br/>
 

package/README.vi.md

@@ -362,47 +362,11 @@ Sau khi cài đặt, tìm tài liệu trong dự án của bạn:
 
 ## 🤝 Đóng góp
 
-Chúng tôi hoan nghênh đóng góp! Xem [Hướng dẫn đóng góp](CONTRIBUTING.md).
+Chúng tôi hoan nghênh đóng góp! Xem [Hướng dẫn đóng góp](CONTRIBUTING.md) để biết chi tiết về:
 
-### Tạo Kit mới
-
-#### Bước 1: Tạo cấu trúc thư mục
-
-```bash
-mkdir -p kits/my-kit/{agents,skills,workflows}
-```
-
-```
-kits/my-kit/
-├── ARCHITECTURE.md          # Tài liệu kit (bắt buộc)
-├── GEMINI.md                # File quy tắc AI (bắt buộc)
-├── agents/                  # Agent personas
-│   └── orchestrator.md
-├── skills/                  # Domain skills
-│   └── core-skill/
-│       └── SKILL.md
-└── workflows/               # Slash commands
-    └── main.md
-```
-
-#### Bước 2: Tạo ARCHITECTURE.md
-
-Mô tả kiến trúc kit bao gồm: Purpose, Agents, Skills, Workflows.
-
-#### Bước 3: Tạo GEMINI.md
-
-File quy tắc cho AI với các trigger, agent routing, và skill loading protocol.
-
-#### Bước 4: Đăng ký trong CLI
-
-Thêm kit vào `src/config.ts`.
-
-#### Bước 5: Test và Submit PR
-
-```bash
-pnpm build
-node dist/cli.js
-```
+- Tạo kits mới
+- Thêm agents và skills
+- Gửi pull requests
 
 <br/>
 

package/README.zh.md

@@ -362,47 +362,11 @@ npx @neyugn/agent-kits
 
 ## 🤝 贡献
 
-欢迎贡献！请查看我们的[贡献指南](CONTRIBUTING.md)。
+欢迎贡献！请查看我们的[贡献指南](CONTRIBUTING.md)，了解详细说明：
 
-### 创建新工具包
-
-#### 步骤 1：创建目录结构
-
-```bash
-mkdir -p kits/my-kit/{agents,skills,workflows}
-```
-
-```
-kits/my-kit/
-├── ARCHITECTURE.md          # 工具包文档（必需）
-├── GEMINI.md                # AI 规则文件（必需）
-├── agents/                  # 代理角色
-│   └── orchestrator.md
-├── skills/                  # 领域技能
-│   └── core-skill/
-│       └── SKILL.md
-└── workflows/               # 斜杠命令
-    └── main.md
-```
-
-#### 步骤 2：创建 ARCHITECTURE.md
-
-描述工具包架构，包括：目的、代理、技能、工作流。
-
-#### 步骤 3：创建 GEMINI.md
-
-AI 规则文件，包含触发器、代理路由和技能加载协议。
-
-#### 步骤 4：在 CLI 中注册
-
-将工具包添加到 `src/config.ts`。
-
-#### 步骤 5：测试并提交 PR
-
-```bash
-pnpm build
-node dist/cli.js
-```
+- 创建新工具包
+- 添加代理和技能
+- 提交 pull requests
 
 <br/>
 

package/common/COMMON.md

@@ -0,0 +1,102 @@
+# Common Skills Layer
+
+> Universal skills shared across ALL kits in @neyugn/agent-kits
+
+---
+
+## 🎯 Purpose
+
+Common Skills là một layer đặc biệt chứa các skill được chia sẻ giữa **tất cả các kits**. Những skill này:
+
+1. **Được cài đặt cùng với mọi kit** - Khi user cài một kit bất kỳ (coder, writer, etc.), common skills cũng được cài theo
+2. **Được đề cập trong ARCHITECTURE.md** của mỗi kit
+3. **Có workflow riêng** - Chỉ được gọi khi user sử dụng slash command tương ứng
+
+---
+
+## 📁 Directory Structure
+
+```plaintext
+common/
+├── COMMON.md               # This file - documentation
+├── skills/                 # Common skills
+│   └── filter-skill/       # Workspace filtering skill
+│       ├── SKILL.md
+│       └── scripts/
+│           └── workspace_analyzer.py
+└── workflows/              # Common workflows
+    └── filter.md           # /filter command
+```
+
+---
+
+## 🧩 Common Skills
+
+| Skill          | Description                                                                | Workflow  |
+| -------------- | -------------------------------------------------------------------------- | --------- |
+| `filter-skill` | Tự động phân tích workspace và bật/tắt skills/agents phù hợp với techstack | `/filter` |
+
+---
+
+## 🔄 How It Works
+
+### Installation
+
+Khi user chạy `npx @neyugn/agent-kits`:
+
+1. User chọn kit (e.g., `coder`)
+2. Installer copy kit vào workspace
+3. Installer copy `common/` skills vào cùng vị trí
+4. Common skills được merge vào architecture của kit
+
+### Usage
+
+```bash
+# User gọi workflow để filter skills
+/filter
+
+# AI sẽ:
+# 1. Phân tích workspace (package.json, pubspec.yaml, etc.)
+# 2. Xác định techstack
+# 3. Đề xuất enable/disable skills
+# 4. Hỏi user xác nhận + techstack tương lai
+# 5. Lưu kết quả vào .agent/workspace-profile.json
+```
+
+---
+
+## 📊 Integration with Kits
+
+Mỗi kit's `ARCHITECTURE.md` PHẢI đề cập:
+
+```markdown
+## 🔗 Common Skills
+
+This kit inherits from the **Common Skills Layer**. See `common/COMMON.md` for:
+
+- `/filter` - Workspace-aware skill filtering
+- [Future common skills...]
+
+Common skills are automatically installed and available in all kits.
+```
+
+---
+
+## 🚀 Future Common Skills (Planned)
+
+| Skill             | Description                                     | Status  |
+| ----------------- | ----------------------------------------------- | ------- |
+| `context-manager` | Quản lý context length, tự động tóm tắt history | Planned |
+| `memory-skill`    | Lưu trữ và recall thông tin quan trọng          | Planned |
+| `preference-sync` | Đồng bộ preferences của user giữa các sessions  | Planned |
+
+---
+
+## 📝 Adding Common Skills
+
+1. Create skill folder in `common/skills/`
+2. Create workflow in `common/workflows/`
+3. Update this file's Skills table
+4. Update all kits' ARCHITECTURE.md to reference
+
+---

package/common/skills/filter-skill/SKILL.md

@@ -0,0 +1,247 @@
+---
+name: filter-skill
+description: Automatically analyze workspace and enable/disable skills/agents based on detected techstack. Reduces noise from irrelevant skills.
+category: common
+trigger: manual
+workflow: /filter
+---
+
+# Filter Skill
+
+> Workspace-aware skill/agent filtering for optimal AI performance.
+
+---
+
+## 🎯 Purpose
+
+Filter Skill solves the **skill overload** problem - when too many skills are loaded but aren't relevant to the current project. This skill:
+
+1. **Analyzes techstack** of the workspace
+2. **Recommends enable/disable** for skills/agents
+3. **Asks user confirmation** before applying changes
+4. **Persists profile** for use in subsequent sessions
+
+---
+
+## 🔍 Detection Criteria
+
+### Package Managers & Config Files
+
+| File/Pattern       | Detected Techstack                      |
+| ------------------ | --------------------------------------- |
+| `package.json`     | Node.js, check dependencies for details |
+| `pubspec.yaml`     | Flutter/Dart                            |
+| `pyproject.toml`   | Python (Poetry/PDM)                     |
+| `requirements.txt` | Python (pip)                            |
+| `Cargo.toml`       | Rust                                    |
+| `go.mod`           | Go                                      |
+| `build.gradle`     | Android (Java/Kotlin)                   |
+| `Podfile`          | iOS                                     |
+| `composer.json`    | PHP                                     |
+| `Gemfile`          | Ruby                                    |
+
+### Framework Markers
+
+| File/Pattern           | Framework        | Enable Skills                                 |
+| ---------------------- | ---------------- | --------------------------------------------- |
+| `next.config.*`        | Next.js          | react-patterns, frontend-design, seo-patterns |
+| `vite.config.*`        | Vite             | react-patterns, frontend-design               |
+| `angular.json`         | Angular          | typescript-patterns, frontend-design          |
+| `nuxt.config.*`        | Nuxt.js          | frontend-design, seo-patterns                 |
+| `tailwind.config.*`    | Tailwind CSS     | tailwind-patterns                             |
+| `prisma/schema.prisma` | Prisma           | database-design, postgres-patterns            |
+| `drizzle.config.*`     | Drizzle          | database-design                               |
+| `docker-compose.*`     | Docker           | docker-patterns                               |
+| `Dockerfile`           | Docker           | docker-patterns                               |
+| `k8s/`, `kubernetes/`  | Kubernetes       | kubernetes-patterns                           |
+| `.github/workflows/`   | GitHub Actions   | github-actions                                |
+| `.gitlab-ci.yml`       | GitLab CI        | gitlab-ci-patterns                            |
+| `terraform/`, `*.tf`   | Terraform        | terraform-patterns                            |
+| `socket.io`, `ws`      | WebSocket (deps) | realtime-patterns                             |
+| `bullmq`, `bee-queue`  | Queue (deps)     | queue-patterns                                |
+
+### Dependency Analysis (package.json)
+
+| Dependency Pattern      | Enable Skills                       |
+| ----------------------- | ----------------------------------- |
+| `react`, `react-dom`    | react-patterns                      |
+| `next`                  | react-patterns, seo-patterns        |
+| `@tanstack/react-query` | react-patterns                      |
+| `graphql`, `@apollo`    | graphql-patterns                    |
+| `redis`, `ioredis`      | redis-patterns                      |
+| `pg`, `postgres`        | postgres-patterns                   |
+| `socket.io*`            | realtime-patterns                   |
+| `bullmq`, `bee-queue`   | queue-patterns                      |
+| `passport`, `@auth`     | auth-patterns                       |
+| `openai`, `langchain`   | ai-rag-patterns, prompt-engineering |
+| `playwright`            | e2e-testing                         |
+| `cypress`               | e2e-testing                         |
+| `jest`, `vitest`        | testing-patterns                    |
+| `eslint`, `prettier`    | clean-code                          |
+
+---
+
+## 📋 Workflow Steps
+
+### Phase 1: Analysis
+
+```plaintext
+1. Scan workspace root for config files
+2. Parse package managers (package.json, pubspec.yaml, etc.)
+3. Detect framework markers
+4. Analyze dependencies
+5. Build techstack profile
+```
+
+### Phase 2: Recommendation
+
+```plaintext
+1. Map techstack → required skills/agents
+2. Identify unused skills (candidates for disable)
+3. Identify missing skills (candidates for enable)
+4. Generate recommendation table
+```
+
+### Phase 3: User Confirmation
+
+AI will ask the user:
+
+```markdown
+## 🔍 Workspace Analysis Complete
+
+**Detected Techstack:**
+
+- Next.js 14 (App Router)
+- TypeScript
+- Tailwind CSS
+- Prisma + PostgreSQL
+- Redis
+
+**Recommended Skills (Enable):**
+| Skill | Reason |
+|-------|--------|
+| react-patterns | Next.js detected |
+| tailwind-patterns | tailwind.config.js found |
+| postgres-patterns | Prisma with PostgreSQL |
+| redis-patterns | ioredis in dependencies |
+
+**Recommended to Disable:**
+| Skill | Reason |
+|-------|--------|
+| flutter-patterns | No pubspec.yaml |
+| react-native-patterns | No mobile setup |
+| queue-patterns | No queue dependencies |
+
+**Questions:**
+
+1. Do you want to apply these changes?
+2. Are there any techstacks you plan to add in the future? (e.g., mobile, CI/CD)
+3. Are there any skills you want to force enable/disable?
+```
+
+### Phase 4: Apply & Persist
+
+```plaintext
+1. Update .agent/workspace-profile.json
+2. (Optional) Update ARCHITECTURE.md skills section
+3. Confirm changes to user
+```
+
+---
+
+## 📄 Workspace Profile Format
+
+```json
+{
+  "version": "1.0",
+  "generatedAt": "2026-02-05T12:00:00Z",
+  "techstack": {
+    "languages": ["typescript", "python"],
+    "frameworks": ["nextjs", "tailwindcss"],
+    "databases": ["postgresql"],
+    "tools": ["docker", "github-actions"]
+  },
+  "skills": {
+    "enabled": [
+      "clean-code",
+      "react-patterns",
+      "typescript-patterns",
+      "tailwind-patterns",
+      "database-design",
+      "postgres-patterns",
+      "docker-patterns",
+      "github-actions"
+    ],
+    "disabled": [
+      "flutter-patterns",
+      "react-native-patterns",
+      "mobile-design",
+      "queue-patterns",
+      "gitlab-ci-patterns"
+    ],
+    "userOverrides": {
+      "force-enabled": ["ai-rag-patterns"],
+      "force-disabled": []
+    }
+  },
+  "agents": {
+    "disabled": ["mobile-developer", "queue-specialist"]
+  },
+  "futureTechstack": ["react-native", "kubernetes"]
+}
+```
+
+---
+
+## 🚫 Never Disable (Core Skills)
+
+These skills are ALWAYS enabled regardless of techstack:
+
+- `clean-code`
+- `brainstorming`
+- `plan-writing`
+- `systematic-debugging`
+- `testing-patterns`
+- `security-fundamentals`
+
+---
+
+## 🔧 Manual Override
+
+User can override any recommendation:
+
+```markdown
+/filter --force-enable ai-rag-patterns
+/filter --force-disable mobile-design
+/filter --reset # Reset to default (enable all)
+```
+
+---
+
+## 📊 Integration Points
+
+### With GEMINI.md / CLAUDE.md
+
+Rule files should check `workspace-profile.json` when loading skills:
+
+```markdown
+## Skill Loading Protocol
+
+1. Check if `.agent/workspace-profile.json` exists
+2. If exists, respect enabled/disabled lists
+3. Core skills always loaded regardless of profile
+```
+
+### With Orchestrator
+
+Orchestrator agent should respect skill filtering when routing tasks.
+
+---
+
+## ⚠️ Limitations
+
+1. **Static analysis only** - Does not execute code to detect
+2. **Config-based** - Relies on config files, may miss dynamic setups
+3. **Monorepo** - Needs improvement to handle multiple packages
+
+---

package/common/skills/filter-skill/scripts/workspace_analyzer.py

@@ -0,0 +1,284 @@
+#!/usr/bin/env python3
+"""
+Workspace Analyzer for Filter Skill
+
+Analyzes workspace to detect techstack and recommend skill filtering.
+This script provides structured JSON output for AI agents to process.
+
+Usage:
+    python3 workspace_analyzer.py [workspace_path]
+    python3 workspace_analyzer.py .
+    python3 workspace_analyzer.py /path/to/project
+"""
+
+import json
+import os
+import sys
+from pathlib import Path
+from datetime import datetime
+from typing import Dict, List, Optional, Any
+
+# =============================================================================
+# Detection Mappings
+# =============================================================================
+
+# Config files → Techstack detection
+CONFIG_MAPPINGS = {
+    "package.json": {"type": "package_manager", "tech": "nodejs"},
+    "pubspec.yaml": {"type": "package_manager", "tech": "flutter"},
+    "pyproject.toml": {"type": "package_manager", "tech": "python"},
+    "requirements.txt": {"type": "package_manager", "tech": "python"},
+    "Cargo.toml": {"type": "package_manager", "tech": "rust"},
+    "go.mod": {"type": "package_manager", "tech": "go"},
+    "build.gradle": {"type": "package_manager", "tech": "android"},
+    "build.gradle.kts": {"type": "package_manager", "tech": "android"},
+    "Podfile": {"type": "package_manager", "tech": "ios"},
+    "composer.json": {"type": "package_manager", "tech": "php"},
+    "Gemfile": {"type": "package_manager", "tech": "ruby"},
+}
+
+# Framework markers → Skills
+FRAMEWORK_MAPPINGS = {
+    "next.config.js": ["react-patterns", "seo-patterns", "frontend-design"],
+    "next.config.mjs": ["react-patterns", "seo-patterns", "frontend-design"],
+    "next.config.ts": ["react-patterns", "seo-patterns", "frontend-design"],
+    "vite.config.js": ["react-patterns", "frontend-design"],
+    "vite.config.ts": ["react-patterns", "frontend-design"],
+    "angular.json": ["typescript-patterns", "frontend-design"],
+    "nuxt.config.js": ["frontend-design", "seo-patterns"],
+    "nuxt.config.ts": ["frontend-design", "seo-patterns"],
+    "tailwind.config.js": ["tailwind-patterns"],
+    "tailwind.config.ts": ["tailwind-patterns"],
+    "tailwind.config.mjs": ["tailwind-patterns"],
+    "Dockerfile": ["docker-patterns"],
+    "docker-compose.yml": ["docker-patterns"],
+    "docker-compose.yaml": ["docker-patterns"],
+    ".gitlab-ci.yml": ["gitlab-ci-patterns"],
+}
+
+# Directory patterns → Skills
+DIRECTORY_MAPPINGS = {
+    ".github/workflows": ["github-actions"],
+    "k8s": ["kubernetes-patterns"],
+    "kubernetes": ["kubernetes-patterns"],
+    "terraform": ["terraform-patterns"],
+    "prisma": ["database-design", "postgres-patterns"],
+}
+
+# NPM dependencies → Skills (substring matching)
+NPM_DEPENDENCY_MAPPINGS = {
+    "react": ["react-patterns"],
+    "next": ["react-patterns", "seo-patterns"],
+    "@tanstack/react-query": ["react-patterns"],
+    "vue": ["frontend-design"],
+    "graphql": ["graphql-patterns"],
+    "@apollo": ["graphql-patterns"],
+    "redis": ["redis-patterns"],
+    "ioredis": ["redis-patterns"],
+    "pg": ["postgres-patterns"],
+    "postgres": ["postgres-patterns"],
+    "@prisma/client": ["database-design", "postgres-patterns"],
+    "drizzle-orm": ["database-design"],
+    "socket.io": ["realtime-patterns"],
+    "ws": ["realtime-patterns"],
+    "bullmq": ["queue-patterns"],
+    "bee-queue": ["queue-patterns"],
+    "passport": ["auth-patterns"],
+    "@auth": ["auth-patterns"],
+    "next-auth": ["auth-patterns"],
+    "openai": ["ai-rag-patterns", "prompt-engineering"],
+    "langchain": ["ai-rag-patterns"],
+    "@langchain": ["ai-rag-patterns"],
+    "playwright": ["e2e-testing"],
+    "@playwright": ["e2e-testing"],
+    "cypress": ["e2e-testing"],
+    "jest": ["testing-patterns"],
+    "vitest": ["testing-patterns"],
+    "eslint": ["clean-code"],
+    "prettier": ["clean-code"],
+    "typescript": ["typescript-patterns"],
+}
+
+# All available skills (from ARCHITECTURE.md)
+ALL_SKILLS = [
+    "clean-code", "api-patterns", "database-design", "testing-patterns",
+    "security-fundamentals", "performance-profiling", "brainstorming",
+    "plan-writing", "systematic-debugging", "realtime-patterns",
+    "multi-tenancy", "queue-patterns", "docker-patterns", "kubernetes-patterns",
+    "auth-patterns", "github-actions", "gitlab-ci-patterns", "prompt-engineering",
+    "react-patterns", "typescript-patterns", "e2e-testing", "postgres-patterns",
+    "redis-patterns", "graphql-patterns", "ai-rag-patterns",
+    "monitoring-observability", "terraform-patterns", "flutter-patterns",
+    "react-native-patterns", "seo-patterns", "accessibility-patterns",
+    "mermaid-diagrams", "i18n-localization", "mobile-design",
+    "documentation-templates", "tailwind-patterns", "frontend-design",
+    "ui-ux-pro-max", "nodejs-best-practices"
+]
+
+# Core skills that should NEVER be disabled
+CORE_SKILLS = [
+    "clean-code",
+    "brainstorming", 
+    "plan-writing",
+    "systematic-debugging",
+    "testing-patterns",
+    "security-fundamentals"
+]
+
+# =============================================================================
+# Analyzer Class
+# =============================================================================
+
+class WorkspaceAnalyzer:
+    def __init__(self, workspace_path: str):
+        self.workspace = Path(workspace_path).resolve()
+        self.detected_techs: List[str] = []
+        self.detected_frameworks: List[str] = []
+        self.recommended_skills: set = set()
+        self.config_files_found: List[str] = []
+        self.dependencies: Dict[str, List[str]] = {}
+    
+    def analyze(self) -> Dict[str, Any]:
+        """Run full workspace analysis."""
+        if not self.workspace.exists():
+            return self._error(f"Workspace not found: {self.workspace}")
+        
+        # Step 1: Scan config files
+        self._scan_config_files()
+        
+        # Step 2: Scan framework markers
+        self._scan_framework_markers()
+        
+        # Step 3: Scan directories
+        self._scan_directories()
+        
+        # Step 4: Parse dependencies
+        self._parse_dependencies()
+        
+        # Step 5: Build recommendations
+        return self._build_result()
+    
+    def _scan_config_files(self):
+        """Scan for package manager config files."""
+        for filename, info in CONFIG_MAPPINGS.items():
+            filepath = self.workspace / filename
+            if filepath.exists():
+                self.config_files_found.append(filename)
+                self.detected_techs.append(info["tech"])
+    
+    def _scan_framework_markers(self):
+        """Scan for framework-specific config files."""
+        for filename, skills in FRAMEWORK_MAPPINGS.items():
+            filepath = self.workspace / filename
+            if filepath.exists():
+                self.config_files_found.append(filename)
+                self.recommended_skills.update(skills)
+                # Extract framework name
+                framework = filename.split(".")[0].replace("_", "-")
+                if framework not in ["Dockerfile", "docker-compose"]:
+                    self.detected_frameworks.append(framework)
+    
+    def _scan_directories(self):
+        """Scan for special directories."""
+        for dirname, skills in DIRECTORY_MAPPINGS.items():
+            dirpath = self.workspace / dirname
+            if dirpath.exists() and dirpath.is_dir():
+                self.config_files_found.append(f"{dirname}/")
+                self.recommended_skills.update(skills)
+    
+    def _parse_dependencies(self):
+        """Parse dependencies from package managers."""
+        # Parse package.json
+        package_json = self.workspace / "package.json"
+        if package_json.exists():
+            try:
+                with open(package_json, 'r') as f:
+                    data = json.load(f)
+                
+                all_deps = {}
+                all_deps.update(data.get("dependencies", {}))
+                all_deps.update(data.get("devDependencies", {}))
+                
+                self.dependencies["npm"] = list(all_deps.keys())
+                
+                # Match dependencies to skills
+                for dep_name in all_deps.keys():
+                    for pattern, skills in NPM_DEPENDENCY_MAPPINGS.items():
+                        if pattern in dep_name:
+                            self.recommended_skills.update(skills)
+            except (json.JSONDecodeError, IOError):
+                pass
+        
+        # Parse pubspec.yaml (Flutter)
+        pubspec = self.workspace / "pubspec.yaml"
+        if pubspec.exists():
+            self.recommended_skills.add("flutter-patterns")
+            self.recommended_skills.add("mobile-design")
+    
+    def _build_result(self) -> Dict[str, Any]:
+        """Build final analysis result."""
+        # Add core skills (always recommended)
+        self.recommended_skills.update(CORE_SKILLS)
+        
+        # Determine which skills to disable
+        enabled = list(self.recommended_skills)
+        disabled = [s for s in ALL_SKILLS if s not in enabled]
+        
+        # Remove core skills from disabled (safety check)
+        disabled = [s for s in disabled if s not in CORE_SKILLS]
+        
+        return {
+            "success": True,
+            "analyzedAt": datetime.now().isoformat(),
+            "workspacePath": str(self.workspace),
+            "detection": {
+                "configFiles": self.config_files_found,
+                "technologies": list(set(self.detected_techs)),
+                "frameworks": list(set(self.detected_frameworks)),
+                "dependencies": self.dependencies
+            },
+            "recommendations": {
+                "enable": sorted(enabled),
+                "disable": sorted(disabled),
+                "coreSkills": CORE_SKILLS
+            },
+            "summary": {
+                "totalSkillsAvailable": len(ALL_SKILLS),
+                "recommendedEnabled": len(enabled),
+                "recommendedDisabled": len(disabled),
+                "coreSkillsCount": len(CORE_SKILLS)
+            }
+        }
+    
+    def _error(self, message: str) -> Dict[str, Any]:
+        """Return error result."""
+        return {
+            "success": False,
+            "error": message,
+            "analyzedAt": datetime.now().isoformat()
+        }
+
+
+# =============================================================================
+# Main
+# =============================================================================
+
+def main():
+    # Get workspace path from args or use current directory
+    if len(sys.argv) > 1:
+        workspace_path = sys.argv[1]
+    else:
+        workspace_path = "."
+    
+    analyzer = WorkspaceAnalyzer(workspace_path)
+    result = analyzer.analyze()
+    
+    # Output as JSON for AI to parse
+    print(json.dumps(result, indent=2))
+    
+    # Exit code based on success
+    sys.exit(0 if result.get("success") else 1)
+
+
+if __name__ == "__main__":
+    main()

package/common/workflows/filter.md

@@ -0,0 +1,221 @@
+---
+description: Analyze workspace and enable/disable skills/agents based on techstack
+---
+
+# /filter - Workspace Skill Filtering
+
+## Trigger
+
+User calls `/filter` or requests "filter skills", "optimize skills for this project"
+
+## Agent
+
+No specific agent required - this skill is standalone.
+
+## Prerequisites
+
+- Currently in a workspace with code
+
+## Critical Rules
+
+1. **ALWAYS ASK** - Always ask user confirmation before applying changes
+2. **NEVER DISABLE CORE** - Never disable core skills (clean-code, testing-patterns, etc.)
+3. **PERSIST RESULTS** - Save results to `.agent/workspace-profile.json`
+4. **ASK FUTURE STACK** - Ask user about planned future techstack additions
+
+---
+
+## Workflow Steps
+
+### Step 1: Analyze Workspace
+
+```
+1. Read filter-skill SKILL.md to understand detection criteria
+2. Scan workspace for config files:
+   - package.json, pubspec.yaml, pyproject.toml, Cargo.toml, go.mod
+   - next.config.*, vite.config.*, angular.json, nuxt.config.*
+   - Dockerfile, docker-compose.*, k8s/, kubernetes/
+   - .github/workflows/, .gitlab-ci.yml
+   - prisma/, drizzle.config.*, terraform/
+3. Parse dependencies if package manager exists
+4. Build techstack profile
+```
+
+### Step 2: Generate Recommendations
+
+```
+1. Load skill definitions from ARCHITECTURE.md
+2. Map detected techstack → required skills
+3. Identify skills to ENABLE (missing but needed)
+4. Identify skills to DISABLE (present but not needed)
+5. Build recommendation table
+```
+
+### Step 3: Present to User
+
+Display in this format:
+
+```markdown
+## 🔍 Workspace Analysis Complete
+
+### Detected Techstack
+
+| Category  | Technology              |
+| --------- | ----------------------- |
+| Language  | TypeScript, Python      |
+| Framework | Next.js 14 (App Router) |
+| Styling   | Tailwind CSS v4         |
+| Database  | PostgreSQL (Prisma)     |
+| Cache     | Redis                   |
+| CI/CD     | GitHub Actions          |
+
+### Recommended Changes
+
+#### ✅ Skills to ENABLE:
+
+| Skill             | Reason                   |
+| ----------------- | ------------------------ |
+| react-patterns    | Next.js detected         |
+| tailwind-patterns | tailwind.config.js found |
+| postgres-patterns | Prisma + PostgreSQL      |
+
+#### ❌ Skills to DISABLE:
+
+| Skill            | Reason                   |
+| ---------------- | ------------------------ |
+| flutter-patterns | No pubspec.yaml found    |
+| mobile-design    | No mobile setup detected |
+
+#### 🔒 Core Skills (always ON):
+
+- clean-code, testing-patterns, security-fundamentals, brainstorming, plan-writing
+
+---
+
+### Confirmation Questions:
+
+1. **Do you agree with the changes above?** (yes/no/customize)
+
+2. **Are there any techstacks you plan to add in the future?**
+   (e.g., mobile app, Kubernetes, different CI/CD...)
+
+3. **Are there any skills you want to force enable or disable?**
+   (e.g., keep ai-rag-patterns even though not currently used)
+```
+
+### Step 4: Process User Response
+
+```
+Based on user answer:
+
+If YES:
+  → Apply all recommended changes
+  → Save to workspace-profile.json
+
+If NO / CUSTOMIZE:
+  → Ask which changes to skip/modify
+  → Apply only approved changes
+  → Save to workspace-profile.json
+
+If user mentions FUTURE techstack:
+  → Add to futureTechstack array
+  → Keep relevant skills enabled (don't disable)
+```
+
+### Step 5: Save Profile
+
+Create/Update `.agent/workspace-profile.json`:
+
+```json
+{
+  "version": "1.0",
+  "generatedAt": "ISO timestamp",
+  "analyzedBy": "filter-skill v1.0",
+  "techstack": { ... },
+  "skills": {
+    "enabled": [...],
+    "disabled": [...],
+    "userOverrides": { ... }
+  },
+  "agents": {
+    "disabled": [...]
+  },
+  "futureTechstack": [...]
+}
+```
+
+### Step 6: Confirm
+
+```markdown
+## ✅ Workspace Profile Saved!
+
+**File:** `.agent/workspace-profile.json`
+
+**Summary:**
+
+- Skills enabled: 15
+- Skills disabled: 8
+- Agents disabled: 2
+- Future techstack tracked: 2
+
+**Next steps:**
+
+- Profile will be automatically loaded in subsequent sessions
+- Run `/filter --reset` to re-enable all skills
+- Run `/filter` again when project adds new techstack
+```
+
+---
+
+## Output Format
+
+Final result is the `workspace-profile.json` file saved to disk.
+
+---
+
+## Exit Conditions
+
+- User confirms and profile is saved successfully
+- User cancels mid-process (no save)
+- Error during analysis (report error, no save)
+
+---
+
+## Examples
+
+### Example 1: Next.js + Tailwind Project
+
+```
+User: /filter
+
+AI: [Analyze workspace...]
+
+Detected: Next.js 14, TypeScript, Tailwind CSS, Prisma, PostgreSQL
+
+Recommend ENABLE: react-patterns, tailwind-patterns, postgres-patterns
+Recommend DISABLE: flutter-patterns, mobile-design, queue-patterns
+
+User: yes, future I might add mobile app
+
+AI: [Save profile with futureTechstack: ["react-native"]]
+    [Keep mobile-design enabled for future use]
+```
+
+### Example 2: Python ML Project
+
+```
+User: /filter
+
+AI: [Analyze workspace...]
+
+Detected: Python 3.11, Poetry, FastAPI, PostgreSQL, OpenAI
+
+Recommend ENABLE: api-patterns, postgres-patterns, ai-rag-patterns
+Recommend DISABLE: react-patterns, flutter-patterns, tailwind-patterns, mobile-design
+
+User: customize, keep testing-patterns and docker-patterns
+
+AI: [Apply with user customization]
+```
+
+---

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@neyugn/agent-kits",
-  "version": "0.2.4",
+  "version": "0.2.6",
   "description": "Universal AI Agent Toolkit - Skills, Agents, and Workflows for any AI coding assistant",
   "type": "module",
   "bin": {
@@ -8,7 +8,8 @@
   },
   "files": [
     "dist",
-    "kits"
+    "kits",
+    "common"
   ],
   "keywords": [
     "ai",