@smicolon/ai-kit 0.0.1 → 0.1.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 (2) hide show
  1. package/README.md +132 -0
  2. package/package.json +11 -2
package/README.md ADDED
@@ -0,0 +1,132 @@
1
+ # @smicolon/ai-kit
2
+
3
+ AI coding tool pack manager. Install convention packs (agents, skills, commands, rules, hooks) for any AI coding tool.
4
+
5
+ ## Quick Start
6
+
7
+ ```bash
8
+ npx @smicolon/ai-kit init
9
+ ```
10
+
11
+ This walks you through selecting your AI tools and stack, then installs the right files in the right places.
12
+
13
+ ## Commands
14
+
15
+ ### `init`
16
+
17
+ Interactive first-time setup. Prompts for your AI tools, stack, and component preferences.
18
+
19
+ ```bash
20
+ npx @smicolon/ai-kit init
21
+ npx @smicolon/ai-kit init --cwd apps/web # monorepo sub-package
22
+ ```
23
+
24
+ ### `add <pack>`
25
+
26
+ Add a pack to your project.
27
+
28
+ ```bash
29
+ npx @smicolon/ai-kit add django
30
+ npx @smicolon/ai-kit add django --skills-only
31
+ npx @smicolon/ai-kit add django --agents-only
32
+ npx @smicolon/ai-kit add django --rules-only
33
+ npx @smicolon/ai-kit add django --tools claude-code,cursor
34
+ ```
35
+
36
+ ### `list`
37
+
38
+ Show available or installed packs.
39
+
40
+ ```bash
41
+ npx @smicolon/ai-kit list # available packs
42
+ npx @smicolon/ai-kit list --installed # installed packs
43
+ ```
44
+
45
+ ### `remove <pack>`
46
+
47
+ Remove a pack and all its installed files.
48
+
49
+ ```bash
50
+ npx @smicolon/ai-kit remove django
51
+ ```
52
+
53
+ ### `update [pack]`
54
+
55
+ Update installed packs to latest versions.
56
+
57
+ ```bash
58
+ npx @smicolon/ai-kit update # update all
59
+ npx @smicolon/ai-kit update django # update one
60
+ ```
61
+
62
+ ## Supported AI Tools
63
+
64
+ | Tool | Skills | Agents | Commands | Rules | Hooks |
65
+ |------|:------:|:------:|:--------:|:-----:|:-----:|
66
+ | Claude Code | yes | yes | yes | yes | yes |
67
+ | Cursor | yes | - | - | yes (.mdc) | - |
68
+ | Windsurf | yes | - | - | yes | - |
69
+ | GitHub Copilot | yes | yes | - | - | - |
70
+ | Codex | yes | yes | - | - | - |
71
+ | Cline | yes | - | - | yes | - |
72
+ | Continue | yes | - | - | yes | - |
73
+ | Gemini | yes | yes | - | - | - |
74
+ | Junie | yes | - | - | yes | - |
75
+ | Kiro | yes | - | - | yes | - |
76
+ | Amp | yes | yes | - | - | - |
77
+ | Antigravity | yes | - | - | yes | - |
78
+ | Augment | yes | - | - | yes | - |
79
+ | Roo Code | yes | - | - | yes | - |
80
+ | Amazon Q | yes | - | - | yes | - |
81
+
82
+ ## Available Packs
83
+
84
+ | Pack | Agents | Skills | Commands | Rules |
85
+ |------|:------:|:------:|:--------:|:-----:|
86
+ | django | 5 | 8 | 3 | 6 |
87
+ | nestjs | 3 | 2 | 1 | 4 |
88
+ | nextjs | 4 | 3 | 1 | 3 |
89
+ | nuxtjs | 3 | 3 | 1 | 3 |
90
+ | hono | 4 | 4 | 4 | - |
91
+ | tanstack-router | 3 | 11 | 4 | - |
92
+ | better-auth | 1 | 2 | 2 | - |
93
+ | flutter | 3 | 3 | 5 | - |
94
+ | architect | 1 | - | 1 | - |
95
+ | dev-loop | - | 1 | 3 | - |
96
+ | failure-log | - | 1 | 2 | - |
97
+ | worktree | - | 1 | 1 | - |
98
+ | onboard | 1 | 1 | 1 | - |
99
+
100
+ ## How It Works
101
+
102
+ Skills use a **canonical + symlink** strategy:
103
+
104
+ ```
105
+ your-project/
106
+ ├── .agents/skills/ # canonical copies
107
+ │ ├── import-convention-enforcer/
108
+ │ └── model-entity-validator/
109
+ ├── .claude/skills/ # symlinks → .agents/skills/*
110
+ ├── .cursor/skills/ # symlinks → .agents/skills/*
111
+ ├── .claude/agents/ # copied .md files
112
+ ├── .claude/commands/ # copied .md files
113
+ ├── .claude/rules/ # copied .md files
114
+ ├── .cursor/rules/ # converted .mdc files
115
+ ├── .ai-kit.json # tracks installed packs + files
116
+ └── .gitignore # auto-updated
117
+ ```
118
+
119
+ Config is stored in `.ai-kit.json` which tracks installed packs and all created files for clean removal.
120
+
121
+ ## Monorepo Support
122
+
123
+ Use `--cwd` to target a sub-package. Both the sub-package and root `.gitignore` are updated.
124
+
125
+ ```bash
126
+ npx @smicolon/ai-kit init --cwd apps/web
127
+ npx @smicolon/ai-kit add django --cwd apps/web
128
+ ```
129
+
130
+ ## License
131
+
132
+ MIT
package/package.json CHANGED
@@ -1,13 +1,22 @@
1
1
  {
2
2
  "name": "@smicolon/ai-kit",
3
- "version": "0.0.1",
3
+ "version": "0.1.0",
4
4
  "description": "AI coding tool pack manager for Smicolon standards",
5
+ "license": "MIT",
6
+ "repository": {
7
+ "type": "git",
8
+ "url": "https://github.com/smicolon/ai-kit",
9
+ "directory": "packages/cli"
10
+ },
5
11
  "type": "module",
6
12
  "bin": {
7
13
  "ai-kit": "./dist/index.js"
8
14
  },
9
15
  "main": "./dist/index.js",
10
- "files": ["dist", "packs"],
16
+ "files": [
17
+ "dist",
18
+ "packs"
19
+ ],
11
20
  "scripts": {
12
21
  "build": "tsup",
13
22
  "dev": "tsup --watch",