@neyugn/agent-kits 0.3.8 → 0.4.0

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 (10) hide show
  1. package/README.md +22 -2
  2. package/README.vi.md +22 -1
  3. package/README.zh.md +22 -1
  4. package/dist/cli.js +2 -2
  5. package/kits/coder/rules/AGENTS.md +3 -5
  6. package/kits/coder/rules/CLAUDE.md +3 -5
  7. package/kits/coder/rules/CURSOR.md +4 -6
  8. package/kits/coder/rules/GEMINI.md +3 -5
  9. package/kits/coder/rules/OPENCODE.md +3 -5
  10. package/package.json +1 -1
package/README.md CHANGED
@@ -17,6 +17,7 @@
17
17
 
18
18
  <p align="center">
19
19
  <a href="#-quick-start">Quick Start</a> •
20
+ <a href="#-important-notes">Important Notes</a> •
20
21
  <a href="#-features">Features</a> •
21
22
  <a href="#-kits">Kits</a> •
22
23
  <a href="#-filter-skill">Filter Skill</a> •
@@ -59,7 +60,26 @@ That's it! The interactive installer will guide you through:
59
60
 
60
61
  <br/>
61
62
 
62
- ## ✨ Features
63
+ ## 📌 Important Notes
64
+
65
+ ### Slash commands not appearing in IDE dropdown
66
+
67
+ If `.agent/` (or `.cursor/`, `.opencode/`, etc.) is listed in `.gitignore`, some IDEs will skip indexing files inside it — including the `workflows/` folder that powers slash commands like `/plan`, `/debug`, `/create`.
68
+
69
+ **Fix:** Add a negation rule to force-include the workflows folder:
70
+
71
+ ```gitignore
72
+ # Ignore the kit folder (optional)
73
+ .agent/
74
+
75
+ # But always index workflows so slash commands work in the IDE
76
+ !.agent/workflows/
77
+ !.agent/workflows/**
78
+ ```
79
+
80
+ > **Recommended:** Remove the kit folder from `.gitignore` entirely and commit it. This is the preferred approach for workspace installations.
81
+
82
+ <br/>
63
83
 
64
84
  ### 🎯 One Command, Any Tool
65
85
 
@@ -76,7 +96,7 @@ npx @neyugn/agent-kits@latest
76
96
  │ / ___ \| |_| || |___ | |\ | | | | . \ | | | | ___) | │
77
97
  │ /_/ \_\\____||_____||_| \_| |_| |_|\_\|___| |_| |____/ │
78
98
  │ │
79
- │ ⚡ The Universal AI Agent Toolkit ⚡ │
99
+ │ ⚡ The Universal AI Agent Toolkit ⚡ │
80
100
  │ │
81
101
  ╰──────────────────────────────────────────────────────────────────────────────╯
82
102
 
package/README.vi.md CHANGED
@@ -51,6 +51,27 @@ npx @neyugn/agent-kits@latest
51
51
 
52
52
  <br/>
53
53
 
54
+ ## 📌 Lưu ý quan trọng
55
+
56
+ ### Slash commands không hiện trong dropdown của IDE
57
+
58
+ Nếu `.agent/` (hoặc `.cursor/`, `.opencode/`, v.v.) bị thêm vào `.gitignore`, một số IDE sẽ bỏ qua việc index các file bên trong — bao gồm cả thư mục `workflows/` là nơi cung cấp các slash commands như `/plan`, `/debug`, `/create`.
59
+
60
+ **Cách khắc phục:** Thêm rule phủ định vào `.gitignore` để buộc index thư mục workflows:
61
+
62
+ ```gitignore
63
+ # Bỏ qua thư mục kit (tùy chọn)
64
+ .agent/
65
+
66
+ # Nhưng luôn index workflows để slash commands hoạt động trong IDE
67
+ !.agent/workflows/
68
+ !.agent/workflows/**
69
+ ```
70
+
71
+ > **Khuyến nghị:** Xóa thư mục kit khỏi `.gitignore` và commit nó vào repo. Đây là cách tiếp cận được khuyến nghị cho cài đặt workspace.
72
+
73
+ <br/>
74
+
54
75
  ## ✨ Tính năng
55
76
 
56
77
  ### 🎯 Một lệnh, mọi công cụ
@@ -68,7 +89,7 @@ npx @neyugn/agent-kits@latest
68
89
  │ / ___ \| |_| || |___ | |\ | | | | . \ | | | | ___) | │
69
90
  │ /_/ \_\\____||_____||_| \_| |_| |_|\_\|___| |_| |____/ │
70
91
  │ │
71
- │ ⚡ The Universal AI Agent Toolkit ⚡ │
92
+ │ ⚡ The Universal AI Agent Toolkit ⚡ │
72
93
  │ │
73
94
  ╯──────────────────────────────────────────────────────────────────────────────╯
74
95
 
package/README.zh.md CHANGED
@@ -51,6 +51,27 @@ npx @neyugn/agent-kits@latest
51
51
 
52
52
  <br/>
53
53
 
54
+ ## 📌 重要说明
55
+
56
+ ### IDE 下拉菜单中不显示斜杠命令
57
+
58
+ 如果 `.agent/`（或 `.cursor/`、`.opencode/` 等）被添加到 `.gitignore` 中，某些 IDE 将跳过对其中文件的索引 — 包括为 `/plan`、`/debug`、`/create` 等斜杠命令提供支持的 `workflows/` 文件夹。
59
+
60
+ **解决方法：** 在 `.gitignore` 中添加否定规则来强制索引 workflows 文件夹：
61
+
62
+ ```gitignore
63
+ # 忽略 kit 文件夹（可选）
64
+ .agent/
65
+
66
+ # 但始终索引 workflows，以便 IDE 中的斜杠命令正常工作
67
+ !.agent/workflows/
68
+ !.agent/workflows/**
69
+ ```
70
+
71
+ > **推荐：** 将 kit 文件夹从 `.gitignore` 中完全移除并提交它。这是工作区安装的推荐做法。
72
+
73
+ <br/>
74
+
54
75
  ## ✨ 功能特性
55
76
 
56
77
  ### 🎯 一条命令，任何工具
@@ -68,7 +89,7 @@ npx @neyugn/agent-kits@latest
68
89
  │ / ___ \| |_| || |___ | |\ | | | | . \ | | | | ___) | │
69
90
  │ /_/ \_\\____||_____||_| \_| |_| |_|\_\|___| |_| |____/ │
70
91
  │ │
71
- │ ⚡ The Universal AI Agent Toolkit ⚡ │
92
+ │ ⚡ The Universal AI Agent Toolkit ⚡ │
72
93
  │ │
73
94
  ╯──────────────────────────────────────────────────────────────────────────────╯
74
95
 
package/dist/cli.js CHANGED
@@ -70,10 +70,10 @@ var AI_TOOLS = [
70
70
  icon: "\u{1F7E3}",
71
71
  path: ".agent",
72
72
  globalPathPattern: "~/.agent",
73
- rulesFile: "GEMINI.md",
73
+ rulesFile: "rules/GEMINI.md",
74
74
  kitRulesFile: "GEMINI.md",
75
75
  rulesInsideKit: true,
76
- // Antigravity reads GEMINI.md from inside .agent/
76
+ // Antigravity reads GEMINI.md from .agent/rules/
77
77
  available: true
78
78
  },
79
79
  {
package/kits/coder/rules/AGENTS.md CHANGED
@@ -182,11 +182,9 @@ These skills are NEVER disabled regardless of profile:
182
182
  - `plan-writing` - Task breakdown and WBS
183
183
  - `systematic-debugging` - 4-phase debugging
184
184
 
185
- ### Domain Skills (40 total - see ARCHITECTURE.md)
185
+ ### Domain Skills (40 total)
186
186
 
187
- Key skills: `api-patterns`, `database-design`, `react-patterns`, `typescript-patterns`, `docker-patterns`, `kubernetes-patterns`, `terraform-patterns`, `auth-patterns`, `graphql-patterns`, `redis-patterns`, `realtime-patterns`, `queue-patterns`, `multi-tenancy`, `ai-rag-patterns`, `prompt-engineering`, `monitoring-observability`, `frontend-design`, `mobile-design`, `tailwind-patterns`, `e2e-testing`, `performance-profiling`, `github-actions`, `gitlab-ci-patterns`
188
-
189
- > 🔴 Full skill list: See `ARCHITECTURE.md` → Skills section
187
+ > Full skill list with descriptions: See `ARCHITECTURE.md` → Skills section
190
188
 
191
189
  ---
192
190
 
@@ -206,7 +204,7 @@ Key skills: `api-patterns`, `database-design`, `react-patterns`, `typescript-pat
206
204
 
207
205
  ### 🗺️ System Map
208
206
 
209
- > 🔴 Read `ARCHITECTURE.md` at session start.
207
+ > Read `ARCHITECTURE.md` only when you need full agent/skill details.
210
208
 
211
209
  **Paths:** Agents `.agent/agents/`, Skills `.agent/skills/`, Workflows `.agent/workflows/`
212
210
 
package/kits/coder/rules/CLAUDE.md CHANGED
@@ -182,11 +182,9 @@ These skills are NEVER disabled regardless of profile:
182
182
  - `plan-writing` - Task breakdown and WBS
183
183
  - `systematic-debugging` - 4-phase debugging
184
184
 
185
- ### Domain Skills (40 total - see ARCHITECTURE.md)
185
+ ### Domain Skills (40 total)
186
186
 
187
- Key skills: `api-patterns`, `database-design`, `react-patterns`, `typescript-patterns`, `docker-patterns`, `kubernetes-patterns`, `terraform-patterns`, `auth-patterns`, `graphql-patterns`, `redis-patterns`, `realtime-patterns`, `queue-patterns`, `multi-tenancy`, `ai-rag-patterns`, `prompt-engineering`, `monitoring-observability`, `frontend-design`, `mobile-design`, `tailwind-patterns`, `e2e-testing`, `performance-profiling`, `github-actions`, `gitlab-ci-patterns`
188
-
189
- > 🔴 Full skill list: See `ARCHITECTURE.md` → Skills section
187
+ > Full skill list with descriptions: See `ARCHITECTURE.md` → Skills section
190
188
 
191
189
  ---
192
190
 
@@ -206,7 +204,7 @@ Key skills: `api-patterns`, `database-design`, `react-patterns`, `typescript-pat
206
204
 
207
205
  ### 🗺️ System Map
208
206
 
209
- > 🔴 Read `ARCHITECTURE.md` at session start.
207
+ > Read `ARCHITECTURE.md` only when you need full agent/skill details.
210
208
 
211
209
  **Paths:** Agents `.agent/agents/`, Skills `.agent/skills/`, Workflows `.agent/workflows/`
212
210
 
package/kits/coder/rules/CURSOR.md CHANGED
@@ -28,7 +28,7 @@ AGT-Kit is a portable, modular AI agent system consisting of:
28
28
 
29
29
  Agent activated → Check frontmatter `skills:` → Read SKILL.md → Apply.
30
30
 
31
- - **Priority:** P0 (GEMINI.md) > P1 (Agent.md) > P2 (SKILL.md). All binding.
31
+ - **Priority:** P0 (CURSOR.md) > P1 (Agent.md) > P2 (SKILL.md). All binding.
32
32
  - **Enforcement:** Never skip reading. "Read → Understand → Apply" mandatory.
33
33
 
34
34
  ---
@@ -190,11 +190,9 @@ These skills are NEVER disabled regardless of profile:
190
190
  - `plan-writing` - Task breakdown and WBS
191
191
  - `systematic-debugging` - 4-phase debugging
192
192
 
193
- ### Domain Skills (40 total - see ARCHITECTURE.md)
193
+ ### Domain Skills (40 total)
194
194
 
195
- Key skills: `api-patterns`, `database-design`, `react-patterns`, `typescript-patterns`, `docker-patterns`, `kubernetes-patterns`, `terraform-patterns`, `auth-patterns`, `graphql-patterns`, `redis-patterns`, `realtime-patterns`, `queue-patterns`, `multi-tenancy`, `ai-rag-patterns`, `prompt-engineering`, `monitoring-observability`, `frontend-design`, `mobile-design`, `tailwind-patterns`, `e2e-testing`, `performance-profiling`, `github-actions`, `gitlab-ci-patterns`
196
-
197
- > 🔴 Full skill list: See `ARCHITECTURE.md` → Skills section
195
+ > Full skill list with descriptions: See `ARCHITECTURE.md` → Skills section
198
196
 
199
197
  ---
200
198
 
@@ -214,7 +212,7 @@ Key skills: `api-patterns`, `database-design`, `react-patterns`, `typescript-pat
214
212
 
215
213
  ### 🗺️ System Map
216
214
 
217
- > 🔴 Read `ARCHITECTURE.md` at session start.
215
+ > Read `ARCHITECTURE.md` only when you need full agent/skill details.
218
216
 
219
217
  **Paths:** Agents `.cursor/agents/`, Skills `.cursor/skills/`, Commands `.cursor/commands/`
220
218
 
package/kits/coder/rules/GEMINI.md CHANGED
@@ -186,11 +186,9 @@ These skills are NEVER disabled regardless of profile:
186
186
  - `plan-writing` - Task breakdown and WBS
187
187
  - `systematic-debugging` - 4-phase debugging
188
188
 
189
- ### Domain Skills (40 total - see ARCHITECTURE.md)
189
+ ### Domain Skills (40 total)
190
190
 
191
- Key skills: `api-patterns`, `database-design`, `react-patterns`, `typescript-patterns`, `docker-patterns`, `kubernetes-patterns`, `terraform-patterns`, `auth-patterns`, `graphql-patterns`, `redis-patterns`, `realtime-patterns`, `queue-patterns`, `multi-tenancy`, `ai-rag-patterns`, `prompt-engineering`, `monitoring-observability`, `frontend-design`, `mobile-design`, `tailwind-patterns`, `e2e-testing`, `performance-profiling`, `github-actions`, `gitlab-ci-patterns`
192
-
193
- > 🔴 Full skill list: See `ARCHITECTURE.md` → Skills section
191
+ > Full skill list with descriptions: See `ARCHITECTURE.md` → Skills section
194
192
 
195
193
  ---
196
194
 
@@ -210,7 +208,7 @@ Key skills: `api-patterns`, `database-design`, `react-patterns`, `typescript-pat
210
208
 
211
209
  ### 🗺️ System Map
212
210
 
213
- > 🔴 Read `ARCHITECTURE.md` at session start.
211
+ > Read `ARCHITECTURE.md` only when you need full agent/skill details.
214
212
 
215
213
  **Paths:** Agents `.agent/agents/`, Skills `.agent/skills/`, Workflows `.agent/workflows/`
216
214
 
package/kits/coder/rules/OPENCODE.md CHANGED
@@ -224,11 +224,9 @@ These skills are NEVER disabled regardless of profile:
224
224
  - `plan-writing` - Task breakdown and WBS
225
225
  - `systematic-debugging` - 4-phase debugging
226
226
 
227
- ### Domain Skills (40 total - see .agent/ARCHITECTURE.md)
227
+ ### Domain Skills (40 total)
228
228
 
229
- Key skills: `api-patterns`, `database-design`, `react-patterns`, `typescript-patterns`, `docker-patterns`, `kubernetes-patterns`, `terraform-patterns`, `auth-patterns`, `graphql-patterns`, `redis-patterns`, `realtime-patterns`, `queue-patterns`, `multi-tenancy`, `ai-rag-patterns`, `prompt-engineering`, `monitoring-observability`, `frontend-design`, `mobile-design`, `tailwind-patterns`, `e2e-testing`, `performance-profiling`, `github-actions`, `gitlab-ci-patterns`
230
-
231
- > 🔴 Full skill list: See `.agent/ARCHITECTURE.md` → Skills section
229
+ > Full skill list with descriptions: See `.agent/ARCHITECTURE.md` → Skills section
232
230
 
233
231
  ---
234
232
 
@@ -248,7 +246,7 @@ Key skills: `api-patterns`, `database-design`, `react-patterns`, `typescript-pat
248
246
 
249
247
  ### 🗺️ System Map
250
248
 
251
- > 🔴 Read `.agent/ARCHITECTURE.md` at session start.
249
+ > Read `.agent/ARCHITECTURE.md` only when you need full agent/skill details.
252
250
 
253
251
  **Paths:** Agents `.agent/agents/`, Skills `.agent/skills/`, Workflows `.agent/workflows/`
254
252
 
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@neyugn/agent-kits",
3
- "version": "0.3.8",
3
+ "version": "0.4.0",
4
4
  "description": "Universal AI Agent Toolkit - Skills, Agents, and Workflows for any AI coding assistant",
5
5
  "type": "module",
6
6
  "bin": {