ai-developer-skill-os 1.0.0 → 1.0.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +50 -109
- package/package.json +1 -1
- package/rules-skill/CHANGELOG.md +31 -0
- package/rules-skill/LICENSE +21 -0
- package/rules-skill/README.md +142 -0
- package/rules-skill/_template/SKILL.md +154 -0
- package/rules-skill/_template/examples/example-en.md +49 -0
- package/rules-skill/_template/examples/example-vi.md +49 -0
- package/rules-skill/docs/CHI_TIET_SKILLS.md +117 -0
- package/rules-skill/docs/HUONG_DAN_SU_DUNG.md +102 -0
- package/rules-skill/skills/backend/auth-security/SKILL.md +94 -0
- package/rules-skill/skills/backend/backend-architecture/SKILL.md +123 -0
- package/rules-skill/skills/backend/database-engineer/SKILL.md +102 -0
- package/rules-skill/skills/backend/deployment/SKILL.md +94 -0
- package/rules-skill/skills/engineering/agent-orchestrator/SKILL.md +177 -0
- package/rules-skill/skills/engineering/api-integration/SKILL.md +378 -0
- package/rules-skill/skills/engineering/bug-fix/SKILL.md +211 -0
- package/rules-skill/skills/engineering/context-manager/SKILL.md +174 -0
- package/rules-skill/skills/engineering/git-engineer/SKILL.md +302 -0
- package/rules-skill/skills/engineering/migration/SKILL.md +282 -0
- package/rules-skill/skills/engineering/project-audit/SKILL.md +278 -0
- package/rules-skill/skills/engineering/refactor/SKILL.md +220 -0
- package/rules-skill/skills/frontend/accessibility-audit/SKILL.md +119 -0
- package/rules-skill/skills/frontend/component-generator/SKILL.md +134 -0
- package/rules-skill/skills/frontend/design-system/SKILL.md +135 -0
- package/rules-skill/skills/frontend/form-builder/SKILL.md +138 -0
- package/rules-skill/skills/frontend/frontend-architecture/SKILL.md +153 -0
- package/rules-skill/skills/frontend/frontend-debug/SKILL.md +131 -0
- package/rules-skill/skills/frontend/frontend-performance/SKILL.md +127 -0
- package/rules-skill/skills/frontend/frontend-testing/SKILL.md +144 -0
- package/rules-skill/skills/frontend/state-management/SKILL.md +138 -0
- package/rules-skill/skills/frontend/table-crud-generator/SKILL.md +125 -0
- package/rules-skill/skills/frontend/ui-builder/SKILL.md +150 -0
- package/rules-skill/skills.json +667 -0
package/README.md
CHANGED
|
@@ -1,142 +1,83 @@
|
|
|
1
|
-
# AI Developer Skill OS
|
|
1
|
+
# 🚀 AI Developer Skill OS
|
|
2
2
|
|
|
3
|
-
|
|
4
|
-
|
|
3
|
+
[](https://badge.fury.io/js/ai-developer-skill-os)
|
|
4
|
+
[](https://opensource.org/licenses/MIT)
|
|
5
5
|
|
|
6
|
-
|
|
7
|
-
|
|
6
|
+
**A multi-agent skill package for AI coding assistants (Claude Code, Cursor, Windsurf, Antigravity/Gemini).**
|
|
7
|
+
Hệ điều hành kỹ năng (Skill OS) giúp biến AI của bạn từ một "cỗ máy sinh code" thành một Senior Software Engineer thực thụ với quy trình làm việc chuẩn mực.
|
|
8
8
|
|
|
9
|
-
|
|
10
|
-
- [Hướng dẫn sử dụng](file:///docs/HUONG_DAN_SU_DUNG.md)
|
|
11
|
-
- [Chi tiết toàn bộ Skills (Tiếng Việt)](file:///docs/CHI_TIET_SKILLS.md)
|
|
9
|
+
> Tác giả: **Quang Khánh**
|
|
12
10
|
|
|
13
11
|
---
|
|
14
12
|
|
|
15
|
-
##
|
|
13
|
+
## 🌟 Tính năng nổi bật (Features)
|
|
16
14
|
|
|
17
|
-
|
|
15
|
+
Bộ Skill OS cung cấp **23 kỹ năng chuyên biệt**, chia làm 3 nhóm chính:
|
|
16
|
+
- 🛠️ **Engineering Core (8 skills):** Agent Orchestrator (Lên kế hoạch), Context Manager, Project Audit, Bug Fix, Refactor, API Integration, Migration, Git Engineer.
|
|
17
|
+
- 🎨 **Frontend (11 skills):** Frontend Architecture, Design System, UI Builder, Component Generator, State Management, Form Builder, Table CRUD, Debug, Testing, Performance, A11Y Audit.
|
|
18
|
+
- ⚙️ **Backend (4 skills):** Backend Architecture, Database Engineer, Auth & Security, Deployment (DevOps).
|
|
18
19
|
|
|
19
|
-
|
|
20
|
+
👉 [Xem chi tiết chức năng của toàn bộ 23 Skills tại đây](docs/CHI_TIET_SKILLS.md)
|
|
20
21
|
|
|
21
22
|
---
|
|
22
23
|
|
|
23
|
-
##
|
|
24
|
+
## 📦 Cài đặt (Installation)
|
|
24
25
|
|
|
25
|
-
|
|
26
|
-
agent-orchestrator → Plan only. Routes work to correct skills.
|
|
27
|
-
context-manager → Understands project structure. Manages what to read.
|
|
28
|
-
project-audit → Diagnoses codebase before any changes.
|
|
29
|
-
↓
|
|
30
|
-
frontend-architecture → Decides file placement and folder conventions.
|
|
31
|
-
design-system → Enforces component library usage.
|
|
32
|
-
↓
|
|
33
|
-
ui-builder · component-generator · form-builder · table-crud-generator
|
|
34
|
-
↓
|
|
35
|
-
api-integration → FE ↔ BE contract layer.
|
|
36
|
-
state-management → Chooses correct state strategy.
|
|
37
|
-
↓
|
|
38
|
-
bug-fix · frontend-debug · refactor · migration
|
|
39
|
-
↓
|
|
40
|
-
frontend-testing · accessibility-audit · frontend-performance
|
|
41
|
-
↓
|
|
42
|
-
git-engineer → Commit, PR, changelog, release.
|
|
43
|
-
```
|
|
26
|
+
Bạn có thể cài đặt bộ Skill này vào bất kỳ dự án nào cực kỳ nhanh chóng qua NPM hoặc Git.
|
|
44
27
|
|
|
45
|
-
|
|
28
|
+
### Cách 1: Sử dụng NPM (Khuyên dùng)
|
|
29
|
+
Mở terminal tại thư mục gốc dự án của bạn và chạy:
|
|
30
|
+
```bash
|
|
31
|
+
npx ai-developer-skill-os init
|
|
32
|
+
```
|
|
33
|
+
*Lệnh này sẽ tự động tải và khởi tạo thư mục `rules-skill/` chứa toàn bộ kỹ năng vào dự án của bạn.*
|
|
46
34
|
|
|
47
|
-
|
|
48
|
-
|
|
49
|
-
|
|
50
|
-
|
|
51
|
-
|
|
52
|
-
| `agent-orchestrator` | Plans tasks, routes to correct skills — never writes code |
|
|
53
|
-
| `context-manager` | Selects relevant files, summarizes architecture |
|
|
54
|
-
| `project-audit` | Full codebase health check (Quick / Standard / Full mode) |
|
|
55
|
-
| `bug-fix` | Diagnose and fix specific bugs with evidence |
|
|
56
|
-
| `refactor` | Safe restructuring without breaking behavior |
|
|
57
|
-
| `api-integration` | Build production-ready API integration layers |
|
|
58
|
-
| `migration` | Dependency upgrades and framework migrations |
|
|
59
|
-
| `git-engineer` | Commit messages, PR descriptions, changelogs |
|
|
60
|
-
|
|
61
|
-
### Frontend (11 skills)
|
|
62
|
-
| Skill | Purpose |
|
|
63
|
-
|-------|---------|
|
|
64
|
-
| `frontend-architecture` | Folder structure, file placement conventions |
|
|
65
|
-
| `design-system` | Enforce component library — no raw HTML elements |
|
|
66
|
-
| `ui-builder` | Build UI screens from requirements |
|
|
67
|
-
| `component-generator` | Generate typed, reusable components |
|
|
68
|
-
| `state-management` | Choose and implement correct state layer |
|
|
69
|
-
| `form-builder` | Forms with schema validation and error handling |
|
|
70
|
-
| `table-crud-generator` | Admin tables with pagination, filter, sort, CRUD |
|
|
71
|
-
| `frontend-debug` | React errors, hydration, state, CSS issues |
|
|
72
|
-
| `frontend-testing` | Unit, component, and e2e tests |
|
|
73
|
-
| `frontend-performance` | Bundle, render, lazy load optimization |
|
|
74
|
-
| `accessibility-audit` | ARIA, contrast, keyboard, mobile accessibility |
|
|
75
|
-
|
|
76
|
-
### Backend (4 skills)
|
|
77
|
-
| Skill | Purpose |
|
|
78
|
-
|-------|---------|
|
|
79
|
-
| `backend-architecture` | Service / controller / repository pattern |
|
|
80
|
-
| `database-engineer` | Schema design, migrations, indexing |
|
|
81
|
-
| `auth-security` | JWT, OAuth, RBAC implementation |
|
|
82
|
-
| `deployment` | CI/CD, Docker, environment configuration |
|
|
35
|
+
### Cách 2: Sử dụng Git Submodule
|
|
36
|
+
Nếu bạn không dùng Node.js, bạn có thể nhúng trực tiếp qua Git:
|
|
37
|
+
```bash
|
|
38
|
+
git submodule add https://github.com/phamquangkhanh2999/ai-developer-skill-os.git rules-skill
|
|
39
|
+
```
|
|
83
40
|
|
|
84
41
|
---
|
|
85
42
|
|
|
86
|
-
##
|
|
43
|
+
## 🛠️ Cấu hình cho IDE / AI Agent
|
|
87
44
|
|
|
88
|
-
|
|
45
|
+
Sau khi thư mục `rules-skill/` đã xuất hiện trong dự án của bạn, hãy cấu hình để AI biết cách sử dụng nó.
|
|
89
46
|
|
|
90
|
-
|
|
47
|
+
### Cho Cursor / Windsurf (AI Code Editors)
|
|
48
|
+
Tạo file `.cursorrules` (nếu dùng Cursor) hoặc `.windsurfrules` (nếu dùng Windsurf) ở gốc dự án và dán đoạn sau vào:
|
|
49
|
+
```md
|
|
50
|
+
# AI Developer Skill OS by Quang Khánh
|
|
91
51
|
|
|
52
|
+
When answering or generating code, you MUST act as an expert engineer using the skills defined in `./rules-skill/skills.json`.
|
|
53
|
+
Always read the relevant `SKILL.md` from `./rules-skill/skills/` before providing a solution.
|
|
54
|
+
Speak to me in Vietnamese, but write all code in English.
|
|
92
55
|
```
|
|
93
|
-
your-project/
|
|
94
|
-
└── .agents/
|
|
95
|
-
└── skills/ ← copy the `skills/` folder here
|
|
96
|
-
├── engineering/
|
|
97
|
-
├── frontend/
|
|
98
|
-
└── backend/
|
|
99
|
-
```
|
|
100
|
-
|
|
101
|
-
Or register globally in `C:\Users\<you>\.gemini\config\skills\`.
|
|
102
|
-
|
|
103
|
-
### Claude Code / Kilo Code / Cursor
|
|
104
|
-
|
|
105
|
-
Reference skills from your project rules file (`.cursorrules`, `CLAUDE.md`, etc.):
|
|
106
56
|
|
|
57
|
+
### Cho Claude Code / Kilo Code (CLI Agents)
|
|
58
|
+
Tạo file `CLAUDE.md` (hoặc `KILO.md`) ở gốc dự án và dán đoạn sau vào:
|
|
107
59
|
```md
|
|
108
|
-
|
|
109
|
-
|
|
110
|
-
```
|
|
111
|
-
|
|
112
|
-
---
|
|
60
|
+
# System Instructions
|
|
61
|
+
Bạn đang chạy bằng **AI Developer Skill OS** (Tác giả: Quang Khánh).
|
|
113
62
|
|
|
114
|
-
|
|
115
|
-
|
|
116
|
-
|
|
117
|
-
|
|
118
|
-
| SKILL.md content | 🇬🇧 English |
|
|
119
|
-
| Code, identifiers | 🇬🇧 English always |
|
|
120
|
-
| AI responses | Matches user's language automatically |
|
|
121
|
-
| README, docs | 🇬🇧 English + 🇻🇳 Vietnamese |
|
|
63
|
+
Vui lòng tìm đọc danh sách kỹ năng tại file `./rules-skill/skills.json`.
|
|
64
|
+
Trước khi thực hiện bất kỳ yêu cầu nào, hãy gọi file `SKILL.md` tương ứng trong thư mục `./rules-skill/skills/` để biết quy trình làm việc chuẩn.
|
|
65
|
+
Luôn giao tiếp bằng tiếng Việt nhưng viết code, đặt tên biến, comment trong code bằng tiếng Anh.
|
|
66
|
+
```
|
|
122
67
|
|
|
123
68
|
---
|
|
124
69
|
|
|
125
|
-
##
|
|
70
|
+
## 🚀 Cách sử dụng (Usage)
|
|
126
71
|
|
|
127
|
-
|
|
128
|
-
2. Fill in all sections (Trigger, Scope, Non-goals, Workflow, Decision Tree, Output Format, Validation, Examples)
|
|
129
|
-
3. Add to `skills.json` with `trigger[]` and `dependencies[]`
|
|
130
|
-
4. Add to correct category folder under `skills/`
|
|
131
|
-
|
|
132
|
-
---
|
|
72
|
+
Giờ đây bạn chỉ cần chat với AI như giao việc cho một kỹ sư thật sự. Không cần viết prompt dài dòng!
|
|
133
73
|
|
|
134
|
-
|
|
74
|
+
- **Nhờ AI lên kế hoạch:** *"Dự án này đang cần thêm tính năng Đăng nhập. Cậu lên kế hoạch giúp mình nhé."* (Kích hoạt `agent-orchestrator`)
|
|
75
|
+
- **Fix lỗi:** *"Bị lỗi Hydration error trên Next.js rồi. Fix giúp mình."* (Kích hoạt `bug-fix` / `frontend-debug`)
|
|
76
|
+
- **Audit Code:** *"Audit nhanh cho tôi thư mục src/components/ xem có vấn đề gì không."* (Kích hoạt `project-audit`)
|
|
135
77
|
|
|
136
|
-
|
|
137
|
-
Engineering foundation + Frontend core complete.
|
|
78
|
+
👉 [Đọc Hướng Dẫn Sử Dụng chi tiết tại đây](docs/HUONG_DAN_SU_DUNG.md)
|
|
138
79
|
|
|
139
80
|
---
|
|
140
81
|
|
|
141
|
-
|
|
142
|
-
|
|
82
|
+
## 📄 License
|
|
83
|
+
Được phát hành dưới giấy phép [MIT](LICENSE). Tự do sử dụng, chỉnh sửa và chia sẻ.
|
package/package.json
CHANGED
|
@@ -0,0 +1,31 @@
|
|
|
1
|
+
# Changelog
|
|
2
|
+
|
|
3
|
+
All notable changes to the **AI Developer Skill OS** project will be documented in this file.
|
|
4
|
+
|
|
5
|
+
The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
|
|
6
|
+
and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
|
|
7
|
+
|
|
8
|
+
## [1.0.0] - 2026-07-01
|
|
9
|
+
|
|
10
|
+
### Added
|
|
11
|
+
- Released the complete AI Developer Skill OS with 23 targeted skills for coding agents.
|
|
12
|
+
- **Engineering Core (8 skills):**
|
|
13
|
+
- `agent-orchestrator` for planning and delegating tasks.
|
|
14
|
+
- `context-manager` for project context and file selection.
|
|
15
|
+
- `project-audit` for 3-mode health checks.
|
|
16
|
+
- `bug-fix` with root cause analysis.
|
|
17
|
+
- `refactor` for safe, behavior-preserving code restructuring.
|
|
18
|
+
- `migration` for dependency updates and library swapping.
|
|
19
|
+
- `api-integration` for robust API connections.
|
|
20
|
+
- `git-engineer` for commit messages and PR documentation.
|
|
21
|
+
- **Frontend Core (11 skills):**
|
|
22
|
+
- `frontend-architecture`, `design-system`, `ui-builder`, `component-generator`.
|
|
23
|
+
- `state-management`, `form-builder`, `table-crud-generator`.
|
|
24
|
+
- `frontend-debug`, `frontend-testing`, `accessibility-audit`, `frontend-performance`.
|
|
25
|
+
- **Backend Core (4 skills):**
|
|
26
|
+
- `backend-architecture`, `database-engineer`, `auth-security`, `deployment`.
|
|
27
|
+
- Added comprehensive `skills.json` registry with dependencies and trigger keywords.
|
|
28
|
+
- Added bilingual `README.md` (English/Vietnamese).
|
|
29
|
+
- Added detailed user documentation in `docs/HUONG_DAN_SU_DUNG.md` and `docs/CHI_TIET_SKILLS.md`.
|
|
30
|
+
- Translated all skill frontmatter descriptions to Vietnamese for better UX in agent terminals.
|
|
31
|
+
- Included generic English and Vietnamese usage examples in `_template/examples/`.
|
|
@@ -0,0 +1,21 @@
|
|
|
1
|
+
MIT License
|
|
2
|
+
|
|
3
|
+
Copyright (c) 2026 Quang Khánh
|
|
4
|
+
|
|
5
|
+
Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
6
|
+
of this software and associated documentation files (the "Software"), to deal
|
|
7
|
+
in the Software without restriction, including without limitation the rights
|
|
8
|
+
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
|
9
|
+
copies of the Software, and to permit persons to whom the Software is
|
|
10
|
+
furnished to do so, subject to the following conditions:
|
|
11
|
+
|
|
12
|
+
The above copyright notice and this permission notice shall be included in all
|
|
13
|
+
copies or substantial portions of the Software.
|
|
14
|
+
|
|
15
|
+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
16
|
+
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
17
|
+
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
18
|
+
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
19
|
+
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
20
|
+
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
|
21
|
+
SOFTWARE.
|
|
@@ -0,0 +1,142 @@
|
|
|
1
|
+
# AI Developer Skill OS
|
|
2
|
+
|
|
3
|
+
**A multi-agent skill package for AI coding assistants.**
|
|
4
|
+
Bộ skill package đa nền tảng cho AI coding assistant.
|
|
5
|
+
|
|
6
|
+
> Tác giả: **Quang Khánh**
|
|
7
|
+
> Compatible with: **Claude Code · Kilo Code · Antigravity/Gemini IDE · Cursor · Windsurf**
|
|
8
|
+
|
|
9
|
+
📚 **Tài liệu hữu ích:**
|
|
10
|
+
- [Hướng dẫn sử dụng](file:///docs/HUONG_DAN_SU_DUNG.md)
|
|
11
|
+
- [Chi tiết toàn bộ Skills (Tiếng Việt)](file:///docs/CHI_TIET_SKILLS.md)
|
|
12
|
+
|
|
13
|
+
---
|
|
14
|
+
|
|
15
|
+
## What is this? / Đây là gì?
|
|
16
|
+
|
|
17
|
+
**EN:** A structured collection of skills that transform AI coding agents into specialized engineering roles. Each skill defines a precise workflow, scope, rules, and output format — so AI consistently behaves like a senior engineer, not a random code generator.
|
|
18
|
+
|
|
19
|
+
**VI:** Bộ skill có cấu trúc biến AI coding agent thành các vai trò kỹ sư chuyên biệt. Mỗi skill định nghĩa workflow, phạm vi, quy tắc và định dạng output rõ ràng — để AI hoạt động nhất quán như senior engineer, không phải code generator tùy tiện.
|
|
20
|
+
|
|
21
|
+
---
|
|
22
|
+
|
|
23
|
+
## Skill Map / Sơ đồ Skill
|
|
24
|
+
|
|
25
|
+
```
|
|
26
|
+
agent-orchestrator → Plan only. Routes work to correct skills.
|
|
27
|
+
context-manager → Understands project structure. Manages what to read.
|
|
28
|
+
project-audit → Diagnoses codebase before any changes.
|
|
29
|
+
↓
|
|
30
|
+
frontend-architecture → Decides file placement and folder conventions.
|
|
31
|
+
design-system → Enforces component library usage.
|
|
32
|
+
↓
|
|
33
|
+
ui-builder · component-generator · form-builder · table-crud-generator
|
|
34
|
+
↓
|
|
35
|
+
api-integration → FE ↔ BE contract layer.
|
|
36
|
+
state-management → Chooses correct state strategy.
|
|
37
|
+
↓
|
|
38
|
+
bug-fix · frontend-debug · refactor · migration
|
|
39
|
+
↓
|
|
40
|
+
frontend-testing · accessibility-audit · frontend-performance
|
|
41
|
+
↓
|
|
42
|
+
git-engineer → Commit, PR, changelog, release.
|
|
43
|
+
```
|
|
44
|
+
|
|
45
|
+
---
|
|
46
|
+
|
|
47
|
+
## Skills / Danh sách Skill
|
|
48
|
+
|
|
49
|
+
### Engineering (8 skills)
|
|
50
|
+
| Skill | Purpose |
|
|
51
|
+
|-------|---------|
|
|
52
|
+
| `agent-orchestrator` | Plans tasks, routes to correct skills — never writes code |
|
|
53
|
+
| `context-manager` | Selects relevant files, summarizes architecture |
|
|
54
|
+
| `project-audit` | Full codebase health check (Quick / Standard / Full mode) |
|
|
55
|
+
| `bug-fix` | Diagnose and fix specific bugs with evidence |
|
|
56
|
+
| `refactor` | Safe restructuring without breaking behavior |
|
|
57
|
+
| `api-integration` | Build production-ready API integration layers |
|
|
58
|
+
| `migration` | Dependency upgrades and framework migrations |
|
|
59
|
+
| `git-engineer` | Commit messages, PR descriptions, changelogs |
|
|
60
|
+
|
|
61
|
+
### Frontend (11 skills)
|
|
62
|
+
| Skill | Purpose |
|
|
63
|
+
|-------|---------|
|
|
64
|
+
| `frontend-architecture` | Folder structure, file placement conventions |
|
|
65
|
+
| `design-system` | Enforce component library — no raw HTML elements |
|
|
66
|
+
| `ui-builder` | Build UI screens from requirements |
|
|
67
|
+
| `component-generator` | Generate typed, reusable components |
|
|
68
|
+
| `state-management` | Choose and implement correct state layer |
|
|
69
|
+
| `form-builder` | Forms with schema validation and error handling |
|
|
70
|
+
| `table-crud-generator` | Admin tables with pagination, filter, sort, CRUD |
|
|
71
|
+
| `frontend-debug` | React errors, hydration, state, CSS issues |
|
|
72
|
+
| `frontend-testing` | Unit, component, and e2e tests |
|
|
73
|
+
| `frontend-performance` | Bundle, render, lazy load optimization |
|
|
74
|
+
| `accessibility-audit` | ARIA, contrast, keyboard, mobile accessibility |
|
|
75
|
+
|
|
76
|
+
### Backend (4 skills)
|
|
77
|
+
| Skill | Purpose |
|
|
78
|
+
|-------|---------|
|
|
79
|
+
| `backend-architecture` | Service / controller / repository pattern |
|
|
80
|
+
| `database-engineer` | Schema design, migrations, indexing |
|
|
81
|
+
| `auth-security` | JWT, OAuth, RBAC implementation |
|
|
82
|
+
| `deployment` | CI/CD, Docker, environment configuration |
|
|
83
|
+
|
|
84
|
+
---
|
|
85
|
+
|
|
86
|
+
## Installation / Cài đặt
|
|
87
|
+
|
|
88
|
+
### Antigravity / Gemini IDE
|
|
89
|
+
|
|
90
|
+
Place this folder in your `.agents/skills/` directory:
|
|
91
|
+
|
|
92
|
+
```
|
|
93
|
+
your-project/
|
|
94
|
+
└── .agents/
|
|
95
|
+
└── skills/ ← copy the `skills/` folder here
|
|
96
|
+
├── engineering/
|
|
97
|
+
├── frontend/
|
|
98
|
+
└── backend/
|
|
99
|
+
```
|
|
100
|
+
|
|
101
|
+
Or register globally in `C:\Users\<you>\.gemini\config\skills\`.
|
|
102
|
+
|
|
103
|
+
### Claude Code / Kilo Code / Cursor
|
|
104
|
+
|
|
105
|
+
Reference skills from your project rules file (`.cursorrules`, `CLAUDE.md`, etc.):
|
|
106
|
+
|
|
107
|
+
```md
|
|
108
|
+
Use skills from: ./rules-skill/skills/
|
|
109
|
+
When the user requests [task], load the appropriate SKILL.md and follow it precisely.
|
|
110
|
+
```
|
|
111
|
+
|
|
112
|
+
---
|
|
113
|
+
|
|
114
|
+
## Language / Ngôn ngữ
|
|
115
|
+
|
|
116
|
+
| Layer | Language |
|
|
117
|
+
|-------|----------|
|
|
118
|
+
| SKILL.md content | 🇬🇧 English |
|
|
119
|
+
| Code, identifiers | 🇬🇧 English always |
|
|
120
|
+
| AI responses | Matches user's language automatically |
|
|
121
|
+
| README, docs | 🇬🇧 English + 🇻🇳 Vietnamese |
|
|
122
|
+
|
|
123
|
+
---
|
|
124
|
+
|
|
125
|
+
## Contributing / Đóng góp
|
|
126
|
+
|
|
127
|
+
1. Copy `_template/SKILL.md`
|
|
128
|
+
2. Fill in all sections (Trigger, Scope, Non-goals, Workflow, Decision Tree, Output Format, Validation, Examples)
|
|
129
|
+
3. Add to `skills.json` with `trigger[]` and `dependencies[]`
|
|
130
|
+
4. Add to correct category folder under `skills/`
|
|
131
|
+
|
|
132
|
+
---
|
|
133
|
+
|
|
134
|
+
## Version / Phiên bản
|
|
135
|
+
|
|
136
|
+
**v1.0.0** — Initial release.
|
|
137
|
+
Engineering foundation + Frontend core complete.
|
|
138
|
+
|
|
139
|
+
---
|
|
140
|
+
|
|
141
|
+
*Tác giả: Quang Khánh*
|
|
142
|
+
*Được xây dựng cho cộng đồng AI engineering.*
|
|
@@ -0,0 +1,154 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: <skill-name>
|
|
3
|
+
description: >-
|
|
4
|
+
<1-3 lines in English. This is used for trigger matching across all AI agents.
|
|
5
|
+
Be specific and action-oriented. Avoid vague words.>
|
|
6
|
+
version: 1.0.0
|
|
7
|
+
category: engineering | frontend | backend
|
|
8
|
+
tags: [tag1, tag2, tag3]
|
|
9
|
+
platforms: [antigravity, claude-code, kilo-code, cursor, windsurf]
|
|
10
|
+
---
|
|
11
|
+
|
|
12
|
+
# <Skill Name>
|
|
13
|
+
|
|
14
|
+
> **Language rule:**
|
|
15
|
+
> Use **English** for: code, identifiers, file names, architecture terms, technical decisions.
|
|
16
|
+
> Use **the user's language** for: explanations, questions, summaries, and feedback.
|
|
17
|
+
> The user may write in any language — detect and match it automatically.
|
|
18
|
+
|
|
19
|
+
---
|
|
20
|
+
|
|
21
|
+
## Trigger
|
|
22
|
+
|
|
23
|
+
When to activate this skill. List specific conditions, user intents, and keywords.
|
|
24
|
+
|
|
25
|
+
Examples:
|
|
26
|
+
- User says "create a new page"
|
|
27
|
+
- User provides a UI mockup or wireframe
|
|
28
|
+
- User asks to "build", "design", or "implement" a screen
|
|
29
|
+
|
|
30
|
+
---
|
|
31
|
+
|
|
32
|
+
## Scope
|
|
33
|
+
|
|
34
|
+
What this skill is responsible for. Be explicit.
|
|
35
|
+
|
|
36
|
+
- ✅ [What it covers]
|
|
37
|
+
- ✅ [What it covers]
|
|
38
|
+
|
|
39
|
+
---
|
|
40
|
+
|
|
41
|
+
## Non-goals
|
|
42
|
+
|
|
43
|
+
What this skill must NOT do. This prevents scope creep.
|
|
44
|
+
|
|
45
|
+
- ❌ Do NOT [action A]
|
|
46
|
+
- ❌ Do NOT [action B]
|
|
47
|
+
- ❌ Do NOT make changes beyond the stated task
|
|
48
|
+
|
|
49
|
+
---
|
|
50
|
+
|
|
51
|
+
## Severity Levels
|
|
52
|
+
|
|
53
|
+
All findings, issues, and risks use this shared scale:
|
|
54
|
+
|
|
55
|
+
| Level | Label | Meaning |
|
|
56
|
+
|-------|-------|---------|
|
|
57
|
+
| P0 | Critical | Must fix before any other work |
|
|
58
|
+
| P1 | High | Fix in current session |
|
|
59
|
+
| P2 | Medium | Schedule soon |
|
|
60
|
+
| P3 | Low | Technical debt — fix when possible |
|
|
61
|
+
|
|
62
|
+
---
|
|
63
|
+
|
|
64
|
+
## Workflow
|
|
65
|
+
|
|
66
|
+
### Phase 1 — <Discovery / Analysis>
|
|
67
|
+
|
|
68
|
+
What to analyze, read, or understand first.
|
|
69
|
+
|
|
70
|
+
- Read: [files / folders / configs]
|
|
71
|
+
- Detect: [patterns / issues / context]
|
|
72
|
+
- Output: [brief summary of findings]
|
|
73
|
+
|
|
74
|
+
---
|
|
75
|
+
|
|
76
|
+
### Phase 2 — <Planning>
|
|
77
|
+
|
|
78
|
+
Before writing any code, produce a plan.
|
|
79
|
+
|
|
80
|
+
- List what will change and why
|
|
81
|
+
- Identify risks or conflicts
|
|
82
|
+
- Confirm with user if scope is unclear
|
|
83
|
+
|
|
84
|
+
---
|
|
85
|
+
|
|
86
|
+
### Phase 3 — <Execution>
|
|
87
|
+
|
|
88
|
+
Apply changes following the plan.
|
|
89
|
+
|
|
90
|
+
Rules:
|
|
91
|
+
- Smallest safe change
|
|
92
|
+
- Preserve existing behavior unless explicitly changing it
|
|
93
|
+
- Follow project conventions (naming, structure, style)
|
|
94
|
+
- Do not introduce unnecessary dependencies
|
|
95
|
+
|
|
96
|
+
---
|
|
97
|
+
|
|
98
|
+
### Phase 4 — <Validation>
|
|
99
|
+
|
|
100
|
+
Verify the output before finishing.
|
|
101
|
+
|
|
102
|
+
- [ ] Does it match the requirement?
|
|
103
|
+
- [ ] Are edge cases handled?
|
|
104
|
+
- [ ] No regressions introduced?
|
|
105
|
+
- [ ] Output format is complete?
|
|
106
|
+
|
|
107
|
+
---
|
|
108
|
+
|
|
109
|
+
## Decision Tree
|
|
110
|
+
|
|
111
|
+
Use this to handle branching logic during execution:
|
|
112
|
+
|
|
113
|
+
```
|
|
114
|
+
Condition A?
|
|
115
|
+
├── Yes → Action X
|
|
116
|
+
└── No → Condition B?
|
|
117
|
+
├── Yes → Action Y
|
|
118
|
+
└── No → Ask user for clarification
|
|
119
|
+
```
|
|
120
|
+
|
|
121
|
+
---
|
|
122
|
+
|
|
123
|
+
## Output Format
|
|
124
|
+
|
|
125
|
+
Define exactly what the AI must produce at the end of this skill.
|
|
126
|
+
|
|
127
|
+
Example:
|
|
128
|
+
```
|
|
129
|
+
✅ Summary: <what was done>
|
|
130
|
+
📁 Files: <list of created/modified files>
|
|
131
|
+
⚠️ Warnings: <anything the user should know>
|
|
132
|
+
🔗 Next steps: <suggested follow-up skills or actions>
|
|
133
|
+
```
|
|
134
|
+
|
|
135
|
+
---
|
|
136
|
+
|
|
137
|
+
## Validation Checklist
|
|
138
|
+
|
|
139
|
+
Before marking this skill complete:
|
|
140
|
+
|
|
141
|
+
- [ ] All phases completed
|
|
142
|
+
- [ ] Output format produced
|
|
143
|
+
- [ ] No TODOs or placeholder code left
|
|
144
|
+
- [ ] No hardcoded secrets, URLs, or credentials
|
|
145
|
+
- [ ] Follows project naming conventions
|
|
146
|
+
- [ ] User has been informed of any side effects
|
|
147
|
+
|
|
148
|
+
---
|
|
149
|
+
|
|
150
|
+
## Examples
|
|
151
|
+
|
|
152
|
+
See `examples/` folder for:
|
|
153
|
+
- `example-en.md` — English input/output example
|
|
154
|
+
- `example-vi.md` — Vietnamese input/output example
|
|
@@ -0,0 +1,49 @@
|
|
|
1
|
+
---
|
|
2
|
+
# AI Developer Skill OS
|
|
3
|
+
# Example usage file (English)
|
|
4
|
+
# Copy this as a starting point for your skill examples
|
|
5
|
+
---
|
|
6
|
+
|
|
7
|
+
# Example: [Skill Name]
|
|
8
|
+
|
|
9
|
+
## Input
|
|
10
|
+
|
|
11
|
+
**User request:**
|
|
12
|
+
```
|
|
13
|
+
[Describe what the user said or asked]
|
|
14
|
+
```
|
|
15
|
+
|
|
16
|
+
**Project context:**
|
|
17
|
+
- Framework: [React 18 / Next.js 14 / Vue 3 / etc.]
|
|
18
|
+
- Relevant files: `[path/to/file.ts]`
|
|
19
|
+
- Current state: [Brief description]
|
|
20
|
+
|
|
21
|
+
---
|
|
22
|
+
|
|
23
|
+
## Execution
|
|
24
|
+
|
|
25
|
+
**Skill activated:** `[skill-name]`
|
|
26
|
+
|
|
27
|
+
**Phase 1 — Analysis:**
|
|
28
|
+
> [What the AI analyzed]
|
|
29
|
+
|
|
30
|
+
**Phase 2 — Plan:**
|
|
31
|
+
> [What the AI decided to do]
|
|
32
|
+
|
|
33
|
+
**Phase 3 — Output:**
|
|
34
|
+
|
|
35
|
+
```typescript
|
|
36
|
+
// [filename.ts]
|
|
37
|
+
// [Generated or modified code]
|
|
38
|
+
```
|
|
39
|
+
|
|
40
|
+
---
|
|
41
|
+
|
|
42
|
+
## Result
|
|
43
|
+
|
|
44
|
+
```
|
|
45
|
+
✅ Summary: [What was done]
|
|
46
|
+
📁 Files: [List of files]
|
|
47
|
+
⚠️ Warnings: [Any notes]
|
|
48
|
+
🔗 Next steps: [Follow-up suggestion]
|
|
49
|
+
```
|
|
@@ -0,0 +1,49 @@
|
|
|
1
|
+
---
|
|
2
|
+
# AI Developer Skill OS
|
|
3
|
+
# File ví dụ sử dụng (Tiếng Việt)
|
|
4
|
+
# Sao chép file này làm điểm khởi đầu cho ví dụ của bạn
|
|
5
|
+
---
|
|
6
|
+
|
|
7
|
+
# Ví dụ: [Tên Skill]
|
|
8
|
+
|
|
9
|
+
## Input (Đầu vào)
|
|
10
|
+
|
|
11
|
+
**Yêu cầu của người dùng:**
|
|
12
|
+
```
|
|
13
|
+
[Mô tả người dùng đã nói hoặc yêu cầu gì]
|
|
14
|
+
```
|
|
15
|
+
|
|
16
|
+
**Bối cảnh dự án:**
|
|
17
|
+
- Framework: [React 18 / Next.js 14 / Vue 3 / v.v.]
|
|
18
|
+
- File liên quan: `[path/to/file.ts]`
|
|
19
|
+
- Trạng thái hiện tại: [Mô tả ngắn]
|
|
20
|
+
|
|
21
|
+
---
|
|
22
|
+
|
|
23
|
+
## Thực thi
|
|
24
|
+
|
|
25
|
+
**Skill được kích hoạt:** `[skill-name]`
|
|
26
|
+
|
|
27
|
+
**Phase 1 — Phân tích:**
|
|
28
|
+
> [AI đã phân tích gì]
|
|
29
|
+
|
|
30
|
+
**Phase 2 — Kế hoạch:**
|
|
31
|
+
> [AI quyết định làm gì]
|
|
32
|
+
|
|
33
|
+
**Phase 3 — Kết quả:**
|
|
34
|
+
|
|
35
|
+
```typescript
|
|
36
|
+
// [filename.ts]
|
|
37
|
+
// [Code được tạo hoặc chỉnh sửa]
|
|
38
|
+
```
|
|
39
|
+
|
|
40
|
+
---
|
|
41
|
+
|
|
42
|
+
## Kết quả
|
|
43
|
+
|
|
44
|
+
```
|
|
45
|
+
✅ Tóm tắt: [Đã làm gì]
|
|
46
|
+
📁 Files: [Danh sách file]
|
|
47
|
+
⚠️ Lưu ý: [Ghi chú quan trọng]
|
|
48
|
+
🔗 Bước tiếp theo: [Gợi ý skill hoặc hành động tiếp theo]
|
|
49
|
+
```
|