ai-developer-skill-os 1.0.1 → 1.0.3
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/bin/install.js +19 -4
- package/docs/HUONG_DAN_SU_DUNG.md +37 -47
- package/package.json +1 -1
- package/rules-skill/CHANGELOG.md +0 -31
- package/rules-skill/LICENSE +0 -21
- package/rules-skill/README.md +0 -142
- package/rules-skill/_template/SKILL.md +0 -154
- package/rules-skill/_template/examples/example-en.md +0 -49
- package/rules-skill/_template/examples/example-vi.md +0 -49
- package/rules-skill/docs/CHI_TIET_SKILLS.md +0 -117
- package/rules-skill/docs/HUONG_DAN_SU_DUNG.md +0 -102
- package/rules-skill/skills/backend/auth-security/SKILL.md +0 -94
- package/rules-skill/skills/backend/backend-architecture/SKILL.md +0 -123
- package/rules-skill/skills/backend/database-engineer/SKILL.md +0 -102
- package/rules-skill/skills/backend/deployment/SKILL.md +0 -94
- package/rules-skill/skills/engineering/agent-orchestrator/SKILL.md +0 -177
- package/rules-skill/skills/engineering/api-integration/SKILL.md +0 -378
- package/rules-skill/skills/engineering/bug-fix/SKILL.md +0 -211
- package/rules-skill/skills/engineering/context-manager/SKILL.md +0 -174
- package/rules-skill/skills/engineering/git-engineer/SKILL.md +0 -302
- package/rules-skill/skills/engineering/migration/SKILL.md +0 -282
- package/rules-skill/skills/engineering/project-audit/SKILL.md +0 -278
- package/rules-skill/skills/engineering/refactor/SKILL.md +0 -220
- package/rules-skill/skills/frontend/accessibility-audit/SKILL.md +0 -119
- package/rules-skill/skills/frontend/component-generator/SKILL.md +0 -134
- package/rules-skill/skills/frontend/design-system/SKILL.md +0 -135
- package/rules-skill/skills/frontend/form-builder/SKILL.md +0 -138
- package/rules-skill/skills/frontend/frontend-architecture/SKILL.md +0 -153
- package/rules-skill/skills/frontend/frontend-debug/SKILL.md +0 -131
- package/rules-skill/skills/frontend/frontend-performance/SKILL.md +0 -127
- package/rules-skill/skills/frontend/frontend-testing/SKILL.md +0 -144
- package/rules-skill/skills/frontend/state-management/SKILL.md +0 -138
- package/rules-skill/skills/frontend/table-crud-generator/SKILL.md +0 -125
- package/rules-skill/skills/frontend/ui-builder/SKILL.md +0 -150
- package/rules-skill/skills.json +0 -667
package/bin/install.js
CHANGED
|
@@ -4,7 +4,15 @@ const fs = require('fs');
|
|
|
4
4
|
const path = require('path');
|
|
5
5
|
|
|
6
6
|
const sourceDir = path.join(__dirname, '..');
|
|
7
|
-
|
|
7
|
+
let targetDir = path.join(process.cwd(), 'rules-skill');
|
|
8
|
+
|
|
9
|
+
// Check arguments for IDE-specific paths
|
|
10
|
+
const args = process.argv.slice(2);
|
|
11
|
+
const isGemini = args.includes('--gemini') || args.includes('--antigravity');
|
|
12
|
+
|
|
13
|
+
if (isGemini) {
|
|
14
|
+
targetDir = path.join(process.cwd(), '.agents', 'skills');
|
|
15
|
+
}
|
|
8
16
|
|
|
9
17
|
function copyRecursiveSync(src, dest) {
|
|
10
18
|
const exists = fs.existsSync(src);
|
|
@@ -24,6 +32,11 @@ function copyRecursiveSync(src, dest) {
|
|
|
24
32
|
}
|
|
25
33
|
|
|
26
34
|
console.log('🚀 Đang cài đặt AI Developer Skill OS...');
|
|
35
|
+
if (isGemini) {
|
|
36
|
+
console.log('⚙️ Chế độ: Gemini / Antigravity IDE (Cài vào thư mục .agents/skills/)');
|
|
37
|
+
} else {
|
|
38
|
+
console.log('⚙️ Chế độ: Mặc định (Cài vào thư mục rules-skill/)');
|
|
39
|
+
}
|
|
27
40
|
|
|
28
41
|
const filesAndFolders = [
|
|
29
42
|
'skills',
|
|
@@ -42,14 +55,16 @@ try {
|
|
|
42
55
|
|
|
43
56
|
filesAndFolders.forEach(item => {
|
|
44
57
|
const src = path.join(sourceDir, item);
|
|
45
|
-
|
|
58
|
+
let dest = path.join(targetDir, item);
|
|
59
|
+
|
|
60
|
+
// For Gemini, we dump the contents directly into .agents/skills/
|
|
46
61
|
if (fs.existsSync(src)) {
|
|
47
62
|
copyRecursiveSync(src, dest);
|
|
48
63
|
}
|
|
49
64
|
});
|
|
50
65
|
|
|
51
|
-
console.log(
|
|
52
|
-
console.log('\n💡 Tiếp theo, hãy tham khảo
|
|
66
|
+
console.log(`✅ Đã cài đặt thành công vào thư mục: ${targetDir.replace(process.cwd(), '.')}`);
|
|
67
|
+
console.log('\n💡 Tiếp theo, hãy tham khảo tài liệu trong mục docs/HUONG_DAN_SU_DUNG.md để biết cách tương tác với AI nhé!');
|
|
53
68
|
} catch (error) {
|
|
54
69
|
console.error('❌ Có lỗi xảy ra trong quá trình cài đặt:', error.message);
|
|
55
70
|
process.exit(1);
|
|
@@ -1,9 +1,9 @@
|
|
|
1
1
|
# Hướng Dẫn Sử Dụng — AI Developer Skill OS
|
|
2
2
|
|
|
3
3
|
**Tác giả:** Quang Khánh
|
|
4
|
-
**Phiên bản:** v1.0.
|
|
4
|
+
**Phiên bản:** v1.0.1
|
|
5
5
|
|
|
6
|
-
Chào mừng bạn đến với **AI Developer Skill OS**, bộ khung quản lý kỹ năng (Skill Framework) biến các trợ lý AI (
|
|
6
|
+
Chào mừng bạn đến với **AI Developer Skill OS**, bộ khung quản lý kỹ năng (Skill Framework) biến các trợ lý AI (Gemini, Antigravity, Claude Code, Cursor, Windsurf) từ một "cỗ máy sinh code" thành một Senior Software Engineer thực thụ.
|
|
7
7
|
|
|
8
8
|
---
|
|
9
9
|
|
|
@@ -20,44 +20,37 @@ Với hệ điều hành kỹ năng (Skill OS) này:
|
|
|
20
20
|
|
|
21
21
|
---
|
|
22
22
|
|
|
23
|
-
## 2. Hướng dẫn cài đặt
|
|
23
|
+
## 2. Hướng dẫn cài đặt qua NPM (Khuyên dùng)
|
|
24
24
|
|
|
25
|
-
Bộ Skin này rất linh hoạt và có thể
|
|
25
|
+
Bộ Skin này rất linh hoạt và được phân phối qua NPM để bạn có thể cài vào bất kỳ dự án nào cực kỳ nhanh chóng.
|
|
26
26
|
|
|
27
|
-
|
|
28
|
-
|
|
27
|
+
Mở terminal tại gốc dự án của bạn và chạy lệnh cài đặt tương ứng với công cụ AI bạn đang dùng:
|
|
28
|
+
|
|
29
|
+
### Dành cho Gemini IDE / Antigravity
|
|
30
|
+
Các công cụ này đọc cấu hình từ thư mục `.agents/skills/`. Bạn chỉ cần thêm cờ `--gemini` khi chạy cài đặt:
|
|
31
|
+
```bash
|
|
32
|
+
npx ai-developer-skill-os init --gemini
|
|
29
33
|
```
|
|
30
|
-
|
|
31
|
-
|
|
32
|
-
|
|
33
|
-
|
|
34
|
-
|
|
35
|
-
|
|
34
|
+
*Lệnh này sẽ tự tạo thư mục `.agents/skills/` và tải toàn bộ bộ kỹ năng vào đó.*
|
|
35
|
+
|
|
36
|
+
### Dành cho Cursor / Windsurf / Claude Code / Kilo Code
|
|
37
|
+
Các công cụ này linh hoạt hơn, bạn cài đặt mặc định:
|
|
38
|
+
```bash
|
|
39
|
+
npx ai-developer-skill-os init
|
|
36
40
|
```
|
|
37
|
-
|
|
38
|
-
`C:\Users\<Tên-Máy-Bạn>\.gemini\config\skills\`
|
|
41
|
+
*Lệnh này sẽ tạo thư mục `rules-skill/` ở gốc dự án.*
|
|
39
42
|
|
|
40
|
-
|
|
41
|
-
Claude Code và Kilo Code đọc các quy tắc (rules) từ thư mục gốc của dự án.
|
|
42
|
-
**Cách cài đặt:**
|
|
43
|
-
1. Copy toàn bộ thư mục `rules-skill/` vào gốc dự án của bạn.
|
|
44
|
-
2. Tạo (hoặc sửa) file `CLAUDE.md` (đối với Claude) hoặc `KILO.md` (đối với Kilo) ở thư mục gốc, dán nội dung sau vào:
|
|
43
|
+
---
|
|
45
44
|
|
|
46
|
-
|
|
47
|
-
# System Instructions
|
|
48
|
-
Bạn đang chạy bằng **AI Developer Skill OS** (Tác giả: Quang Khánh).
|
|
45
|
+
## 3. Cấu hình cho IDE / AI Agent
|
|
49
46
|
|
|
50
|
-
|
|
51
|
-
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.
|
|
52
|
-
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.
|
|
53
|
-
```
|
|
47
|
+
Sau khi thư mục kỹ năng đã 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ó.
|
|
54
48
|
|
|
55
|
-
### Cho
|
|
56
|
-
|
|
57
|
-
**Cách cài đặt:**
|
|
58
|
-
1. Copy toàn bộ thư mục `rules-skill/` vào gốc dự án của bạn.
|
|
59
|
-
2. Mở file `.cursorrules` (với Cursor) hoặc `.windsurfrules` (với Windsurf), dán nội dung sau vào:
|
|
49
|
+
### Cho Gemini IDE / Antigravity
|
|
50
|
+
**Không cần cấu hình gì thêm!** Gemini/Antigravity sẽ tự động nhận diện các file trong `.agents/skills/` và sẵn sàng làm việc ngay.
|
|
60
51
|
|
|
52
|
+
### Cho Cursor / Windsurf (AI Code Editors)
|
|
53
|
+
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:
|
|
61
54
|
```md
|
|
62
55
|
# AI Developer Skill OS by Quang Khánh
|
|
63
56
|
|
|
@@ -66,11 +59,22 @@ Always read the relevant `SKILL.md` from `./rules-skill/skills/` before providin
|
|
|
66
59
|
Speak to me in Vietnamese, but write all code in English.
|
|
67
60
|
```
|
|
68
61
|
|
|
62
|
+
### Cho Claude Code / Kilo Code (CLI Agents)
|
|
63
|
+
Tạo file `CLAUDE.md` (hoặc `KILO.md`) ở gốc dự án và dán đoạn sau vào:
|
|
64
|
+
```md
|
|
65
|
+
# System Instructions
|
|
66
|
+
Bạn đang chạy bằng **AI Developer Skill OS** (Tác giả: Quang Khánh).
|
|
67
|
+
|
|
68
|
+
Vui lòng tìm đọc danh sách kỹ năng tại file `./rules-skill/skills.json`.
|
|
69
|
+
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.
|
|
70
|
+
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.
|
|
71
|
+
```
|
|
72
|
+
|
|
69
73
|
---
|
|
70
74
|
|
|
71
|
-
##
|
|
75
|
+
## 4. Cách tương tác với AI
|
|
72
76
|
|
|
73
|
-
|
|
77
|
+
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!
|
|
74
78
|
|
|
75
79
|
**Ví dụ 1: Nhờ AI tự lên kế hoạch (Kích hoạt `agent-orchestrator`)**
|
|
76
80
|
> "Quang Khánh ơi, 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 nên làm gì trước nhé."
|
|
@@ -86,17 +90,3 @@ Vì AI giờ đây đã có "nghề" (Skill), bạn không cần phải prompt q
|
|
|
86
90
|
|
|
87
91
|
**Ví dụ 5: Tích hợp API (Kích hoạt `api-integration`)**
|
|
88
92
|
> "Tích hợp cái swagger login này vào frontend giúp. Nhớ dùng React Query như chuẩn của project."
|
|
89
|
-
|
|
90
|
-
---
|
|
91
|
-
|
|
92
|
-
## 4. Tùy chỉnh Skin (Dành cho Advanced User)
|
|
93
|
-
|
|
94
|
-
Nếu bạn muốn thêm kỹ năng mới cho AI, hãy sử dụng mẫu (Template) đã được tác giả chuẩn bị sẵn:
|
|
95
|
-
1. Copy file từ thư mục `_template/SKILL.md`.
|
|
96
|
-
2. Chỉnh sửa các thông số: Name, Description, Trigger, Scope, v.v.
|
|
97
|
-
3. Đăng ký nó vào file `skills.json` ở gốc.
|
|
98
|
-
4. Tận hưởng AI với kỹ năng mới của riêng bạn!
|
|
99
|
-
|
|
100
|
-
---
|
|
101
|
-
|
|
102
|
-
Để xem danh sách chi tiết và công dụng của từng skill, vui lòng xem [Chi Tiết Skills](CHI_TIET_SKILLS.md).
|
package/package.json
CHANGED
package/rules-skill/CHANGELOG.md
DELETED
|
@@ -1,31 +0,0 @@
|
|
|
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/`.
|
package/rules-skill/LICENSE
DELETED
|
@@ -1,21 +0,0 @@
|
|
|
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.
|
package/rules-skill/README.md
DELETED
|
@@ -1,142 +0,0 @@
|
|
|
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.*
|
|
@@ -1,154 +0,0 @@
|
|
|
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
|
|
@@ -1,49 +0,0 @@
|
|
|
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
|
-
```
|
|
@@ -1,49 +0,0 @@
|
|
|
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
|
-
```
|