@agentskillkit/agent-skills 1.0.1

package/.agent/workflows/validate.md

@@ -0,0 +1,226 @@
+---
+description: Test automation suite. Generate, execute, and analyze test coverage with AAA pattern.
+---
+
+# /validate - Test Automation Suite
+
+$ARGUMENTS
+
+---
+
+## Purpose
+
+Generate comprehensive tests, execute test suites, and analyze coverage. **Follows AAA pattern (Arrange-Act-Assert) with edge case detection.**
+
+---
+
+## Sub-commands
+
+```
+/validate              - Run all tests
+/validate [target]     - Generate tests for specific file/feature
+/validate coverage     - Show coverage report
+/validate watch        - Run in watch mode
+/validate fix          - Auto-fix failing tests
+```
+
+---
+
+## 🔴 MANDATORY: Test Generation Protocol
+
+### Step 1: Analyze Target
+```
+For function/component, identify:
+□ Happy path (normal use)
+□ Edge cases (boundaries, empty, null)
+□ Error cases (invalid input, exceptions)
+□ Integration points (external deps)
+```
+
+### Step 2: Generate Test Cases
+
+| Category | Example |
+|----------|---------|
+| **Happy Path** | Valid input → expected output |
+| **Empty Input** | `""`, `[]`, `null`, `undefined` |
+| **Boundary** | Min value, max value, off-by-one |
+| **Type Errors** | Wrong type, missing property |
+| **Async** | Timeout, race condition, retry |
+| **Security** | XSS, injection, auth bypass |
+
+### Step 3: Apply AAA Pattern
+
+```typescript
+describe('UserService', () => {
+  describe('createUser', () => {
+    it('should create user with valid data', async () => {
+      // ARRANGE
+      const input = {
+        email: 'test@example.com',
+        name: 'Test User',
+      };
+      
+      // ACT
+      const result = await userService.createUser(input);
+      
+      // ASSERT
+      expect(result.id).toBeDefined();
+      expect(result.email).toBe(input.email);
+    });
+
+    it('should throw for invalid email', async () => {
+      // ARRANGE
+      const input = { email: 'invalid', name: 'Test' };
+      
+      // ACT & ASSERT
+      await expect(userService.createUser(input))
+        .rejects.toThrow('Invalid email');
+    });
+  });
+});
+```
+
+---
+
+## Output Format
+
+### Test Generation
+
+```markdown
+## 🧪 Tests: [Target]
+
+### Analysis
+| Aspect | Value |
+|--------|-------|
+| Functions | 5 |
+| Complexity | Medium |
+| Dependencies | 2 (mock required) |
+
+### Test Plan
+
+| Test Case | Type | Priority |
+|-----------|------|----------|
+| Create with valid data | Happy | High |
+| Create with empty name | Edge | Medium |
+| Create with duplicate email | Error | High |
+| Update non-existent user | Error | Medium |
+| Delete with cascade | Integration | High |
+
+### Generated Tests
+
+📁 `tests/services/user.test.ts`
+
+[Generated test code]
+
+---
+
+Run: `npm test`
+Coverage: `npm run coverage`
+```
+
+### Test Execution
+
+```markdown
+## 🧪 Test Results
+
+### Summary
+✅ Passed: 42
+❌ Failed: 2
+⏭️ Skipped: 1
+
+### Failed Tests
+
+**1. UserService.createUser**
+```
+Expected: user object
+Received: null
+
+File: tests/services/user.test.ts:42
+```
+
+**2. AuthService.login**
+```
+Timeout: 5000ms exceeded
+
+File: tests/services/auth.test.ts:28
+```
+
+### Coverage
+
+| Metric | Current | Target | Status |
+|--------|---------|--------|--------|
+| Statements | 78% | 80% | ⚠️ |
+| Branches | 65% | 70% | ⚠️ |
+| Functions | 85% | 80% | ✅ |
+| Lines | 79% | 80% | ⚠️ |
+
+### Uncovered Lines
+
+| File | Lines |
+|------|-------|
+| `src/services/user.ts` | 45-52, 78-80 |
+| `src/utils/validate.ts` | 23-25 |
+
+### Next Steps
+1. Fix 2 failing tests
+2. Add tests for uncovered lines
+3. Run `/validate` again
+```
+
+---
+
+## Examples
+
+```
+/validate
+/validate src/services/auth.ts
+/validate user registration flow
+/validate coverage
+/validate watch
+/validate fix failing tests
+```
+
+---
+
+## Test Framework Detection
+
+| Project Type | Framework | Config |
+|--------------|-----------|--------|
+| Next.js | Vitest | vitest.config.ts |
+| Node.js | Jest | jest.config.js |
+| React | Vitest/RTL | vitest.config.ts |
+| API | Supertest | jest.config.js |
+
+---
+
+## Key Principles
+
+1. **Test behavior, not implementation** - focus on outcomes
+2. **One assertion per test** - easier to debug
+3. **Descriptive names** - test name = documentation
+4. **Mock external deps** - isolate unit under test
+5. **AAA pattern** - consistent structure
+6. **Edge cases first** - catch bugs before happy path
+
+---
+
+## 🔗 Workflow Chain
+
+```mermaid
+graph LR
+    A["/build"] --> B["/validate"]
+    B --> C["/launch"]
+    style B fill:#10b981
+```
+
+| After /validate | Run | Purpose |
+|-----------------|-----|---------|
+| All tests pass | `/launch` | Deploy to production |
+| Tests fail | `/diagnose` | Find root cause |
+| Need review | `/inspect` | Code review |
+
+**Handoff to /launch:**
+```markdown
+Tests: 42/42 passed. Coverage: 85%.
+Run /launch to deploy to production.
+```

package/.editorconfig

@@ -0,0 +1,21 @@
+# EditorConfig helps maintain consistent coding styles
+# https://editorconfig.org
+
+root = true
+
+[*]
+indent_style = space
+indent_size = 4
+end_of_line = lf
+charset = utf-8
+trim_trailing_whitespace = true
+insert_final_newline = true
+
+[*.{json,yml,yaml}]
+indent_size = 2
+
+[*.md]
+trim_trailing_whitespace = false
+
+[Makefile]
+indent_style = tab

package/.github/workflows/release.yml

@@ -0,0 +1,39 @@
+name: Release and Publish
+
+on:
+  push:
+    tags:
+      - 'v*'
+
+permissions:
+  contents: write
+  id-token: write
+
+jobs:
+  release:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Create GitHub Release
+        uses: softprops/action-gh-release@v2
+        with:
+          generate_release_notes: true
+          draft: false
+          prerelease: ${{ contains(github.ref, 'alpha') || contains(github.ref, 'beta') || contains(github.ref, 'rc') }}
+
+  # publish:
+  #   runs-on: ubuntu-latest
+  #   needs: release
+  #   environment: Production
+  #   steps:
+  #     - uses: actions/checkout@v4
+      
+  #     - uses: actions/setup-node@v4
+  #       with:
+  #         node-version: '20.x'
+      
+  #     - run: npm ci
+      
+  #     - name: Publish to NPM
+  #       run: npm publish --provenance --access public

package/CHANGELOG.md

@@ -0,0 +1,38 @@
+# Changelog
+
+All notable changes to the Agent Skills Kit 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).
+
+## [Unreleased]
+
+### Added
+
+- **Intelligent Agent Routing**: Automatic agent selection system that analyzes user requests and routes them to the appropriate specialist(s) without requiring explicit agent mentions
+    - Adds new `intelligent-routing` skill in `.agent/skills/intelligent-routing/`
+    - Integrates automatic routing into GEMINI.md TIER 0 rules
+    - Provides transparent agent selection with user notification (e.g., "🤖 Applying @security-auditor...")
+    - Maintains compatibility with explicit agent mentions and slash commands
+    - Includes comprehensive documentation in `.agent/docs/intelligent-routing-guide.md`
+- Updated README.md with new "Intelligent Routing" section showcasing the automatic agent selection feature
+- Added User Guide for Intelligent Routing with examples and FAQ
+
+### Changed
+
+- Enhanced GEMINI.md with new STEP 3 (Intelligent Agent Routing) in the request processing pipeline
+- Updated agent orchestration workflow to work seamlessly with automatic routing
+
+## [1.0.0] - Unreleased
+
+### Initial Release
+
+- Initial release of Antigravity Kit
+- 19 specialized AI agents
+- 36 domain-specific skills
+- 11 workflow slash commands
+- CLI tool for easy installation and updates
+- Comprehensive documentation and architecture guide
+
+[Unreleased]: #
+[1.0.0]: #

package/LICENSE

@@ -0,0 +1,16 @@
+AGENT SKILLS KIT - PROPRIETARY COMMERCIAL LICENSE
+
+Copyright (c) 2026 Agent Skills Kit Authors. All Rights Reserved.
+
+NOTICE: All information contained herein is, and remains the property of the Agent Skills Kit Authors. The intellectual and technical concepts contained herein are proprietary to the Agent Skills Kit Authors and may be covered by U.S. and Foreign Patents, patents in process, and are protected by trade secret or copyright law.
+
+1. NO REDISTRIBUTION
+Dissemination of this information or reproduction of this material is strictly forbidden unless prior written permission is obtained from the legal owners.
+
+2. COMMERCIAL USE ONLY
+This software is licensed for commercial use only by authorized entities. Any unauthorized use, copying, modification, or distribution is a violation of international copyright laws.
+
+3. NO WARRANTY
+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.
+
+For licensing inquiries, please contact: license@agentskillskit.com

package/README.md

@@ -0,0 +1,294 @@
+# Agent Skills Kit
+
+> **Biến AI Agent của bạn thành chuyên gia đa lĩnh vực chỉ với 1 dòng lệnh**
+
+[![npm](https://img.shields.io/badge/version-1.0.0-7c3aed?style=flat&colorA=18181b)](https://www.npmjs.com/package/add-skill-kit)
+[![skills](https://img.shields.io/badge/skills-48+-7c3aed?style=flat&colorA=18181b)](https://github.com/agentskillkit/agent-skills)
+[![agents](https://img.shields.io/badge/agents-20-7c3aed?style=flat&colorA=18181b)](https://github.com/agentskillkit/agent-skills)
+[![license](https://img.shields.io/badge/license-MIT-7c3aed?style=flat&colorA=18181b)](LICENSE)
+
+---
+
+## 🎉 NEW [Jan 2025]: 48 Skills + 14 Workflows!
+
+Vừa thêm **7 skills mới** từ ClaudeKit-Skills:
+- **problem-solving** - 6 kỹ thuật tư duy sáng tạo (collision-zone, inversion, scale-game...)
+- **context-engineering** - Tối ưu context window cho AI agents
+- **document-skills** - Xử lý Word, PDF, PowerPoint, Excel
+- **debugging** - 3 frameworks debug chuyên sâu
+- **aesthetic** - Design principles anti-AI-slop
+- **mermaidjs-v11** - Diagram generation
+- **sequential-thinking** - Step-by-step reasoning
+
+---
+
+## ⚡ Cài Đặt Ngay (1 Lệnh)
+
+```bash
+npx -y add-skill-kit agentskillkit/agent-skills
+```
+
+Xong. AI Agent của bạn đã được nâng cấp với **48 skills + 20 agents + 14 workflows**.
+
+---
+
+## 🎯 Lợi Ích Cho Bạn (Benefits)
+
+### ⏱️ Tiết Kiệm 100+ Giờ Setup
+
+Thay vì tự viết prompts, rules, và workflows từ đầu - **cài đặt ngay và dùng luôn**. Hệ thống đã được tinh chỉnh qua hàng trăm giờ thử nghiệm.
+
+### 🧠 AI Agent Thông Minh Hơn 10x
+
+AI của bạn sẽ:
+- **Tự động chọn đúng specialist** - Không cần nhớ phải gọi agent nào
+- **Đưa ra code chất lượng production** - Theo best practices từ 48+ skills
+- **Debug nhanh gấp 5 lần** - Với systematic debugging methodology
+
+### 💰 Giảm 80% Token Cost
+
+- **Smart context management** - Chỉ load skill cần thiết
+- **Optimized prompts** - Không token thừa
+- **Reusable workflows** - Không lặp lại instructions
+
+### 🚀 Ship Features Nhanh Hơn
+
+Từ ý tưởng đến production trong vài phút:
+```bash
+/think authentication system
+/architect                         # AI tự tạo plan chi tiết
+/build                             # AI implement theo plan
+/validate                          # AI tự viết tests
+```
+
+---
+
+## 🏆 Ưu Điểm Vượt Trội (Advantages)
+
+| So Với | Agent Skills Kit | Các Giải Pháp Khác |
+|--------|------------------|-------------------|
+| **Số lượng skills** | 48+ skills | 5-10 skills |
+| **Specialist agents** | 20 agents chuyên biệt | 1-3 agents chung |
+| **Slash commands** | 14 workflows có sẵn | Tự viết |
+| **Cross-platform** | Antigravity, Claude Code (coming) | Single platform |
+| **Self-learning** | ✅ Học từ sai lầm | ❌ |
+| **Governance** | ✅ Constitution system | ❌ |
+
+---
+
+## 📚 Skills Catalog (48 Skills)
+
+### 🤖 AI & Agent Development
+| Skill | Mô tả |
+|-------|-------|
+| `context-engineering` | Tối ưu context window, memory systems, multi-agent coordination |
+| `sequential-thinking` | Step-by-step reasoning với khả năng revise và branch |
+| `problem-solving` | 6 kỹ thuật: collision-zone, inversion, scale-game, simplification... |
+| `brainstorming` | Socratic questioning protocol |
+
+### 🎨 Frontend & Design
+| Skill | Mô tả |
+|-------|-------|
+| `frontend` | React patterns, performance, hooks, composition |
+| `frontend-design` | Color system, typography, animation, UX psychology |
+| `aesthetic` | Design principles anti-AI-slop, visual excellence |
+| `react-patterns` | Modern React hooks, composition, TypeScript |
+| `nextjs-best-practices` | App Router, Server Components, SSR/SSG |
+| `tailwind-patterns` | Tailwind CSS v4, container queries, design tokens |
+
+### 🔧 Backend & API
+| Skill | Mô tả |
+|-------|-------|
+| `api-patterns` | REST, GraphQL, tRPC, versioning, rate-limiting |
+| `nodejs-best-practices` | Async patterns, security, architecture |
+| `python-patterns` | Type hints, async, project structure |
+| `database-design` | Schema design, indexing, ORM selection |
+
+### 🛡️ Security & Testing
+| Skill | Mô tả |
+|-------|-------|
+| `vulnerability-scanner` | OWASP 2025, supply chain security |
+| `red-team-tactics` | MITRE ATT&CK, detection evasion |
+| `testing-patterns` | Unit, integration, mocking strategies |
+| `webapp-testing` | E2E, Playwright, load testing |
+| `tdd-workflow` | RED-GREEN-REFACTOR cycle |
+
+### 🐛 Debugging
+| Skill | Mô tả |
+|-------|-------|
+| `systematic-debugging` | 4-phase framework, root cause investigation |
+| `debugging/defense-in-depth` | Validate at every layer |
+| `debugging/root-cause-tracing` | Trace backward to original trigger |
+| `debugging/verification-before-completion` | Evidence before claims |
+
+### 📄 Document Processing
+| Skill | Mô tả |
+|-------|-------|
+| `document-skills/docx` | Word documents với tracked changes |
+| `document-skills/pdf` | PDF extraction, creation, merge/split |
+| `document-skills/pptx` | PowerPoint presentations |
+| `document-skills/xlsx` | Excel với formulas, financial modeling |
+
+### 📊 Visualization
+| Skill | Mô tả |
+|-------|-------|
+| `mermaidjs-v11` | 24+ diagram types, flowcharts, sequence, ER... |
+
+### 🌐 DevOps & Infrastructure
+| Skill | Mô tả |
+|-------|-------|
+| `deployment-procedures` | Safe deployment, rollback strategies |
+| `server-management` | Process management, monitoring, scaling |
+| `performance-profiling` | Measurement, analysis, optimization |
+
+### 📖 Documentation & i18n
+| Skill | Mô tả |
+|-------|-------|
+| `documentation-templates` | README, API docs, code comments |
+| `i18n-localization` | Translations, RTL support, locale files |
+| `seo-fundamentals` | Core Web Vitals, E-E-A-T, Google algorithms |
+| `geo-fundamentals` | Generative Engine Optimization for AI search |
+
+---
+
+## 🤖 20 Specialist Agents
+
+```
+frontend-specialist   → React, Next.js, UI/UX
+backend-specialist    → API, Node.js, databases
+security-auditor      → OWASP, vulnerability scanning
+debugger              → Systematic root cause analysis
+orchestrator          → Multi-agent coordination
+project-planner       → 4-phase planning methodology
+mobile-developer      → React Native, Flutter
+game-developer        → Game development patterns
+test-engineer         → Testing strategies
+database-architect    → Schema, optimization
+... và 10 agents khác
+```
+
+---
+
+## ⚡ 14 Slash Commands
+
+| Command | Chức năng |
+|---------|-----------|
+| `/think` | Khám phá options trước khi code |
+| `/build` | Tạo features/apps mới |
+| `/diagnose` | Debug có hệ thống với root cause analysis |
+| `/launch` | Launch to production với pre-flight checks |
+| `/chronicle` | Generate documentation (README, API, inline) |
+| `/boost` | Thêm/cập nhật features existing app |
+| `/autopilot` | Điều phối multi-agents tự động |
+| `/architect` | Lập kế hoạch task chi tiết |
+| `/stage` | Quản lý preview/staging server |
+| `/inspect` | Code review với systematic verification |
+| `/forge` | Tạo/validate/package skills mới |
+| `/pulse` | Xem tiến độ và health của project |
+| `/validate` | Tạo và chạy tests |
+| `/studio` | Thiết kế UI với 50+ styles, anti-AI-slop |
+
+---
+
+## 🧠 Self-Learning Engine (Production-Ready)
+
+AI không chỉ theo rules - **AI học từ sai lầm của bạn**:
+
+```bash
+# 1. Dạy AI một pattern xấu
+ag-smart learn --add --pattern "console.log" --message "No console.log in production"
+
+# 2. AI tự động detect violations
+ag-smart recall src/
+
+# 3. Xem thống kê
+ag-smart stats
+# 📊 Total Lessons: 5
+# 🎯 Violations Detected: 42
+# 🔥 Most Triggered: [LEARN-002] 20 hits
+
+# 4. Auto-fix violations
+ag-smart fix src/ --eslint
+
+# 5. Real-time monitoring
+ag-smart watch
+
+# 6. Sync hot patterns → SKILL.md
+ag-smart sync-skills
+```
+
+**9 CLI Commands:**
+| Command | Mô tả |
+|---------|-------|
+| `learn` | Thêm/xóa lessons |
+| `recall` | Scan code tìm violations |
+| `audit` | Full compliance check |
+| `fix` | Auto-fix violations |
+| `watch` | Real-time monitoring |
+| `stats` | Knowledge base dashboard |
+| `install-hooks` | Git pre-commit hook |
+| `lint-learn` | Auto-learn từ ESLint |
+| `sync-skills` | Update SKILL.md tự động |
+
+---
+
+## 📁 Cấu Trúc Cài Đặt
+
+```
+your-project/
+└── .agent/
+    ├── skills/        # 47+ domain skills
+    ├── agents/        # 20 specialists
+    ├── workflows/     # 11 slash commands
+    ├── knowledge/     # Self-learning memory
+    ├── rules/         # Global rules
+    ├── .shared/       # UI/UX Pro Max data
+    ├── GEMINI.md      # Agent configuration
+    └── ARCHITECTURE.md
+```
+
+---
+
+## 🎬 Ví Dụ Thực Tế
+
+**Trước (không có Agent Skills Kit):**
+```
+You: "Thêm authentication cho app"
+AI: [Code cơ bản, thiếu security, không có tests]
+```
+
+**Sau (với Agent Skills Kit):**
+```
+You: "Thêm authentication cho app"
+AI: 🤖 Applying @security-auditor + @backend-specialist...
+    - JWT với refresh tokens
+    - Password hashing with bcrypt
+    - Rate limiting
+    - Input validation
+    - Unit tests + integration tests
+    - Security audit passed ✅
+```
+
+---
+
+## 📈 Star History
+
+[![Star History Chart](https://api.star-history.com/svg?repos=agentskillkit/agent-skills&type=Date)](https://star-history.com/#agentskillkit/agent-skills&Date)
+
+---
+
+## 🔗 Links
+
+- [GitHub - agent-skills](https://github.com/agentskillkit/agent-skills)
+- [GitHub - add-skill-kit](https://github.com/agentskillkit/add-skill-kit)
+- [Issues & Feature Requests](https://github.com/agentskillkit/agent-skills/issues)
+
+---
+
+## 📄 License
+
+MIT - Sử dụng tự do cho mọi dự án.
+
+---
+
+**⭐ Star repo nếu hữu ích. Cài đặt ngay. Build something great.**

package/VERSIONING.md

@@ -0,0 +1,45 @@
+# Versioning Guidelines
+
+This project follows [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## Version Format
+
+```
+MAJOR.MINOR.PATCH
+  │      │     └── Bug fixes, small improvements
+  │      └──────── New features, non-breaking changes
+  └─────────────── Breaking changes, major restructures
+```
+
+## When to Bump Versions
+
+### MAJOR (1.0.0 → 2.0.0)
+- Breaking changes to content structure
+- Incompatible skill format changes
+- Major architecture overhaul
+
+### MINOR (1.0.0 → 1.1.0)
+- New agents added
+- New skills added
+- New workflows added
+- Significant content improvements
+
+### PATCH (1.0.0 → 1.0.1)
+- Bug fixes in agents/skills
+- Typo corrections
+- Documentation updates
+- Minor content improvements
+
+## Examples
+
+| Change | Version Bump |
+|--------|--------------|
+| Add 3 new agents | 1.0.0 → 1.1.0 |
+| Fix typo in skill | 1.1.0 → 1.1.1 |
+| Add 5 new skills | 1.1.1 → 1.2.0 |
+| Update workflow logic | 1.2.0 → 1.2.1 |
+| New skill format | 1.2.1 → 2.0.0 |
+
+---
+
+**Current Version:** 1.0.0