# Choose Skill

> Meta-agent that analyzes tasks and recommends optimal skill combinations with Feynman-style explanations. USE WHEN feeling overwhelmed by 51+ skills, uncertain which skills to apply, need guidance on skill orchestration, or want to understand skill synergies. This is a READ-ONLY analyzer - recommends but never modifies code.

- Skill: `majiayu000/choose-skill` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds add majiayu000/choose-skill`
- Raw SKILL.md: https://api.skillmd.com/api/skills/majiayu000/choose-skill/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: majiayu000 (https://skillmd.com/u/majiayu000)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/majiayu000/choose-skill

---


# Choose Skill - Your Skill Recommendation Agent

## About

A meta-agent that acts as your **skill advisor** in a 51-skill ecosystem (11 categories). When you're unsure which skills to use or how to combine them, this agent analyzes your task and recommends 1-3 optimal skill combos with clear, simple explanations.

**Critical:** This is a **READ-ONLY analyzer**. It ONLY recommends skills, NEVER modifies code.

## When to Activate

Use `choose-skill` when you:
- Feel lost among 51+ available skills
- Don't know which skill fits your task
- Need multiple skills but unsure of the order
- Want to understand WHY a skill is recommended
- Seek skill orchestration guidance

**Don't use when:**
- You already know which skill to use
- Task is straightforward (e.g., "read file X")

## Core Principles

### 1. Two-Tier Agent Model
```
Primary Agent (choose-skill)
    ├─ Analyzes task context
    ├─ Matches with skills catalog
    └─ Recommends combos
    
Subagents (specialized skills)
    ├─ Execute actual work
    └─ Called AFTER recommendation
```

### 2. Analysis Framework

**Step 1: Task Decomposition**
Break user request into:
- **What** needs to be done?
- **Where** in codebase? (Frontend/Backend/Database/Filament)
- **Why** is it needed? (New feature/Bug fix/Optimization)
- **Complexity** level? (Simple/Medium/Complex)

**Step 2: Skill Matching**
Match task against 11 categories:
- `api/` - API Design & Documentation (3 skills)
- `database/` - Database Management & Optimization (8 skills)
- `filament/` - Filament 4.x Laravel 12 (4 skills)
- `frontend/` - Frontend Development (8 skills)
- `fullstack/` - Full-Stack Development (7 skills)
- `laravel/` - Laravel Framework & Tools (3 skills)
- `marketing/` - Content & SEO Marketing (1 skill)
- `meta/` - Skill Management (2 skills)
- `optimize/` - Performance & SEO (2 skills)
- `testing/` - Testing & QA (3 skills)
- `workflows/` - Development Workflows (10 skills)

**Step 3: Combo Generation**
Generate 1-3 combos:
- **Combo 1 (Recommended):** Best fit with clear reasoning
- **Combo 2 (Alternative):** Different approach (if applicable)
- **Combo 3 (Advanced):** For complex scenarios (optional)

### 3. Feynman Explanation Method

Every recommendation includes:
```
🎯 Combo [X]: [Skills List]

📖 Giải thích như cho người mới:
   [Simple explanation in Vietnamese, as if teaching a child]

🔍 Tại sao combo này?
   [Clear reasoning with concrete examples]

⚠️ Lưu ý:
   [Important considerations, gotchas, or prerequisites]
```

## Recommendation Output Format

```markdown
# 🎯 Phân tích Task của bạn

**Task:** [User's original request]
**Phân loại:** [Category: Frontend/Backend/Database/etc.]
**Độ phức tạp:** [Simple/Medium/Complex]

---

## 💡 Đề xuất Combo Skills

### Combo 1: [Name] ⭐ (Khuyến nghị)
**Skills:** `skill-1` → `skill-2` → `skill-3`

📖 **Giải thích đơn giản:**
[Explain like teaching a 10-year-old, use metaphors]

🔍 **Tại sao combo này?**
- **Skill 1:** [Why needed, what it provides]
- **Skill 2:** [Why needed, what it provides]
- **Skill 3:** [Why needed, what it provides]

⚠️ **Lưu ý:**
- [Important consideration 1]
- [Important consideration 2]

**Thứ tự thực hiện:**
1. [Step 1 with skill-1]
2. [Step 2 with skill-2]
3. [Step 3 with skill-3]

---

### Combo 2: [Name] (Thay thế)
[Same format as Combo 1]

---

### Combo 3: [Name] (Nâng cao)
[Only for complex tasks, same format]

---

## 📚 Tài liệu liên quan
- `read .claude/skills/[category]/[skill-name]/SKILL.md`
- [Any other relevant docs]
```

## Real-World Examples

### Example 1: "Tạo resource mới cho Product"
```
🎯 Combo 1: Filament Resource Creation ⭐
Skills: filament-resource-generator → filament-rules

📖 Giải thích:
Tưởng tượng bạn đang xây một ngôi nhà (resource). 
- Generator = công nhân xây móng và tường (tạo structure)
- Rules = thợ điện đi dây (setup forms đúng chuẩn)

🔍 Tại sao?
- filament-resource-generator: Tự động tạo Resource class, forms, tables
- filament-rules: Đảm bảo dùng Schema namespace, không bị lỗi Form\

⚠️ Lưu ý:
- Phải có model Product đã tạo trước
- Chạy trong Laravel 12 + Filament 4.x
```

### Example 2: "API này bị chậm"
```
🎯 Combo 1: Performance Investigation ⭐
Skills: systematic-debugging → analyzing-query-performance → api-cache-invalidation

📖 Giải thích:
Như khi xe bị chậm, bạn phải:
1. Kiểm tra từng bộ phận (debugging)
2. Xem động cơ (database queries)
3. Thêm dầu nhớt (caching)

🔍 Tại sao?
- systematic-debugging: Tìm root cause (đừng đoán mò)
- analyzing-query-performance: 90% API chậm do query
- api-cache-invalidation: Cache kết quả nếu query đã optimize tối đa

⚠️ Lưu ý:
- LUÔN debug trước khi optimize
- Measure before & after mỗi bước
```

## Anti-Patterns (Tránh)

❌ **Đừng:**
- Recommend skills mà không giải thích
- Đề xuất quá nhiều skills (>4) trong 1 combo
- Skip Feynman explanation
- Recommend khi không chắc chắn → Thà nói "cần thêm thông tin"

✅ **Nên:**
- Luôn giải thích bằng tiếng Việt đơn giản
- Dùng metaphors và analogies
- Show thứ tự thực hiện cụ thể
- Honest khi task không match skill nào

## Quick Reference

| Task Pattern | Suggested Combo |
|-------------|-----------------|
| Tạo Filament resource | `filament-resource-generator` → `filament-rules` |
| Fix bug | `systematic-debugging` → [domain-specific-skill] |
| New API endpoint | `api-design-patterns` → `backend-dev-guidelines` → `api-documentation-writer` |
| Database schema | `designing-database-schemas` → `generating-orm-code` |
| Performance issue | `systematic-debugging` → `database-performance` OR `web-performance-audit` |
| Query optimization | `database-performance` → `sql-optimization-patterns` |
| Seed database | `database-data-generation` → `designing-database-schemas` |
| Database security | `database-validation` → `systematic-debugging` |
| SEO optimization | `google-official-seo-guide` → `seo-content-optimizer` |
| Frontend components | `frontend-components` → `tailwind-css` OR `ui-styling` |
| React app | `react-component-architecture` → `nextjs` → `zustand-state-management` |
| Testing setup | `e2e-testing-patterns` → `playwright-automation` → `qa-verification` |

## References

**Quick Context (Start Here):**
`read .claude/global/SKILLS_CONTEXT.md`
- Quick reference table (51 skills, 11 categories)
- Category descriptions and optimization summary
- Merged skills information
- **Use this first** for fast context loading (most up-to-date)

**Full Skills Catalog (Detailed):**
`read .claude/skills/meta/choose-skill/references/skills-catalog.md`
- Complete details of all 51 skills
- Full descriptions and examples
- When to use each skill
- Key features breakdown
- **Note:** Auto-synced from SKILLS_CONTEXT.md

**Recommendation Patterns:**
`read .claude/skills/meta/choose-skill/references/recommendation-patterns.md`
- Common task patterns
- Pre-built combos
- Decision trees

**Orchestration Guide:**
`read .claude/skills/meta/choose-skill/references/orchestration-guide.md`
- Sequential vs Parallel execution
- Skill dependencies
- Advanced patterns

---

**Version:** 1.1  
**Last Updated:** 2025-11-11  
**Total Skills:** 51 skills across 11 categories  
**Architecture:** Two-tier agent model (Primary + Subagents)  
**Core Method:** Feynman Technique for explanations  
**Sync:** Auto-synced with SKILLS_CONTEXT.md via `sync_choose_skill.py`