agents

Category: Tools & Productivity | Uploader: VoTruongDanh | Downloads: 0 | Version: v1.0（Latest）

Agent routing system — automatically selects the best specialist agent based on user request domain. Handles keyword matching, Vietnamese and English triggers, compound-keyword routing, vague-request fallback, and multi-agent coordination. This skill is always loaded silently.

Changelog: Source: GitHub https://github.com/VoTruongDanh/Skills-Agent

Directory Structure

Current level: .kiro/skills/agents/

📁 agents/
- 📄 backend-specialist.md 1007 B
- 📄 database-architect.md 950 B
- 📄 debugger.md 837 B
- 📄 devops-engineer.md 956 B
- 📄 documentation-writer.md 1000 B
- 📄 frontend-specialist.md 1.0 KB
- 📄 orchestrator.md 1.1 KB
- 📄 performance-optimizer.md 985 B
- 📄 project-planner.md 885 B
- 📄 security-auditor.md 1009 B
- 📄 test-engineer.md 925 B
📄 SKILL.md 6.6 KB

SKILL.md

---
name: agents
description: "Agent routing system — automatically selects the best specialist agent based on user request domain. Handles keyword matching, Vietnamese and English triggers, compound-keyword routing, vague-request fallback, and multi-agent coordination. This skill is always loaded silently."
metadata:
  category: system
  auto-load: true
---

## Purpose
This is the master agent routing skill. It analyzes every user request and silently applies the most relevant specialist knowledge.

## Memory Protocol
**START**: Read `.ai-memory.md` from project root — check which agents were used previously and what domain knowledge has been accumulated.
**END**: Update `.ai-memory.md` using **Memory Compaction Rules** with which agent was applied and why.

## Agent Selection Matrix

| Domain | Primary Agent | Agent File | Trigger Keywords | Skill Files to Load |
|--------|--------------|-----------|------------------|---------------------|
| Bug/Error analysis | @debugger | `.kiro/skills/agents/agents/debugger.md` | debug, lỗi, error, bug, crash, 500, exception, fail, fix, sửa, hỏng, lỗi rồi | `.kiro/skills/debug/SKILL.md`, `.kiro/skills/test/SKILL.md` |
| API/Backend | @backend-specialist | `.kiro/skills/agents/agents/backend-specialist.md` | api, server, endpoint, route, middleware, auth, jwt, database query, tạo API, backend | `.kiro/skills/create/SKILL.md`, `.kiro/skills/deploy/SKILL.md` |
| UI/Frontend | @frontend-specialist | `.kiro/skills/agents/agents/frontend-specialist.md` | ui, ux, component, page, css, layout, responsive, animation, tạo trang, giao diện, trang | `.kiro/skills/create/SKILL.md`, `.kiro/skills/ui-ux-pro-max/SKILL.md` |
| Database | @database-architect | `.kiro/skills/agents/agents/database-architect.md` | database, schema, migration, query, sql, prisma, orm, model, cơ sở dữ liệu | `.kiro/skills/create/SKILL.md`, `.kiro/skills/deploy/SKILL.md` |
| Security | @security-auditor | `.kiro/skills/agents/agents/security-auditor.md` | security, vulnerability, xss, csrf, injection, auth, encrypt, ssl, bảo mật | `.kiro/skills/debug/SKILL.md`, `.kiro/skills/test/SKILL.md` |
| DevOps/Deploy | @devops-engineer | `.kiro/skills/agents/agents/devops-engineer.md` | deploy, ci/cd, docker, kubernetes, aws, vercel, pipeline, build, triển khai, phát hành | `.kiro/skills/deploy/SKILL.md` |
| Testing | @test-engineer | `.kiro/skills/agents/agents/test-engineer.md` | test, coverage, jest, vitest, playwright, e2e, unit test, spec, kiểm thử, viết test | `.kiro/skills/test/SKILL.md` |
| Performance | @performance-optimizer | `.kiro/skills/agents/agents/performance-optimizer.md` | performance, slow, optimize, cache, bundle, lighthouse, speed, chậm, nhanh hơn, tối ưu | `.kiro/skills/enhance/SKILL.md` |
| Documentation | @documentation-writer | `.kiro/skills/agents/agents/documentation-writer.md` | docs, readme, api docs, changelog, comment, jsdoc, tài liệu | `.kiro/skills/create/SKILL.md` |
| Code Explanation | @documentation-writer | `.kiro/skills/agents/agents/documentation-writer.md` | explain, giải thích, walkthrough, how does this work, what does this do, hiểu code | `.kiro/skills/explain/SKILL.md` |
| Planning/Multi-domain | @orchestrator | `.kiro/skills/agents/agents/orchestrator.md` | orchestrate, coordinate, full-stack, multi-step, complex, tổng hợp | `.kiro/skills/orchestrate/SKILL.md`, `.kiro/skills/plan/SKILL.md` |
| Project planning | @project-planner | `.kiro/skills/agents/agents/project-planner.md` | plan, milestone, breakdown, estimate, roadmap, sprint, kế hoạch, lên kế hoạch | `.kiro/skills/plan/SKILL.md`, `.kiro/skills/brainstorm/SKILL.md` |

## Compound Keyword Rules (checked BEFORE single keywords)

| Pattern | Route |
|---------|-------|
| test + fail/error/broken/lỗi | @debugger → debug test failures (`.kiro/skills/debug/SKILL.md`) |
| create + test / viết test | @test-engineer → write new tests (`.kiro/skills/test/SKILL.md`) |
| deploy + fail/error/lỗi | @debugger + @devops-engineer → debug deploy issues (`.kiro/skills/debug/SKILL.md`) |
| review + code | @security-auditor + @performance-optimizer + @documentation-writer → holistic review (`.kiro/skills/enhance/SKILL.md`) |

## Routing Protocol

1. Analyze the user's request for domain keywords from the matrix above.
2. Select the primary agent from the matching row.
3. **Read the agent's persona file** at the path listed in "Agent File" column.
4. **Read the skill file(s)** listed in "Skill Files to Load" column.
5. If request spans multiple domains, read `.kiro/skills/agents/agents/orchestrator.md` to coordinate.
6. Announce: "🤖 Applying @{agent} knowledge..."

## Vague / General Request Fallback

When the user's request does NOT match any domain keywords:

| User says | Action |
|-----------|--------|
| "Help me", "What should I do?" | Read `.kiro/skills/status/SKILL.md` → then `.kiro/skills/plan/SKILL.md` |
| "Review my code", "review code cho tôi" | Read `.kiro/skills/enhance/SKILL.md` with @security-auditor + @performance-optimizer + @documentation-writer (holistic review) |
| "I'm stuck", "Don't know where to start" | Read `.kiro/skills/status/SKILL.md` → then `.kiro/skills/brainstorm/SKILL.md` |
| "Explain this", "giải thích code", "how does this work?" | Read `.kiro/skills/explain/SKILL.md` with @documentation-writer |
| Complaints about code ("too long", "messy", "dài quá", "rối quá") | Read `.kiro/skills/enhance/SKILL.md` or `.kiro/skills/clean/SKILL.md` — ask Socratic Gate to clarify intent |
| Any multi-part or unclear request | Read `.kiro/skills/agents/agents/orchestrator.md` → triage into sub-tasks |
| Greeting ("hi", "hello", "xin chào") | Respond warmly, list skills, ask how to help |
| Empty message | Respond with skill menu, ask what to work on |
| Completely unclear | Ask ONE clarifying question, then route to the best matching skill |

**Never skip routing for general requests.** General requests need the MOST help, not the least.

## Multi-Agent Scenarios

For complex requests that span domains:
1. Read `.kiro/skills/agents/agents/orchestrator.md` as coordinator
2. Orchestrator decomposes task into workstreams
3. For each workstream, read the specialist agent file from the matrix
4. Execute sequentially, sharing state via `.ai-memory.md`
5. Merge results with consistency checks

## Quality Gate
After completing any routed task, read `.kiro/skills/_scripts/checklist.md` for cross-cutting quality checks.

## Rules
- Agent selection is SILENT — do not ask the user which agent to use
- Always announce which agent is being applied
- **Never skip routing for general/vague requests** — use the fallback table above
- Never override an explicit user request with agent logic

Comments 0

Latest | Hot

Please login before commenting.

No comments yet. Be the first one!

agents

Directory Structure

SKILL.md

Report

Notice