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.
Files changed (34) hide show
  1. package/README.md +50 -109
  2. package/package.json +1 -1
  3. package/rules-skill/CHANGELOG.md +31 -0
  4. package/rules-skill/LICENSE +21 -0
  5. package/rules-skill/README.md +142 -0
  6. package/rules-skill/_template/SKILL.md +154 -0
  7. package/rules-skill/_template/examples/example-en.md +49 -0
  8. package/rules-skill/_template/examples/example-vi.md +49 -0
  9. package/rules-skill/docs/CHI_TIET_SKILLS.md +117 -0
  10. package/rules-skill/docs/HUONG_DAN_SU_DUNG.md +102 -0
  11. package/rules-skill/skills/backend/auth-security/SKILL.md +94 -0
  12. package/rules-skill/skills/backend/backend-architecture/SKILL.md +123 -0
  13. package/rules-skill/skills/backend/database-engineer/SKILL.md +102 -0
  14. package/rules-skill/skills/backend/deployment/SKILL.md +94 -0
  15. package/rules-skill/skills/engineering/agent-orchestrator/SKILL.md +177 -0
  16. package/rules-skill/skills/engineering/api-integration/SKILL.md +378 -0
  17. package/rules-skill/skills/engineering/bug-fix/SKILL.md +211 -0
  18. package/rules-skill/skills/engineering/context-manager/SKILL.md +174 -0
  19. package/rules-skill/skills/engineering/git-engineer/SKILL.md +302 -0
  20. package/rules-skill/skills/engineering/migration/SKILL.md +282 -0
  21. package/rules-skill/skills/engineering/project-audit/SKILL.md +278 -0
  22. package/rules-skill/skills/engineering/refactor/SKILL.md +220 -0
  23. package/rules-skill/skills/frontend/accessibility-audit/SKILL.md +119 -0
  24. package/rules-skill/skills/frontend/component-generator/SKILL.md +134 -0
  25. package/rules-skill/skills/frontend/design-system/SKILL.md +135 -0
  26. package/rules-skill/skills/frontend/form-builder/SKILL.md +138 -0
  27. package/rules-skill/skills/frontend/frontend-architecture/SKILL.md +153 -0
  28. package/rules-skill/skills/frontend/frontend-debug/SKILL.md +131 -0
  29. package/rules-skill/skills/frontend/frontend-performance/SKILL.md +127 -0
  30. package/rules-skill/skills/frontend/frontend-testing/SKILL.md +144 -0
  31. package/rules-skill/skills/frontend/state-management/SKILL.md +138 -0
  32. package/rules-skill/skills/frontend/table-crud-generator/SKILL.md +125 -0
  33. package/rules-skill/skills/frontend/ui-builder/SKILL.md +150 -0
  34. 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
- **A multi-agent skill package for AI coding assistants.**
4
- Bộ skill package đa nền tảng cho AI coding assistant.
3
+ [![npm version](https://badge.fury.io/js/ai-developer-skill-os.svg)](https://badge.fury.io/js/ai-developer-skill-os)
4
+ [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
5
5
 
6
- > Tác giả: **Quang Khánh**
7
- > Compatible with: **Claude Code · Kilo Code · Antigravity/Gemini IDE · Cursor · Windsurf**
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
- 📚 **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)
9
+ > Tác giả: **Quang Khánh**
12
10
 
13
11
  ---
14
12
 
15
- ## What is this? / Đây là gì?
13
+ ## 🌟 Tính năng nổi bật (Features)
16
14
 
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.
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
- **VI:** Bộ skill 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
+ 👉 [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
- ## Skill Map / Sơ đồ Skill
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
- ## 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 |
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
- ## Installation / Cài đặt
43
+ ## 🛠️ Cấu hình cho IDE / AI Agent
87
44
 
88
- ### Antigravity / Gemini IDE
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
- Place this folder in your `.agents/skills/` directory:
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
- Use skills from: ./rules-skill/skills/
109
- When the user requests [task], load the appropriate SKILL.md and follow it precisely.
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
- ## 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 |
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
- ## Contributing / Đóng góp
70
+ ## 🚀 Cách sử dụng (Usage)
126
71
 
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
- ---
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
- ## Version / Phiên bản
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
- **v1.0.0** Initial release.
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
- *Tác giả: Quang Khánh*
142
- *Được xây dựng cho cộng đồng AI engineering.*
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
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "ai-developer-skill-os",
3
- "version": "1.0.0",
3
+ "version": "1.0.1",
4
4
  "description": "Multi-agent skill package cho AI coding agents (Claude, Cursor, Windsurf, Antigravity) với 23 skills chuyên nghiệp.",
5
5
  "main": "bin/install.js",
6
6
  "bin": {
@@ -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
+ ```