@neyugn/agent-kits 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 Neos
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,514 @@
+<p align="center">
+  <img src="./assets/logo.svg" width="200" alt="Agent Kits Logo" />
+</p>
+
+<h1 align="center">Agent Kits</h1>
+
+<p align="center">
+  <b>Universal AI Agent Toolkit</b><br/>
+  <sub>Skills, Agents, and Workflows for any AI coding assistant</sub>
+</p>
+
+<p align="center">
+  <a href="https://www.npmjs.com/package/@neyugn/agent-kits"><img src="https://img.shields.io/npm/v/@neyugn/agent-kits?style=flat-square&color=00ADD8" alt="npm version" /></a>
+  <a href="https://www.npmjs.com/package/@neyugn/agent-kits"><img src="https://img.shields.io/npm/dm/@neyugn/agent-kits?style=flat-square&color=00ADD8" alt="npm downloads" /></a>
+  <a href="https://github.com/nvdnvd00/agent-kits/blob/main/LICENSE"><img src="https://img.shields.io/badge/license-MIT-blue?style=flat-square" alt="license" /></a>
+</p>
+
+<p align="center">
+  <a href="#-quick-start">Quick Start</a> •
+  <a href="#-features">Features</a> •
+  <a href="#-kits">Kits</a> •
+  <a href="#-filter-skill">Filter Skill</a> •
+  <a href="#-documentation">Documentation</a>
+</p>
+
+<p align="center">
+  <b>English</b> •
+  <a href="./README.vi.md">Tiếng Việt</a> •
+  <a href="./README.zh.md">中文</a>
+</p>
+
+<br/>
+
+## ✨ What is Agent Kits?
+
+**Agent Kits** is a universal toolkit that supercharges your AI coding assistant with:
+
+- 🤖 **Specialist Agents** — Pre-defined personas with deep domain expertise
+- 🧩 **Reusable Skills** — Best practices and decision frameworks
+- 📜 **Workflows** — Slash commands for common tasks
+- 🔍 **Smart Filtering** — Auto-detect techstack and optimize loaded skills
+
+Works with **any AI tool** — Claude, Gemini, Codex, Cursor, and more.
+
+<br/>
+
+## 🚀 Quick Start
+
+```bash
+npx @neyugn/agent-kits
+```
+
+That's it! The interactive installer will guide you through:
+
+1. Selecting your AI tool (Claude, Gemini, Cursor, etc.)
+2. Choosing installation scope (Global or Workspace)
+3. Selecting which kits to install
+4. Confirming the installation path
+
+<br/>
+
+## ✨ Features
+
+### 🎯 One Command, Any Tool
+
+```bash
+npx @neyugn/agent-kits
+```
+
+```
+╔═══════════════════════════════════════════════════════════════╗
+║     █████╗  ██████╗ ███████╗███╗   ██╗████████╗               ║
+║    ██╔══██╗██╔════╝ ██╔════╝████╗  ██║╚══██╔══╝               ║
+║    ███████║██║  ███╗█████╗  ██╔██╗ ██║   ██║                  ║
+║    ██╔══██║██║   ██║██╔══╝  ██║╚██╗██║   ██║                  ║
+║    ██║  ██║╚██████╔╝███████╗██║ ╚████║   ██║                  ║
+║    ╚═╝  ╚═╝ ╚═════╝ ╚══════╝╚═╝  ╚═══╝   ╚═╝  K I T S        ║
+╚═══════════════════════════════════════════════════════════════╝
+
+◆  Which AI tool are you using?
+│  ○ Claude Code (.claude/)
+│  ● Gemini CLI (.gemini/)
+│  ○ Cursor (.cursor/)
+│  ○ Custom...
+
+◆  Where do you want to install?
+│  ● 📁 Workspace (Current Project)
+│  ○ 🌍 Global (All Projects)
+```
+
+### 🌍 Global vs Workspace Installation
+
+| Mode         | Location      | Use Case                       |
+| ------------ | ------------- | ------------------------------ |
+| 📁 Workspace | `./{{tool}}/` | Project-specific configuration |
+| 🌍 Global    | `~/{{tool}}/` | Shared across all projects     |
+
+**Global Paths by Tool:**
+
+| Tool        | Global Path  | Workspace Path |
+| ----------- | ------------ | -------------- |
+| Claude Code | `~/.claude/` | `.claude/`     |
+| Gemini CLI  | `~/.gemini/` | `.gemini/`     |
+| Codex CLI   | `~/.codex/`  | `.codex/`      |
+| Antigravity | `~/.agent/`  | `.agent/`      |
+| Cursor      | `~/.cursor/` | `.cursor/`     |
+
+> **Note:** On Windows, `~` is replaced with `C:\Users\<username>\`
+
+### 🔄 Existing Installation Detection
+
+If the installer detects an existing installation, you'll be prompted:
+
+- **🔄 Replace**: Remove existing and install fresh
+- **🔀 Merge**: Keep config files, update skills only
+- **⏭️ Skip**: Keep existing, don't install
+- **❌ Cancel**: Exit installer
+
+### 🔌 Universal Compatibility
+
+| Tool        | Workspace Path    | Global Path  | Status       |
+| ----------- | ----------------- | ------------ | ------------ |
+| Claude Code | `.claude/skills/` | `~/.claude/` | ✅ Supported |
+| Gemini CLI  | `.gemini/skills/` | `~/.gemini/` | ✅ Supported |
+| Codex CLI   | `.codex/skills/`  | `~/.codex/`  | ✅ Supported |
+| Antigravity | `.agent/skills/`  | `~/.agent/`  | ✅ Supported |
+| Cursor      | `.cursor/skills/` | `~/.cursor/` | ✅ Supported |
+| Custom      | Configurable      | `~/.ai/`     | ✅ Supported |
+
+### 💻 Cross-Platform Support
+
+Works on **Windows**, **macOS**, and **Linux** with automatic path adaptation:
+
+| Platform | Example Global Path        |
+| -------- | -------------------------- |
+| Windows  | `C:\Users\darien\.claude\` |
+| macOS    | `/Users/darien/.claude/`   |
+| Linux    | `/home/darien/.claude/`    |
+
+<br/>
+
+## 🔍 Filter Skill
+
+The **Filter Skill** solves the "skill overload" problem by automatically detecting your project's techstack and enabling only relevant skills.
+
+### Usage
+
+```bash
+/filter
+```
+
+### How It Works
+
+| Phase                 | Description                                                                 |
+| --------------------- | --------------------------------------------------------------------------- |
+| **1. Detection**      | Scans for config files (`package.json`, `pubspec.yaml`, `Dockerfile`, etc.) |
+| **2. Recommendation** | Maps detected techstack to required skills                                  |
+| **3. Confirmation**   | Presents changes and asks about future techstack plans                      |
+| **4. Persistence**    | Saves profile to `.agent/workspace-profile.json`                            |
+
+### Example
+
+```markdown
+## 🔍 Workspace Analysis Complete
+
+**Detected Techstack:**
+| Category | Technology |
+| --------- | ----------------------- |
+| Language | TypeScript |
+| Framework | Next.js 14 (App Router) |
+| Styling | Tailwind CSS v4 |
+| Database | PostgreSQL (Prisma) |
+
+**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 |
+
+**Questions:**
+
+1. Do you agree with the changes? (yes/no/customize)
+2. Are there any techstacks you plan to add in the future?
+```
+
+### Commands
+
+```bash
+/filter                           # Analyze and filter skills
+/filter --force-enable ai-rag     # Force enable specific skill
+/filter --force-disable mobile    # Force disable specific skill
+/filter --reset                   # Reset to default (enable all)
+```
+
+### Core Skills (Never Disabled)
+
+These skills are always enabled regardless of techstack:
+
+| Skill                   | Description                   |
+| ----------------------- | ----------------------------- |
+| `clean-code`            | Pragmatic coding standards    |
+| `brainstorming`         | Socratic questioning protocol |
+| `plan-writing`          | Task breakdown and WBS        |
+| `systematic-debugging`  | 4-phase debugging             |
+| `testing-patterns`      | Testing pyramid patterns      |
+| `security-fundamentals` | OWASP 2025 security           |
+
+<br/>
+
+## 📦 Kits
+
+### 💻 Coder Kit
+
+Complete toolkit for software development with **22 specialist agents**, **40 skills**, and **7 workflows**.
+
+<details>
+<summary><b>🤖 Agents (22)</b></summary>
+
+#### Tier 1: Master Agents
+
+| Agent             | Description              |
+| ----------------- | ------------------------ |
+| `orchestrator`    | Multi-agent coordination |
+| `project-planner` | Smart project planning   |
+| `debugger`        | Systematic debugging     |
+
+#### Tier 2: Development Specialists
+
+| Agent                 | Description                |
+| --------------------- | -------------------------- |
+| `frontend-specialist` | React, Next.js, Vue, UI/UX |
+| `backend-specialist`  | APIs, Node.js, Python      |
+| `mobile-developer`    | React Native, Flutter      |
+| `database-specialist` | Schema design, queries     |
+| `devops-engineer`     | CI/CD, deployment          |
+
+#### Tier 3: Quality & Security
+
+| Agent                 | Description                 |
+| --------------------- | --------------------------- |
+| `security-auditor`    | OWASP 2025, vulnerabilities |
+| `code-reviewer`       | PR reviews, code quality    |
+| `test-engineer`       | TDD, testing pyramid        |
+| `performance-analyst` | Core Web Vitals, profiling  |
+
+#### Tier 4: Domain Specialists
+
+| Agent                    | Description                     |
+| ------------------------ | ------------------------------- |
+| `realtime-specialist`    | WebSocket, Socket.IO            |
+| `multi-tenant-architect` | Tenant isolation, SaaS          |
+| `queue-specialist`       | Message queues, background jobs |
+| `integration-specialist` | External APIs, webhooks         |
+| `ai-engineer`            | LLM, RAG, AI/ML systems         |
+| `cloud-architect`        | AWS, Azure, GCP, Terraform      |
+| `data-engineer`          | ETL, pipelines, analytics       |
+
+#### Tier 5: Support Agents
+
+| Agent                  | Description              |
+| ---------------------- | ------------------------ |
+| `documentation-writer` | Technical docs, API docs |
+| `i18n-specialist`      | Internationalization     |
+| `ux-researcher`        | UX research, usability   |
+
+</details>
+
+<details>
+<summary><b>🧩 Skills (40)</b></summary>
+
+**Core Skills:**
+| Skill | Description |
+| ----------------------- | ----------------------------- |
+| `clean-code` | Pragmatic coding standards |
+| `api-patterns` | REST/GraphQL/tRPC decisions |
+| `database-design` | Schema design, indexing |
+| `testing-patterns` | Unit, integration, E2E |
+| `security-fundamentals` | OWASP 2025, secure coding |
+| `performance-profiling` | Core Web Vitals, optimization |
+
+**Process Skills:**
+| Skill | Description |
+| ----------------------- | ----------------------------- |
+| `brainstorming` | Socratic questioning protocol |
+| `plan-writing` | Task breakdown, WBS |
+| `systematic-debugging` | 4-phase debugging |
+
+**Domain Skills (31):** `react-patterns`, `typescript-patterns`, `docker-patterns`, `kubernetes-patterns`, `terraform-patterns`, `auth-patterns`, `graphql-patterns`, `redis-patterns`, `realtime-patterns`, `queue-patterns`, `multi-tenancy`, `ai-rag-patterns`, `prompt-engineering`, `monitoring-observability`, `frontend-design`, `mobile-design`, `tailwind-patterns`, `e2e-testing`, `github-actions`, `gitlab-ci-patterns`, `flutter-patterns`, `react-native-patterns`, `seo-patterns`, `accessibility-patterns`, `mermaid-diagrams`, `i18n-localization`, `postgres-patterns`, `nodejs-best-practices`, `documentation-templates`, `ui-ux-pro-max`, `aws-patterns`
+
+</details>
+
+<details>
+<summary><b>📜 Workflows (7)</b></summary>
+
+| Command          | Description                   |
+| ---------------- | ----------------------------- |
+| `/plan`          | Create project plan (no code) |
+| `/create`        | Build new application         |
+| `/debug`         | Systematic debugging          |
+| `/test`          | Generate and run tests        |
+| `/deploy`        | Production deployment         |
+| `/orchestrate`   | Multi-agent coordination      |
+| `/ui-ux-pro-max` | UI/UX design intelligence     |
+
+> **Note:** The `/filter` command is part of **Common Skills Layer** (see below) and available in all kits.
+
+</details>
+
+### 🔜 Coming Soon
+
+| Kit               | Description                   | Status            |
+| ----------------- | ----------------------------- | ----------------- |
+| ✍️ **Writer**     | Content creation, copywriting | 🚧 In Development |
+| 🔬 **Researcher** | Research, analysis, synthesis | 📋 Planned        |
+| 🎨 **Designer**   | UI/UX design, branding        | 📋 Planned        |
+
+<br/>
+
+## 🛠️ Usage
+
+### Using Agents
+
+Reference agents with `@agent-name`:
+
+```markdown
+@backend-specialist design an API for user management
+@security-auditor review this authentication code
+@test-engineer write tests for the payment service
+```
+
+### Using Workflows
+
+Invoke workflows with slash commands:
+
+```bash
+/plan my new e-commerce site     # Create project plan
+/create todo app                 # Build application
+/debug login not working         # Fix bugs
+/test user service               # Generate tests
+/filter                          # Optimize skills for workspace
+```
+
+<br/>
+
+## 📚 Documentation
+
+After installation, find documentation in your project:
+
+- **Architecture Guide**: `<path>/ARCHITECTURE.md`
+- **Agent Details**: `<path>/agents/*.md`
+- **Skill Guides**: `<path>/skills/*/SKILL.md`
+- **Workflow Docs**: `<path>/workflows/*.md`
+- **Common Skills**: `common/COMMON.md`
+
+<br/>
+
+## 🤝 Contributing
+
+Contributions are welcome! Please see our [Contributing Guide](CONTRIBUTING.md).
+
+### 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
+```
+
+<br/>
+
+## 📄 License
+
+MIT © [Neos](https://github.com/nvdnvd00)
+
+---
+
+<p align="center">
+  <sub>Built with ❤️ for the AI-assisted development community</sub>
+</p>