Luật được nạp thế nào trong một phiên:
flowchart TD
S([Phiên Claude Code]) --> A["CLAUDE.md<br/>từ presets/ hoặc templates/<br/>giao tiếp · run summary · hard rules L1–L10"]
S --> O["output-styles/<br/>ngôn ngữ trả lời"]
S --> C["rules/core/<br/>F · W · D · C · P — luôn nạp"]
S --> T{"Đang đụng file nào?"}
T -- "*.ts / *.tsx / *.js / *.jsx" --> TS["rules/typescript/"]
T -- "*.tsx / *.jsx" --> R["rules/react/"]
T -- "docs/**, README, AGENTS, CHANGELOG" --> D["rules/docs/"]
S --> K["skills/<br/>nạp khi task khớp"]
S --> AG["agents/<br/>subagent gọi khi cần"]
WR["Write"] --> H["hooks/file-guard.sh<br/>cảnh báo tên file junk / file quá lớn"]
subgraph CX["Codex / Cursor"]
G["scripts/render-agent-rules.sh"] --> X["~/.codex/AGENTS.md"]
L["~/.agents/skills"]
end
A & C & D --> G
K -- symlink --> L
Tiếng Việt · English
Bộ toolkit của Kyant — custom agents, skills, rules & vibe-coding presets cho Claude Code và Codex, dựng từ lúc livestream hàng ngày.
Bắt đầu nhanh · Cài bằng CLI · Agents · Skills · Presets
Một phần hệ thống kênh Kyant (live vibe coding). Không publish session, memory hay secrets (xem .gitignore).
npx github:mxrsv/agents-skills installMột vài lệnh hay dùng:
npx github:mxrsv/agents-skills install --all
npx github:mxrsv/agents-skills install --preset kyant-vibe
npx github:mxrsv/agents-skills install --skill brainstorm --agent planner
npx github:mxrsv/agents-skills listKhông cần clone:
npx github:mxrsv/agents-skills
npx github:mxrsv/agents-skills installLuồng tương tác:
- Chọn cái cần cài — hết, skills/agents/rules, một CLAUDE.md preset, hoặc chọn từng mục (
1 3 5,1-4, hoặca) - Platform — Claude Code, Codex, hoặc cả hai
- Target — global (
~/.claude/~/.codex) hoặc local (./.claude/./.codex) - Bỏ qua hoặc ghi đè file đã có
- Xác nhận
════════════════════════════════════════
agents-skills installer
════════════════════════════════════════
1) Everything (skills + agents + commands + rules)
2) All skills
3) All agents
4) All commands
5) All rules
6) CLAUDE.md preset…
7) Pick specific skills…
…
════════════════════════════════════════
Platform
════════════════════════════════════════
1) Claude Code (~/.claude)
2) Codex (~/.codex)
3) Both
Lưu ý với Codex:
- Slash-commands cài vào
prompts/(không phảicommands/). - Agents bị bỏ qua trên Codex; skills, commands và rules vẫn cài bình thường.
Không tương tác:
npx github:mxrsv/agents-skills install --all
npx github:mxrsv/agents-skills install --skills
npx github:mxrsv/agents-skills install --skill brainstorm --agent planner
npx github:mxrsv/agents-skills install --local --all
npx github:mxrsv/agents-skills install --codex --skills --commands
npx github:mxrsv/agents-skills install --both --skill brainstorm
npx github:mxrsv/agents-skills install --preset kyant-vibe
npx github:mxrsv/agents-skills list
npx github:mxrsv/agents-skills list presetsClone một lần (không phải npx fetch lại):
git clone https://github.com/mxrsv/agents-skills.git
cd agents-skills
./bin/agents-skills installgit clone https://github.com/mxrsv/agents-skills.git
cp -r agents-skills/agents ~/.claude/agents
cp -r agents-skills/skills ~/.claude/skills
cp -r agents-skills/commands ~/.claude/commands
cp -r agents-skills/rules ~/.claude/rulesClaude Code tự nhận agents (Agent tool) và skills (Skill tool) từ frontmatter description của từng file — không cần cấu hình thêm.
| Path | Vai trò |
|---|---|
agents/ |
Subagent chuyên biệt (review, planning, research…) |
skills/ |
Skill — nguồn chuẩn; symlink sang ~/.agents/skills cho Codex / Cursor |
rules/ |
Rules luôn nạp + theo path |
templates/ |
Starter AGENTS.md / CLAUDE.md + cấu trúc project |
presets/ |
Preset CLAUDE.md có tên (live vibe-coding) |
hooks/ |
File-guard (tên junk, file quá lớn) |
assets/ |
Media cho README |
Claude Code nhận các agent này qua Agent tool (frontmatter description). Codex không có cơ chế subagent theo file — agents bị bỏ qua khi cài sang Codex.
| Agent | Mô tả |
|---|---|
analyst |
Nghiên cứu, phân tích thị trường/đối thủ, hỗ trợ brainstorm; draft docs để người duyệt |
architect |
Kiến trúc hệ thống và quyết định kỹ thuật cho feature/refactor lớn |
planner |
Lập plan chi tiết cho feature và refactor phức tạp |
plan-reviewer |
Gate 2 — kiểm tra plan có chạy được với codebase không (chỉ đọc) |
| Agent | Mô tả |
|---|---|
typescript-reviewer |
TypeScript/JS sâu: types, async đúng, security |
react-reviewer |
React/JSX sâu: hooks, hiệu năng render, a11y |
database-reviewer |
PostgreSQL: tối ưu query, schema, thực hành Supabase |
security-reviewer |
OWASP Top 10, secrets, injection, SSRF |
silent-failure-hunter |
Lỗi bị nuốt, fallback kém, thiếu lan truyền lỗi |
| Agent | Mô tả |
|---|---|
performance-optimizer |
Điểm nghẽn, chi phí runtime, kích thước bundle |
refactor-cleaner |
Dọn code chết / trùng lặp (knip, depcheck, ts-prune) |
doc-updater |
Codemap và docs sống (README, docs/CODEMAPS) |
Theo quy tắc tài liệu, bạn giao việc và chốt quyết định trong chat; skill planning giữ yêu cầu, kế hoạch, checklist, kiểm chứng và bàn giao trong một file docs/plans/YYYY-MM-DD-<slug>.md. Không cần issue key hay dịch vụ theo dõi bên ngoài. Khi việc hoàn tất, plan được giữ làm lịch sử; kiến thức còn áp dụng được chắt vào tài liệu sống. Việc nhỏ, rõ ràng không bắt buộc có plan.
| Skill | Mô tả |
|---|---|
brainstorm |
Trước khi build — làm rõ nhu cầu, so hướng làm, chốt spec |
planning |
Plan thực thi khi phạm vi đã rõ |
codebase-onboarding |
Bản đồ kiến trúc nhanh cho repo lạ |
improve-codebase-architecture |
Cơ hội refactor / đào sâu kiến trúc |
domain-modeling |
Ngôn ngữ dùng chung, thuật ngữ domain, ADR |
interview-me |
Phỏng vấn từng câu để moi ý định thật |
find-skills |
Tìm / cài agent skills |
explain |
Giảng khái niệm, bug, hoặc quyết định thiết kế theo style chọn |
| Skill | Mô tả |
|---|---|
review-change |
Review thay đổi vừa làm — đúng sai, test, security |
review-experience |
User flow thật trên browser — state, viewport, a11y |
review-health |
Sức khoẻ repo — kiến trúc, dependency, docs drift |
review-release |
Gộp report → SHIP / FIX / REFACTOR / RETHINK |
review |
Review spec hoặc plan trước khi code |
security-review |
Auth, input, secrets, thanh toán |
docs-drift |
Docs vs hành vi code thật (mặc định chỉ đọc) |
diagnosing-bugs |
Bug khó và tụt hiệu năng |
| Skill | Mô tả |
|---|---|
frontend-design-bar |
UI trông như được thiết kế, không generic |
frontend-design-audit |
Audit dùng thử cho UI sẵn có / site đang chạy |
prototype |
Prototype bỏ được trước khi chốt hướng |
impeccable |
Phê, mài, cải giao diện |
shadcn |
Component shadcn/ui, registry, chat UI |
| Skill | Mô tả |
|---|---|
hand-off |
Nén hội thoại để agent khác nhận việc |
context-budget |
Rà token qua agents, skills, MCP, CLAUDE.md |
Skill tự viết ở skills/ là nguồn chuẩn (git track). scripts/sync-agents-skills.sh tạo symlink ~/.agents/skills/<x> → ~/.claude/skills/<x> cho mọi skill được git track; Codex đọc ~/.agents/skills natively và theo symlink, nên Claude Code, Codex và Cursor dùng đúng một bản — hết copy trôi. Codex gọi skill bằng $name thay vì /name. Chạy với --check để rà lệch: symlink thiếu, frontmatter dùng khoá không harness nào đọc, bản copy trùng tên trong ~/.codex/skills.
Cài dưới ~/.agents/skills rồi symlink vào Claude Code / Codex. CLI mặc định bỏ qua symlink hỏng; dùng --with-symlinks khi target đã tồn tại.
| Skill | Upstream |
|---|---|
frontend-design-audit |
mistyhx/frontend-design-audit |
impeccable |
pbakaus/impeccable |
diagnosing-bugs |
mattpocock/skills |
shadcn |
shadcn-ui/ui |
Preset livestream Kyant + template trung lập để fork.
| Path | Là gì |
|---|---|
templates/CLAUDE.template.md |
CLAUDE.md global trung lập — điền {{placeholders}} |
presets/kyant-vibe/ |
Preset vibe-coding Kyant (giọng Việt, trả lời ngắn, frontend gates, hard rules) |
npx github:mxrsv/agents-skills install --preset kyant-vibe
cp templates/CLAUDE.template.md ~/.claude/CLAUDE.md # hoặc bắt đầu từ templatePresets ghi CLAUDE.md vào target cài. Ghép với rules/ để link hard-rule resolve được. Fork preset thoải mái — ngôn ngữ và emoji là gu, không phải luật.
| Path | Nội dung |
|---|---|
rules/core/ |
Luôn nạp: tạo file (F), workflow (W), docs (D), coding style (C), patterns (P) |
rules/typescript/ |
Path-scoped cho *.ts/tsx/js/jsx |
rules/react/ |
Path-scoped cho *.tsx/jsx |
templates/AGENTS.template.md |
Skeleton delta rules theo project |
templates/CLAUDE.template.md |
Starter CLAUDE.md trung lập |
templates/project-structure.md |
Cây thư mục chuẩn |
hooks/file-guard.sh |
Chặn tên file junk; cảnh báo file quá lớn / sai chỗ |
