packwise-skills 1.0.0 → 1.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 (52) hide show
  1. package/.cursorrules +23 -23
  2. package/CLAUDE.md +25 -25
  3. package/README.md +327 -295
  4. package/audit.md +224 -224
  5. package/bin/packwise.js +216 -155
  6. package/install.sh +89 -0
  7. package/package.json +32 -31
  8. package/skill.md +719 -719
  9. package/sub-skills/ai/local-llm.md +183 -183
  10. package/sub-skills/ai/python-ml.md +164 -164
  11. package/sub-skills/backend/go-server.md +184 -184
  12. package/sub-skills/backend/java-spring.md +241 -241
  13. package/sub-skills/backend/node-server.md +164 -164
  14. package/sub-skills/backend/php-laravel.md +175 -175
  15. package/sub-skills/backend/python-server.md +164 -164
  16. package/sub-skills/backend/rust-backend.md +118 -118
  17. package/sub-skills/cli/python-cli.md +236 -236
  18. package/sub-skills/cli/sdk-library.md +497 -497
  19. package/sub-skills/cloud/ci-cd-pipelines.md +350 -350
  20. package/sub-skills/cloud/docker.md +191 -191
  21. package/sub-skills/cloud/kubernetes.md +277 -277
  22. package/sub-skills/cloud/payment-integration.md +307 -307
  23. package/sub-skills/cross-platform/multiplatform.md +252 -252
  24. package/sub-skills/desktop/electron.md +783 -783
  25. package/sub-skills/desktop/game-dev.md +443 -443
  26. package/sub-skills/desktop/native-app.md +123 -123
  27. package/sub-skills/desktop/scenarios.md +443 -443
  28. package/sub-skills/desktop/smart-platforms.md +324 -324
  29. package/sub-skills/desktop/tauri.md +428 -428
  30. package/sub-skills/desktop/vr-ar.md +252 -252
  31. package/sub-skills/desktop/web-to-desktop.md +153 -153
  32. package/sub-skills/embedded/car-infotainment.md +129 -129
  33. package/sub-skills/embedded/esp32.md +184 -184
  34. package/sub-skills/embedded/ros.md +150 -150
  35. package/sub-skills/embedded/stm32.md +160 -160
  36. package/sub-skills/mobile/android.md +322 -322
  37. package/sub-skills/mobile/capacitor.md +232 -232
  38. package/sub-skills/mobile/flutter-mobile.md +138 -138
  39. package/sub-skills/mobile/harmonyos.md +150 -150
  40. package/sub-skills/mobile/ios.md +245 -245
  41. package/sub-skills/mobile/react-native.md +443 -443
  42. package/sub-skills/mobile/wearables.md +230 -230
  43. package/sub-skills/plugins/browser-extension.md +308 -308
  44. package/sub-skills/plugins/jetbrains-plugin.md +226 -226
  45. package/sub-skills/plugins/vscode-extension.md +204 -204
  46. package/sub-skills/security/security-tools.md +174 -174
  47. package/sub-skills/web/monorepo.md +274 -274
  48. package/sub-skills/web/pwa.md +220 -220
  49. package/sub-skills/web/serverless-edge.md +295 -295
  50. package/sub-skills/web/spa.md +266 -266
  51. package/sub-skills/web/ssr.md +228 -228
  52. package/sub-skills/web/wasm.md +243 -243
package/README.md CHANGED
@@ -1,295 +1,327 @@
1
- # packwise-skills
2
-
3
- > One skill that turns your AI into a build consultant — scan, recommend, package, and audit any project.
4
-
5
- <p align="center">
6
- <a href="https://github.com/Thomas520TOM/packwise-skills/commits/main">
7
- <img src="https://img.shields.io/github/last-commit/Thomas520TOM/packwise-skills?style=flat-square&logo=github" alt="last commit">
8
- </a>
9
- <a href="https://github.com/Thomas520TOM/packwise-skills/blob/main/LICENSE">
10
- <img src="https://img.shields.io/badge/license-MIT-blue?style=flat-square&logo=github" alt="license">
11
- </a>
12
- <a href="https://github.com/Thomas520TOM/packwise-skills/tree/main/sub-skills">
13
- <img src="https://img.shields.io/badge/skills-44-brightgreen?style=flat-square" alt="skills">
14
- </a>
15
- <a href="#supported-platforms">
16
- <img src="https://img.shields.io/badge/platforms-20%2B-orange?style=flat-square" alt="platforms">
17
- </a>
18
- <a href="#supported-platforms">
19
- <img src="https://img.shields.io/badge/frameworks-40%2B-purple?style=flat-square" alt="frameworks">
20
- </a>
21
- <a href="#tested-framework-versions">
22
- <img src="https://img.shields.io/badge/tested-10-success?style=flat-square" alt="tested">
23
- </a>
24
- <a href="#installation">
25
- <img src="https://img.shields.io/badge/works%20with-Claude%20Code%20%7C%20OpenCode%20%7C%20Cursor-yellow?style=flat-square" alt="works with">
26
- </a>
27
- </p>
28
-
29
- ---
30
-
31
- **Packwise** is a universal build & packaging skill for AI-assisted development. Instead of your AI guessing at build commands and hoping for the best, Packwise gives it a structured, consultant-grade workflow that scans your project, asks the right questions, recommends solutions with reasoning, and executes builds with mandatory security audits — across 20+ platforms and 40+ frameworks.
32
-
33
- ---
34
-
35
- ## Why This Exists
36
-
37
- Packaging software is where most AI coding assistants fail. They suggest outdated flags, forget platform-specific quirks, skip credential scans, and have no concept of a proper build plan. **Packwise fixes this** by turning your AI into a structured build consultant with real domain knowledge.
38
-
39
- <div align="center">
40
-
41
- | Without Packwise | With Packwise |
42
- |:---:|:---:|
43
- | `"Try running npm run build"` | Scans project → identifies framework/version → recommends with reasoning |
44
- | No security checks | Mandatory credential scan, `.env` detection, source map cleanup |
45
- | Guesses platform differences | Asks target platform, arch, signing, output — all upfront |
46
- | One-shot answer | Full workflow: recommend → alternatives → confirm → execute |
47
- | No post-build verification | Mandatory audit: credentials, integrity, file structure |
48
-
49
- </div>
50
-
51
- ---
52
-
53
- ## How It Works
54
-
55
- Packwise runs a **consultant-style 8-step workflow** — the same process a human build engineer would follow:
56
-
57
- | Step | Action | Result |
58
- |:----:|--------|--------|
59
- | **1** | **Scan** — detect framework, language, dependencies, `.env` files | Project analysis |
60
- | **2** | **Intake** — report findings, ask 12 structured questions | User preferences |
61
- | **3** | **Analyze** — combine scan + answers + online research (if needed) | Strategy options |
62
- | **4** | **Recommend** — present best approach with reasoning + alternatives | Decision support |
63
- | **5** | **Confirm** — user selects, final build plan generated | Confirmed plan |
64
- | **6** | **Execute** — load sub-skill, run build commands | Installers / packages |
65
- | **7** | **Audit** — credentials, `.env`, `.map`, package integrity | Security report |
66
- | **8** | **Report** — structured final build report | Delivery |
67
-
68
- ---
69
-
70
- ## Key Advantages
71
-
72
- Packwise is more than a build script. It's a **complete packaging intelligence layer** that works across your entire stack.
73
-
74
- | Capability | What It Means |
75
- |------------|---------------|
76
- | **44 sub-skills** | Deep, platform-specific knowledge — not generic advice |
77
- | **20+ platforms** | Desktop, mobile, web, backend, AI/ML, CLI, plugins, embedded, cloud |
78
- | **Mandatory security** | Every build ends with a credential and integrity audit |
79
- | **Consultant workflow** | Recommend → confirm → execute, never auto-builds without approval |
80
- | **Version-verified** | Build commands checked against npm, PyPI, crates.io, official registries |
81
- | **CI/CD templates** | GitHub Actions and GitLab CI configs included in every sub-skill |
82
- | **Cross-tool support** | Works with Claude Code, OpenCode, Cursor, Codex CLI, and more |
83
-
84
- ---
85
-
86
- ## Installation
87
-
88
- ### npm (Recommended)
89
-
90
- ```bash
91
- npm install -g packwise-skills
92
- ```
93
-
94
- Then invoke in your AI agent:
95
-
96
- ```
97
- > package my Electron app for Windows
98
- ```
99
-
100
- <details>
101
- <summary><strong>Git clone</strong> — install from source</summary>
102
-
103
- ```bash
104
- # User-level (all projects)
105
- cd ~/.claude/
106
- git clone https://github.com/Thomas520TOM/packwise-skills.git skills/packwise
107
-
108
- # Project-level (this project only)
109
- cd your-project/
110
- mkdir -p .claude/skills/
111
- git clone https://github.com/Thomas520TOM/packwise-skills.git .claude/skills/packwise
112
- ```
113
- </details>
114
-
115
- <details>
116
- <summary><strong>Curl one-liner</strong> — install with a single command</summary>
117
-
118
- ```bash
119
- curl -fsSL https://raw.githubusercontent.com/Thomas520TOM/packwise-skills/main/install.sh | bash
120
- ```
121
- </details>
122
-
123
- <details>
124
- <summary><strong>Other AI tools</strong> OpenCode, Cursor, Hermes, Codex CLI, WorkBuddy</summary>
125
-
126
- **OpenCode** — copy to `.opencode/skills/packwise/` and reference in prompts:
127
- ```bash
128
- mkdir -p .opencode/skills/packwise/
129
- cp skill.md audit.md .opencode/skills/packwise/
130
- cp -r sub-skills/ .opencode/skills/packwise/
131
- ```
132
-
133
- **Cursor** — add to `.cursor/skills/` or reference via `@packwise` in prompts.
134
-
135
- **Hermes / LangChain Agents** — add to `hermes.config.yaml`:
136
- ```yaml
137
- skills:
138
- - path: /path/to/packwise/
139
- name: packwise
140
- ```
141
-
142
- **Codex CLI** — copy to project root as `PACKWISE.md` (auto-read as context).
143
-
144
- **WorkBuddy** copy to `~/.workbuddy/skills/` or use `/project:packwise`.
145
-
146
- **Any LLM agent** — copy `skill.md` + `sub-skills/` to your project and prompt:
147
- ```
148
- Read skills/package-skill.md and help me package this project
149
- ```
150
-
151
- Full instructions: [INSTALL.md](INSTALL.md)
152
- </details>
153
-
154
- ---
155
-
156
- ## Supported Platforms
157
-
158
- | Category | Frameworks | Build Verified |
159
- |----------|-----------|:--------------:|
160
- | **Desktop** | Electron 43, Tauri 2.11, Qt, Flutter Desktop, Pake, Neutralinojs | Electron, Tauri |
161
- | **Mobile** | Android (Kotlin), iOS/iPadOS, HarmonyOS NEXT, Flutter 3.44, React Native 0.86, Capacitor 8 | — |
162
- | **Web** | Vite 8, Next.js 16, PWA, Serverless/Edge, Monorepo, WebAssembly | Vite, Next.js |
163
- | **Backend** | Node.js 26, Python 3.12, Go 1.26, Rust, Java/Spring Boot 3.5, PHP/Laravel | Node, Python, Rust, Java |
164
- | **AI/ML** | PyTorch, TensorFlow, ONNX Runtime, Ollama, llama.cpp, vLLM | — |
165
- | **CLI/SDK** | PyInstaller, Nuitka, npm/PyPI/crates.io publishing | PyInstaller |
166
- | **Plugins** | Chrome/Firefox Extensions, VS Code, JetBrains | — |
167
- | **Embedded** | ESP32, STM32, ROS/ROS2, Car Infotainment | — |
168
- | **Cloud** | Docker, Kubernetes, CI/CD (GitHub Actions) | — |
169
- | **Wearables** | watchOS, Wear OS, Galaxy Watch | — |
170
-
171
- > Checked = build tested on real projects. — = documentation verified against official sources.
172
-
173
- ---
174
-
175
- ## Architecture
176
-
177
- ```
178
- skill.md (Main Orchestrator)
179
-
180
- ├─ Step 1: Project Scan ─────── Detect framework, language, deps, env
181
-
182
- ├─ Step 2: Intake ───────────── Ask 12 questions (platform, arch, signing...)
183
- │ ├─ Part A: Project Summary ← scan results displayed
184
- │ ├─ Part B: Questions ← interactive options with defaults
185
- │ └─ Part C: Confirmation ← summary table for user approval
186
-
187
- ├─ Step 3: Analyze & Research ── Combine data + online research if needed
188
-
189
- ├─ Step 4: Recommend ⭐ ──────── Best solution + alternatives + reasoning
190
-
191
- ├─ Step 5: Confirm ───────────── User selects → final build plan
192
-
193
- ├─ Step 6: Execute ───────────── Load sub-skill run build commands
194
- │ ├─ sub-skills/desktop/ Electron, Tauri, Qt, games, VR...
195
- │ ├─ sub-skills/mobile/ Android, iOS, Flutter, RN, watchOS...
196
- │ ├─ sub-skills/web/ Vite, Next.js, PWA, WASM...
197
- │ ├─ sub-skills/backend/ Node, Python, Go, Rust, Java, PHP
198
- │ ├─ sub-skills/ai/ PyTorch, Ollama, llama.cpp
199
- │ ├─ sub-skills/cli/ PyInstaller, npm/PyPI publishing
200
- │ ├─ sub-skills/plugins/ Chrome, VS Code, JetBrains
201
- │ ├─ sub-skills/embedded/ ESP32, STM32, ROS, car
202
- │ ├─ sub-skills/security/ Pentest tools, scanners
203
- │ ├─ sub-skills/cloud/ Docker, K8s, CI/CD
204
- │ └─ sub-skills/cross-platform/ .NET MAUI, KMP
205
-
206
- ├─ Step 7: Audit (mandatory) ── Credentials, .env, .map, package check
207
-
208
- └─ Step 8: Final Report ─────── Build report with all results
209
- ```
210
-
211
- ---
212
-
213
- ## Security Model
214
-
215
- Packwise enforces security at every stage no build completes without a clean audit.
216
-
217
- | Stage | Check |
218
- |-------|-------|
219
- | **Pre-build scan** | Detect `.env` files, hardcoded API keys, secrets in source |
220
- | **Build execution** | Delete source maps, exclude `.env` from package, clean test data |
221
- | **Post-build audit** | Verify no credentials, `.map` files, or `.env` in final package |
222
- | **Network check** | Optional: verify no unexpected outbound connections |
223
-
224
- ---
225
-
226
- ## What's Inside
227
-
228
- ### 44 Sub-Skills Every Major Platform Covered
229
-
230
- Each sub-skill contains:
231
- - **Version-verified** build commands (checked against official registries)
232
- - **Step-by-step** packaging workflows with copy-paste examples
233
- - **Common pitfalls** table with solutions (from real build testing)
234
- - **CI/CD** configuration templates (GitHub Actions, GitLab CI)
235
- - **Security** best practices specific to the platform
236
-
237
- ### Tested Framework Versions
238
-
239
- | Framework | Version | Verified |
240
- |-----------|:-------:|:--------:|
241
- | Electron | 43.x | ✅ |
242
- | Tauri | 2.11.x | ✅ |
243
- | Vite | 8.1.3 | ✅ |
244
- | Next.js | 16.2.10 | ✅ |
245
- | Node.js | 26 LTS | ✅ |
246
- | Python | 3.12 | ✅ |
247
- | Rust | 1.96 | |
248
- | Java | 21 LTS | ✅ |
249
- | React Native | 0.86.x | — |
250
- | Flutter | 3.44.x | — |
251
- | Capacitor | 8.x | |
252
- | Go | 1.26 | |
253
-
254
- ---
255
-
256
- ## Contributing
257
-
258
- Contributions are welcome. Before submitting, please:
259
-
260
- 1. Write all instructions in **English** only
261
- 2. Verify framework versions against **official registries** (npm, PyPI, GitHub Releases)
262
- 3. Include a **Common Pitfalls** table in every new sub-skill
263
- 4. Test build commands when possible
264
- 5. Never commit secrets, API keys, or credentials
265
-
266
- ```bash
267
- git clone https://github.com/YOUR_USER/packwise-skills.git
268
- cd packwise-skills
269
- git checkout -b feat/my-improvement
270
- # edit skill.md or sub-skills/
271
- git commit -m "feat: add [framework] support"
272
- git push origin feat/my-improvement
273
- # open a PR against main
274
- ```
275
-
276
- ---
277
-
278
- ## License
279
-
280
- <div align="center">
281
-
282
- [![License: MIT](https://img.shields.io/badge/License-MIT-blue?style=flat-square&logo=github)](https://opensource.org/licenses/MIT)
283
-
284
- This project is licensed under the [MIT License](LICENSE).
285
-
286
- </div>
287
-
288
- ---
289
-
290
- <div align="center">
291
- Built with care for the AI-assisted development community.
292
- <br><br>
293
- <a href="https://github.com/Thomas520TOM/packwise-skills">GitHub</a> · <a href="https://github.com/Thomas520TOM/packwise-skills/issues">Issues</a> · <a href="https://github.com/Thomas520TOM/packwise-skills/blob/main/INSTALL.md">Install Guide</a>
294
- <br>
295
- </div>
1
+ # packwise-skills
2
+
3
+ > One skill that turns your AI into a build consultant — scan, recommend, package, and audit any project.
4
+
5
+ <p align="center">
6
+ <a href="https://github.com/Thomas520TOM/packwise-skills/commits/main">
7
+ <img src="https://img.shields.io/github/last-commit/Thomas520TOM/packwise-skills?style=flat-square&logo=github" alt="last commit">
8
+ </a>
9
+ <a href="https://github.com/Thomas520TOM/packwise-skills/blob/main/LICENSE">
10
+ <img src="https://img.shields.io/badge/license-MIT-blue?style=flat-square&logo=github" alt="license">
11
+ </a>
12
+ <a href="https://github.com/Thomas520TOM/packwise-skills/tree/main/sub-skills">
13
+ <img src="https://img.shields.io/badge/skills-44-brightgreen?style=flat-square" alt="skills">
14
+ </a>
15
+ <a href="#supported-platforms">
16
+ <img src="https://img.shields.io/badge/platforms-20%2B-orange?style=flat-square" alt="platforms">
17
+ </a>
18
+ <a href="#supported-platforms">
19
+ <img src="https://img.shields.io/badge/frameworks-40%2B-purple?style=flat-square" alt="frameworks">
20
+ </a>
21
+ <a href="#tested-framework-versions">
22
+ <img src="https://img.shields.io/badge/tested-10-success?style=flat-square" alt="tested">
23
+ </a>
24
+ <a href="#installation">
25
+ <img src="https://img.shields.io/badge/works%20with-Claude%20Code%20%7C%20OpenCode%20%7C%20Cursor-yellow?style=flat-square" alt="works with">
26
+ </a>
27
+ </p>
28
+
29
+ ---
30
+
31
+ **Packwise** is a universal build & packaging skill for AI-assisted development. Instead of your AI guessing at build commands and hoping for the best, Packwise gives it a structured, consultant-grade workflow that scans your project, asks the right questions, recommends solutions with reasoning, and executes builds with mandatory security audits — across 20+ platforms and 40+ frameworks.
32
+
33
+ ---
34
+
35
+ ## Why This Exists
36
+
37
+ Packaging software is where most AI coding assistants fail. They suggest outdated flags, forget platform-specific quirks, skip credential scans, and have no concept of a proper build plan. **Packwise fixes this** by turning your AI into a structured build consultant with real domain knowledge.
38
+
39
+ <div align="center">
40
+
41
+ | Without Packwise | With Packwise |
42
+ |:---:|:---:|
43
+ | `"Try running npm run build"` | Scans project → identifies framework/version → recommends with reasoning |
44
+ | No security checks | Mandatory credential scan, `.env` detection, source map cleanup |
45
+ | Guesses platform differences | Asks target platform, arch, signing, output — all upfront |
46
+ | One-shot answer | Full workflow: recommend → alternatives → confirm → execute |
47
+ | No post-build verification | Mandatory audit: credentials, integrity, file structure |
48
+
49
+ </div>
50
+
51
+ ---
52
+
53
+ ## How It Works
54
+
55
+ Packwise runs a **consultant-style 8-step workflow** — the same process a human build engineer would follow:
56
+
57
+ | Step | Action | Result |
58
+ |:----:|--------|--------|
59
+ | **1** | **Scan** — detect framework, language, dependencies, `.env` files | Project analysis |
60
+ | **2** | **Intake** — report findings, ask 12 structured questions | User preferences |
61
+ | **3** | **Analyze** — combine scan + answers + online research (if needed) | Strategy options |
62
+ | **4** | **Recommend** — present best approach with reasoning + alternatives | Decision support |
63
+ | **5** | **Confirm** — user selects, final build plan generated | Confirmed plan |
64
+ | **6** | **Execute** — load sub-skill, run build commands | Installers / packages |
65
+ | **7** | **Audit** — credentials, `.env`, `.map`, package integrity | Security report |
66
+ | **8** | **Report** — structured final build report | Delivery |
67
+
68
+ ---
69
+
70
+ ## Key Advantages
71
+
72
+ Packwise is more than a build script. It's a **complete packaging intelligence layer** that works across your entire stack.
73
+
74
+ | Capability | What It Means |
75
+ |------------|---------------|
76
+ | **44 sub-skills** | Deep, platform-specific knowledge — not generic advice |
77
+ | **20+ platforms** | Desktop, mobile, web, backend, AI/ML, CLI, plugins, embedded, cloud |
78
+ | **Mandatory security** | Every build ends with a credential and integrity audit |
79
+ | **Consultant workflow** | Recommend → confirm → execute, never auto-builds without approval |
80
+ | **Version-verified** | Build commands checked against npm, PyPI, crates.io, official registries |
81
+ | **CI/CD templates** | GitHub Actions and GitLab CI configs included in every sub-skill |
82
+ | **Cross-tool support** | Works with Claude Code, OpenCode, Cursor, Codex CLI, and more |
83
+
84
+ ---
85
+
86
+ ## Installation
87
+
88
+ ### npx (No Install Required)
89
+
90
+ Run directly without installing globally:
91
+
92
+ ```bash
93
+ npx packwise-skills
94
+ ```
95
+
96
+ ### npm (Recommended)
97
+
98
+ ```bash
99
+ npm install -g packwise-skills
100
+ ```
101
+
102
+ ### Curl One-liner
103
+
104
+ ```bash
105
+ curl -fsSL https://raw.githubusercontent.com/Thomas520TOM/packwise-skills/main/install.sh | bash
106
+ ```
107
+
108
+ ### Git Clone
109
+
110
+ ```bash
111
+ # User-level (all projects)
112
+ cd ~/.claude/
113
+ git clone https://github.com/Thomas520TOM/packwise-skills.git skills/packwise
114
+
115
+ # Project-level (this project only)
116
+ cd your-project/
117
+ mkdir -p .claude/skills/
118
+ git clone https://github.com/Thomas520TOM/packwise-skills.git .claude/skills/packwise
119
+ ```
120
+
121
+ Then invoke in your AI agent:
122
+
123
+ ```
124
+ > package my Electron app for Windows
125
+ ```
126
+
127
+ ---
128
+
129
+ ### Selective Installation
130
+
131
+ Only need certain platforms? Use `--only` to install specific sub-skills. Core files (`skill.md`, `audit.md`, `CLAUDE.md`) are always installed.
132
+
133
+ ```bash
134
+ # Desktop + Mobile only
135
+ npx packwise-skills --only desktop,mobile
136
+
137
+ # Backend + Cloud only
138
+ npx packwise-skills --only backend,cloud
139
+
140
+ # AI/ML + CLI only
141
+ npx packwise-skills --only ai,cli
142
+ ```
143
+
144
+ Works with curl too:
145
+
146
+ ```bash
147
+ curl -fsSL https://raw.githubusercontent.com/Thomas520TOM/packwise-skills/main/install.sh | bash -s -- --only desktop,mobile
148
+ ```
149
+
150
+ **Available categories:**
151
+ `desktop` `mobile` `web` `backend` `ai` `cli` `plugins` `embedded` `security` `cloud` `cross-platform`
152
+
153
+ ---
154
+
155
+ <details>
156
+ <summary><strong>Other AI tools</strong> — OpenCode, Cursor, Hermes, Codex CLI, WorkBuddy</summary>
157
+
158
+ **OpenCode** copy to `.opencode/skills/packwise/` and reference in prompts:
159
+ ```bash
160
+ mkdir -p .opencode/skills/packwise/
161
+ cp skill.md audit.md .opencode/skills/packwise/
162
+ cp -r sub-skills/ .opencode/skills/packwise/
163
+ ```
164
+
165
+ **Cursor** add to `.cursor/skills/` or reference via `@packwise` in prompts.
166
+
167
+ **Hermes / LangChain Agents** add to `hermes.config.yaml`:
168
+ ```yaml
169
+ skills:
170
+ - path: /path/to/packwise/
171
+ name: packwise
172
+ ```
173
+
174
+ **Codex CLI** — copy to project root as `PACKWISE.md` (auto-read as context).
175
+
176
+ **WorkBuddy** — copy to `~/.workbuddy/skills/` or use `/project:packwise`.
177
+
178
+ **Any LLM agent** — copy `skill.md` + `sub-skills/` to your project and prompt:
179
+ ```
180
+ Read skills/skill.md and help me package this project
181
+ ```
182
+
183
+ Full instructions: [INSTALL.md](INSTALL.md)
184
+ </details>
185
+
186
+ ---
187
+
188
+ ## Supported Platforms
189
+
190
+ | Category | Frameworks | Build Verified |
191
+ |----------|-----------|:--------------:|
192
+ | **Desktop** | Electron 43, Tauri 2.11, Qt, Flutter Desktop, Pake, Neutralinojs | Electron, Tauri |
193
+ | **Mobile** | Android (Kotlin), iOS/iPadOS, HarmonyOS NEXT, Flutter 3.44, React Native 0.86, Capacitor 8 | — |
194
+ | **Web** | Vite 8, Next.js 16, PWA, Serverless/Edge, Monorepo, WebAssembly | Vite, Next.js |
195
+ | **Backend** | Node.js 26, Python 3.12, Go 1.26, Rust, Java/Spring Boot 3.5, PHP/Laravel | Node, Python, Rust, Java |
196
+ | **AI/ML** | PyTorch, TensorFlow, ONNX Runtime, Ollama, llama.cpp, vLLM | — |
197
+ | **CLI/SDK** | PyInstaller, Nuitka, npm/PyPI/crates.io publishing | PyInstaller |
198
+ | **Plugins** | Chrome/Firefox Extensions, VS Code, JetBrains | — |
199
+ | **Embedded** | ESP32, STM32, ROS/ROS2, Car Infotainment | — |
200
+ | **Cloud** | Docker, Kubernetes, CI/CD (GitHub Actions) | — |
201
+ | **Wearables** | watchOS, Wear OS, Galaxy Watch | — |
202
+
203
+ > Checked = build tested on real projects. — = documentation verified against official sources.
204
+
205
+ ---
206
+
207
+ ## Architecture
208
+
209
+ ```
210
+ skill.md (Main Orchestrator)
211
+
212
+ ├─ Step 1: Project Scan ─────── Detect framework, language, deps, env
213
+
214
+ ├─ Step 2: Intake ───────────── Ask 12 questions (platform, arch, signing...)
215
+ │ ├─ Part A: Project Summary ← scan results displayed
216
+ │ ├─ Part B: Questions ← interactive options with defaults
217
+ │ └─ Part C: Confirmation ← summary table for user approval
218
+
219
+ ├─ Step 3: Analyze & Research ── Combine data + online research if needed
220
+
221
+ ├─ Step 4: Recommend ──────── Best solution + alternatives + reasoning
222
+
223
+ ├─ Step 5: Confirm ───────────── User selects → final build plan
224
+
225
+ ├─ Step 6: Execute ───────────── Load sub-skill → run build commands
226
+ │ ├─ sub-skills/desktop/ Electron, Tauri, Qt, games, VR...
227
+ │ ├─ sub-skills/mobile/ Android, iOS, Flutter, RN, watchOS...
228
+ │ ├─ sub-skills/web/ Vite, Next.js, PWA, WASM...
229
+ │ ├─ sub-skills/backend/ Node, Python, Go, Rust, Java, PHP
230
+ │ ├─ sub-skills/ai/ PyTorch, Ollama, llama.cpp
231
+ │ ├─ sub-skills/cli/ PyInstaller, npm/PyPI publishing
232
+ │ ├─ sub-skills/plugins/ Chrome, VS Code, JetBrains
233
+ │ ├─ sub-skills/embedded/ ESP32, STM32, ROS, car
234
+ │ ├─ sub-skills/security/ Pentest tools, scanners
235
+ │ ├─ sub-skills/cloud/ Docker, K8s, CI/CD
236
+ │ └─ sub-skills/cross-platform/ .NET MAUI, KMP
237
+
238
+ ├─ Step 7: Audit (mandatory) ── Credentials, .env, .map, package check
239
+
240
+ └─ Step 8: Final Report ─────── Build report with all results
241
+ ```
242
+
243
+ ---
244
+
245
+ ## Security Model
246
+
247
+ Packwise enforces security at every stage — no build completes without a clean audit.
248
+
249
+ | Stage | Check |
250
+ |-------|-------|
251
+ | **Pre-build scan** | Detect `.env` files, hardcoded API keys, secrets in source |
252
+ | **Build execution** | Delete source maps, exclude `.env` from package, clean test data |
253
+ | **Post-build audit** | Verify no credentials, `.map` files, or `.env` in final package |
254
+ | **Network check** | Optional: verify no unexpected outbound connections |
255
+
256
+ ---
257
+
258
+ ## What's Inside
259
+
260
+ ### 44 Sub-Skills Every Major Platform Covered
261
+
262
+ Each sub-skill contains:
263
+ - **Version-verified** build commands (checked against official registries)
264
+ - **Step-by-step** packaging workflows with copy-paste examples
265
+ - **Common pitfalls** table with solutions (from real build testing)
266
+ - **CI/CD** configuration templates (GitHub Actions, GitLab CI)
267
+ - **Security** best practices specific to the platform
268
+
269
+ ### Tested Framework Versions
270
+
271
+ | Framework | Version | Verified |
272
+ |-----------|:-------:|:--------:|
273
+ | Electron | 43.x | ✅ |
274
+ | Tauri | 2.11.x | ✅ |
275
+ | Vite | 8.1.3 | ✅ |
276
+ | Next.js | 16.2.10 | ✅ |
277
+ | Node.js | 26 LTS | ✅ |
278
+ | Python | 3.12 | ✅ |
279
+ | Rust | 1.96 | ✅ |
280
+ | Java | 21 LTS | ✅ |
281
+ | React Native | 0.86.x | — |
282
+ | Flutter | 3.44.x | — |
283
+ | Capacitor | 8.x | — |
284
+ | Go | 1.26 | |
285
+
286
+ ---
287
+
288
+ ## Contributing
289
+
290
+ Contributions are welcome. Before submitting, please:
291
+
292
+ 1. Write all instructions in **English** only
293
+ 2. Verify framework versions against **official registries** (npm, PyPI, GitHub Releases)
294
+ 3. Include a **Common Pitfalls** table in every new sub-skill
295
+ 4. Test build commands when possible
296
+ 5. Never commit secrets, API keys, or credentials
297
+
298
+ ```bash
299
+ git clone https://github.com/YOUR_USER/packwise-skills.git
300
+ cd packwise-skills
301
+ git checkout -b feat/my-improvement
302
+ # edit skill.md or sub-skills/
303
+ git commit -m "feat: add [framework] support"
304
+ git push origin feat/my-improvement
305
+ # open a PR against main
306
+ ```
307
+
308
+ ---
309
+
310
+ ## License
311
+
312
+ <div align="center">
313
+
314
+ [![License: MIT](https://img.shields.io/badge/License-MIT-blue?style=flat-square&logo=github)](https://opensource.org/licenses/MIT)
315
+
316
+ This project is licensed under the [MIT License](LICENSE).
317
+
318
+ </div>
319
+
320
+ ---
321
+
322
+ <div align="center">
323
+ Built with care for the AI-assisted development community.
324
+ <br><br>
325
+ <a href="https://github.com/Thomas520TOM/packwise-skills">GitHub</a> · <a href="https://github.com/Thomas520TOM/packwise-skills/issues">Issues</a> · <a href="https://github.com/Thomas520TOM/packwise-skills/blob/main/INSTALL.md">Install Guide</a>
326
+ <br>
327
+ </div>