Agent Kits

Universal AI Agent Toolkit
_{Skills, Agents, and Workflows for any AI coding assistant}

Quick Start • Features • Kits • Filter Skill • Documentation

English • Tiếng Việt • 中文

✨ 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.

🚀 Quick Start

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

✨ Features

🎯 One Command, Any Tool

npx @neyugn/agent-kits

  ╭──────────────────────────────────────────────────────────────────────────────╮
  │                                                                          │
  │        _     ____  _____  _   _  _____   _  __ ___  _____  ____          │
  │       / \   / ___|| ____|| \ | ||_   _| | |/ /|_ _||_   _|/ ___|         │
  │      / _ \ | |  _ |  _|  |  \| |  | |   | ' /  | |   | |  \___ \         │
  │     / ___ \| |_| || |___ | |\  |  | |   | . \  | |   | |   ___) |        │
  │    /_/   \_\\____||_____||_| \_|  |_|   |_|\_\|___|  |_|  |____/         │
  │                                                                          │
  │           ⚡  The Universal AI Agent Toolkit  ⚡                         │
  │                                                                          │
  ╰──────────────────────────────────────────────────────────────────────────────╯

  SETUP WIZARD

◆  🤖 Which AI assistant are you using?
│  ● Antigravity (.agent/)
│  ○ Cursor (.cursor/)

◆  📂 Where should we install?
│  ● Workspace (Project)
│  ○ Global (System)

🌍 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
Antigravity	.agent/skills/	~/.agent/	✅ Fully Supported
Cursor	.cursor/skills/	~/.cursor/	✅ Fully Supported
Claude Code	.claude/skills/	~/.claude/	🔜 Coming Soon
Gemini CLI	.gemini/skills/	~/.gemini/	🔜 Coming Soon
Codex CLI	.codex/skills/	~/.codex/	🔜 Coming Soon
Custom	Configurable	~/.ai/	🔜 Coming Soon

Note: Tools marked as 🔜 Coming Soon are planned for future releases. The infrastructure is ready, but these tools require additional testing and configuration.

💻 Cross-Platform Support

Works on Windows, macOS, and Linux with automatic path adaptation:

Platform	Example Global Path
Windows	C:\Users\username\.claude\
macOS	/Users/username/.claude/
Linux	/home/username/.claude/

🔍 Filter Skill

The Filter Skill solves the "skill overload" problem by automatically detecting your project's techstack and enabling only relevant skills.

Usage

/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/profile.json

Example

## 🔍 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

/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

📦 Kits

💻 Coder Kit

Complete toolkit for software development with 22 specialist agents, 40 skills, and 7 workflows.

🤖 Agents (22)

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

🧩 Skills (40)

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

📜 Workflows (7)

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.

🔜 Coming Soon

Kit	Description	Status
✍️ Writer	Content creation, copywriting	🚧 In Development
🔬 Researcher	Research, analysis, synthesis	📋 Planned
🎨 Designer	UI/UX design, branding	📋 Planned

🛠️ Usage

Using Agents

Reference agents with @agent-name:

@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:

/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

📚 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

🤝 Contributing

Contributions are welcome! Please see our Contributing Guide for detailed instructions on:

• Creating new kits
• Adding agents and skills
• Submitting pull requests

📄 License

MIT © Neos

---

_{Built with ❤️ for the AI-assisted development community}