@hasna/skills 0.1.61 → 0.1.63

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 (523) hide show
  1. package/README.md +10 -6
  2. package/bin/index.js +14271 -21602
  3. package/bin/mcp.js +3527 -11449
  4. package/bin/migrate.js +53 -3
  5. package/bin/server.js +5140 -2675
  6. package/bin/worker.js +4542 -2129
  7. package/dist/cli/commands/publish.d.ts +2 -0
  8. package/dist/cli/components/App.d.ts +2 -1
  9. package/dist/cli/components/CategorySelect.d.ts +2 -1
  10. package/dist/cli/components/Header.d.ts +2 -1
  11. package/dist/cli/components/InstallProgress.d.ts +2 -1
  12. package/dist/cli/components/SearchView.d.ts +2 -1
  13. package/dist/cli/components/SkillSelect.d.ts +2 -1
  14. package/dist/index.d.ts +4 -1
  15. package/dist/index.js +5094 -13755
  16. package/dist/lib/agent-sync.d.ts +38 -3
  17. package/dist/lib/home-adoption.d.ts +91 -0
  18. package/dist/lib/home-census.d.ts +22 -0
  19. package/dist/lib/home-migration.d.ts +61 -0
  20. package/dist/lib/portable-skills-files.d.ts +21 -1
  21. package/dist/lib/portable-skills-types.d.ts +46 -0
  22. package/dist/lib/pull.d.ts +66 -0
  23. package/dist/lib/remote-client.d.ts +6 -0
  24. package/dist/lib/run-state.d.ts +5 -0
  25. package/dist/lib/skill-bundles.d.ts +54 -0
  26. package/dist/lib/skill-contract.d.ts +35 -0
  27. package/dist/lib/skill-hash.d.ts +77 -0
  28. package/dist/sdk/cancel.d.ts +30 -0
  29. package/dist/sdk/dispatcher.d.ts +40 -0
  30. package/dist/sdk/event-sink.d.ts +2 -0
  31. package/dist/sdk/events.d.ts +79 -0
  32. package/dist/sdk/execution/admission.d.ts +44 -0
  33. package/dist/sdk/execution/dispatchers/e2b.d.ts +17 -0
  34. package/dist/sdk/execution/dispatchers/ecs.d.ts +151 -0
  35. package/dist/sdk/execution/image-profile.d.ts +73 -0
  36. package/dist/sdk/execution/index.d.ts +15 -0
  37. package/dist/sdk/execution/receipts.d.ts +44 -0
  38. package/dist/sdk/execution/state-machine.d.ts +38 -0
  39. package/dist/sdk/execution/storage.d.ts +158 -0
  40. package/dist/sdk/execution/types.d.ts +130 -0
  41. package/dist/sdk/executor.d.ts +17 -0
  42. package/dist/sdk/governance-store.d.ts +156 -0
  43. package/dist/sdk/governance.d.ts +92 -0
  44. package/dist/sdk/index.d.ts +26 -0
  45. package/dist/sdk/index.js +48730 -0
  46. package/dist/sdk/offline.d.ts +16 -0
  47. package/dist/sdk/outputs.d.ts +71 -0
  48. package/dist/sdk/registry.d.ts +28 -0
  49. package/dist/sdk/runs.d.ts +229 -0
  50. package/dist/sdk/server.d.ts +35 -0
  51. package/dist/sdk/spend.d.ts +36 -0
  52. package/dist/sdk/storage.d.ts +25 -0
  53. package/dist/server/app.d.ts +42 -0
  54. package/dist/server/artifact-storage.d.ts +102 -0
  55. package/dist/server/auth.d.ts +5 -0
  56. package/dist/server/config.d.ts +40 -0
  57. package/dist/server/database-url.d.ts +42 -0
  58. package/dist/server/handlers.d.ts +3 -0
  59. package/dist/server/index.d.ts +2 -0
  60. package/dist/server/migrate.d.ts +13 -0
  61. package/dist/server/migrations-dir.d.ts +18 -0
  62. package/dist/server/redaction.d.ts +1 -0
  63. package/dist/server/registry.d.ts +5 -0
  64. package/dist/server/rows.d.ts +23 -0
  65. package/dist/server/skills-api.d.ts +68 -0
  66. package/dist/server/sqlite-store.d.ts +114 -0
  67. package/dist/server/store-fixtures.d.ts +25 -0
  68. package/dist/server/store.d.ts +144 -0
  69. package/dist/server/types.d.ts +242 -0
  70. package/dist/server/worker.d.ts +4 -0
  71. package/dist/storage.js +32 -0
  72. package/docs/skill-standard.md +211 -39
  73. package/migrations/postgres/0003_run_outputs_governance.sql +83 -0
  74. package/migrations/sqlite/0003_run_outputs_governance.sql +58 -0
  75. package/package.json +11 -8
  76. package/schemas/skill.schema.json +181 -0
  77. package/agent-skills/README.md +0 -41
  78. package/agent-skills/fleet-package-rollout/SKILL.md +0 -169
  79. package/agent-skills/inbox/SKILL.md +0 -25
  80. package/agent-skills/inbox/scripts/inbox +0 -109
  81. package/agent-skills/inbox/tests/test_registered_sender_id.sh +0 -92
  82. package/agent-skills/inbox-monitor/SKILL.md +0 -41
  83. package/agent-skills/inbox-monitor/scripts/inbox_monitor.sh +0 -91
  84. package/agent-skills/inbox-monitor/scripts/test_inbox_monitor.sh +0 -71
  85. package/agent-skills/merge-pr/SKILL.md +0 -85
  86. package/agent-skills/merge-pr/references/merge-safety.md +0 -82
  87. package/agent-skills/merge-pr/scripts/merge_pr_guard.py +0 -694
  88. package/agent-skills/merge-pr/scripts/test_merge_pr_guard.py +0 -647
  89. package/agent-skills/merge-pr/tests/fixtures/multi-commit-synthesized.json +0 -28
  90. package/agent-skills/merge-pr/tests/fixtures/trailer-free-provider.json +0 -28
  91. package/agent-skills/skill-goal-execute/SKILL.md +0 -115
  92. package/agent-skills/skill-login/SKILL.md +0 -109
  93. package/agent-skills/skill-project-create/SKILL.md +0 -91
  94. package/agent-skills/skill-publish/SKILL.md +0 -207
  95. package/skills/_common/auth.ts +0 -45
  96. package/skills/_common/http-client.ts +0 -143
  97. package/skills/_common/index.ts +0 -26
  98. package/skills/_common/install.sh +0 -7
  99. package/skills/_common/installer.ts +0 -72
  100. package/skills/_common/skill-install.ts +0 -37
  101. package/skills/_common/vision.ts +0 -374
  102. package/skills/ad-creative-pack/SKILL.md +0 -55
  103. package/skills/ad-creative-pack/package.json +0 -10
  104. package/skills/analyze-data/CLAUDE.md +0 -16
  105. package/skills/analyze-data/SKILL.md +0 -112
  106. package/skills/analyze-data/package.json +0 -23
  107. package/skills/analyze-data/src/analysis.ts +0 -401
  108. package/skills/analyze-data/src/cli.ts +0 -66
  109. package/skills/analyze-data/src/formatters.ts +0 -235
  110. package/skills/analyze-data/src/index.ts +0 -74
  111. package/skills/analyze-data/src/logger.ts +0 -36
  112. package/skills/analyze-data/src/parsers.ts +0 -57
  113. package/skills/analyze-data/src/stats.ts +0 -151
  114. package/skills/analyze-data/src/types.ts +0 -85
  115. package/skills/analyze-data/tsconfig.json +0 -19
  116. package/skills/api-docs-portal/SKILL.md +0 -84
  117. package/skills/api-docs-portal/package.json +0 -35
  118. package/skills/api-docs-portal/src/index.ts +0 -919
  119. package/skills/api-docs-portal/tsconfig.json +0 -17
  120. package/skills/api-test-suite/CLAUDE.md +0 -19
  121. package/skills/api-test-suite/package.json +0 -27
  122. package/skills/api-test-suite/src/index.ts +0 -381
  123. package/skills/api-test-suite/tsconfig.json +0 -10
  124. package/skills/audio-extract/CLAUDE.md +0 -9
  125. package/skills/audio-extract/SKILL.md +0 -73
  126. package/skills/audio-extract/package.json +0 -23
  127. package/skills/audio-extract/src/index.ts +0 -323
  128. package/skills/audio-extract/tsconfig.json +0 -11
  129. package/skills/bio-sequence-tool/CLAUDE.md +0 -19
  130. package/skills/bio-sequence-tool/package.json +0 -27
  131. package/skills/bio-sequence-tool/src/index.ts +0 -85
  132. package/skills/bio-sequence-tool/tsconfig.json +0 -10
  133. package/skills/blog-article/CLAUDE.md +0 -12
  134. package/skills/blog-article/SKILL.md +0 -55
  135. package/skills/blog-article/package.json +0 -10
  136. package/skills/blog-article/tsconfig.json +0 -10
  137. package/skills/brand-assets/SKILL.md +0 -118
  138. package/skills/brand-assets/package.json +0 -35
  139. package/skills/brand-assets/src/cli.ts +0 -155
  140. package/skills/brand-assets/src/constants.ts +0 -8
  141. package/skills/brand-assets/src/extract.ts +0 -236
  142. package/skills/brand-assets/src/index.ts +0 -668
  143. package/skills/brand-assets/src/types.ts +0 -59
  144. package/skills/brand-assets/tsconfig.json +0 -17
  145. package/skills/brand-kit/SKILL.md +0 -54
  146. package/skills/brand-kit/package.json +0 -10
  147. package/skills/businessactivity/CLAUDE.md +0 -176
  148. package/skills/businessactivity/LICENSE +0 -192
  149. package/skills/businessactivity/README.md +0 -287
  150. package/skills/businessactivity/package.json +0 -25
  151. package/skills/businessactivity/scripts/publish.ts +0 -210
  152. package/skills/businessactivity/src/commands/activity.ts +0 -211
  153. package/skills/businessactivity/src/commands/function.ts +0 -227
  154. package/skills/businessactivity/src/commands/owner.ts +0 -193
  155. package/skills/businessactivity/src/commands/profile.ts +0 -121
  156. package/skills/businessactivity/src/commands/responsibility.ts +0 -264
  157. package/skills/businessactivity/src/commands/team.ts +0 -244
  158. package/skills/businessactivity/src/commands/workflow.ts +0 -359
  159. package/skills/businessactivity/src/index.ts +0 -3
  160. package/skills/businessactivity/src/lib/config.ts +0 -167
  161. package/skills/businessactivity/src/lib/output.ts +0 -76
  162. package/skills/businessactivity/src/lib/paths.ts +0 -79
  163. package/skills/businessactivity/src/lib/storage.ts +0 -95
  164. package/skills/businessactivity/src/types/index.ts +0 -86
  165. package/skills/businessactivity/tsconfig.json +0 -29
  166. package/skills/codefix/LICENSE +0 -192
  167. package/skills/codefix/README.md +0 -232
  168. package/skills/codefix/SKILL.md +0 -94
  169. package/skills/codefix/package.json +0 -21
  170. package/skills/codefix/src/fixers/batch.ts +0 -213
  171. package/skills/codefix/src/fixers/detector.ts +0 -160
  172. package/skills/codefix/src/fixers/index.ts +0 -7
  173. package/skills/codefix/src/fixers/runner.ts +0 -522
  174. package/skills/codefix/src/index-local.ts +0 -431
  175. package/skills/codefix/src/index.ts +0 -4
  176. package/skills/codefix/src/types.ts +0 -211
  177. package/skills/codefix/tsconfig.json +0 -15
  178. package/skills/commitpush/SKILL.md +0 -57
  179. package/skills/commitpush/package.json +0 -33
  180. package/skills/commitpush/src/index.ts +0 -34
  181. package/skills/commitpush/tsconfig.json +0 -17
  182. package/skills/commitpushpr/SKILL.md +0 -55
  183. package/skills/commitpushpr/package.json +0 -33
  184. package/skills/commitpushpr/src/index.ts +0 -34
  185. package/skills/commitpushpr/tsconfig.json +0 -17
  186. package/skills/compress-video/CLAUDE.md +0 -9
  187. package/skills/compress-video/SKILL.md +0 -79
  188. package/skills/compress-video/package.json +0 -23
  189. package/skills/compress-video/src/index.ts +0 -473
  190. package/skills/compress-video/tsconfig.json +0 -11
  191. package/skills/contract-review-report/SKILL.md +0 -52
  192. package/skills/contract-review-report/package.json +0 -10
  193. package/skills/customer-feedback-report/SKILL.md +0 -52
  194. package/skills/customer-feedback-report/package.json +0 -10
  195. package/skills/dashboard-builder/CLAUDE.md +0 -19
  196. package/skills/dashboard-builder/package.json +0 -29
  197. package/skills/dashboard-builder/src/index.ts +0 -150
  198. package/skills/dashboard-builder/tsconfig.json +0 -10
  199. package/skills/data-anonymizer/CLAUDE.md +0 -19
  200. package/skills/data-anonymizer/package.json +0 -27
  201. package/skills/data-anonymizer/src/index.ts +0 -183
  202. package/skills/data-anonymizer/tsconfig.json +0 -10
  203. package/skills/database-explorer/CLAUDE.md +0 -19
  204. package/skills/database-explorer/package.json +0 -29
  205. package/skills/database-explorer/src/index.ts +0 -95
  206. package/skills/database-explorer/tsconfig.json +0 -10
  207. package/skills/diff-viewer/CLAUDE.md +0 -19
  208. package/skills/diff-viewer/package.json +0 -30
  209. package/skills/diff-viewer/src/index.ts +0 -164
  210. package/skills/diff-viewer/tsconfig.json +0 -10
  211. package/skills/doc-read/SKILL.md +0 -45
  212. package/skills/doc-read/package.json +0 -29
  213. package/skills/doc-read/src/index.ts +0 -324
  214. package/skills/doc-read/tsconfig.json +0 -8
  215. package/skills/domainpurchase/LICENSE +0 -192
  216. package/skills/domainpurchase/SKILL.md +0 -29
  217. package/skills/domainpurchase/package.json +0 -30
  218. package/skills/domainpurchase/src/index.ts +0 -3
  219. package/skills/domainpurchase/tsconfig.json +0 -21
  220. package/skills/email-sequence/SKILL.md +0 -53
  221. package/skills/email-sequence/package.json +0 -10
  222. package/skills/experiment-power-calculator/CLAUDE.md +0 -19
  223. package/skills/experiment-power-calculator/package.json +0 -29
  224. package/skills/experiment-power-calculator/src/index.ts +0 -86
  225. package/skills/experiment-power-calculator/tsconfig.json +0 -10
  226. package/skills/extract-frames/CLAUDE.md +0 -19
  227. package/skills/extract-frames/package.json +0 -27
  228. package/skills/extract-frames/src/index.ts +0 -616
  229. package/skills/extract-frames/tsconfig.json +0 -10
  230. package/skills/file-organizer/CLAUDE.md +0 -19
  231. package/skills/file-organizer/package.json +0 -27
  232. package/skills/file-organizer/src/index.ts +0 -91
  233. package/skills/file-organizer/tsconfig.json +0 -10
  234. package/skills/folder-tree/CLAUDE.md +0 -19
  235. package/skills/folder-tree/package.json +0 -29
  236. package/skills/folder-tree/src/index.ts +0 -568
  237. package/skills/folder-tree/tsconfig.json +0 -10
  238. package/skills/form-filler/CLAUDE.md +0 -19
  239. package/skills/form-filler/package.json +0 -29
  240. package/skills/form-filler/src/index.ts +0 -81
  241. package/skills/form-filler/tsconfig.json +0 -10
  242. package/skills/generate-api-client/CLAUDE.md +0 -19
  243. package/skills/generate-api-client/package.json +0 -29
  244. package/skills/generate-api-client/src/generator.ts +0 -47
  245. package/skills/generate-api-client/src/index.ts +0 -92
  246. package/skills/generate-api-client/src/logger.ts +0 -34
  247. package/skills/generate-api-client/src/python-generator.ts +0 -245
  248. package/skills/generate-api-client/src/spec-loader.ts +0 -48
  249. package/skills/generate-api-client/src/type-mappers.ts +0 -79
  250. package/skills/generate-api-client/src/types.ts +0 -76
  251. package/skills/generate-api-client/src/typescript-generator.ts +0 -247
  252. package/skills/generate-api-client/tsconfig.json +0 -10
  253. package/skills/generate-chart/CLAUDE.md +0 -19
  254. package/skills/generate-chart/package.json +0 -27
  255. package/skills/generate-chart/src/index.ts +0 -510
  256. package/skills/generate-chart/tsconfig.json +0 -10
  257. package/skills/generate-dockerfile/CLAUDE.md +0 -19
  258. package/skills/generate-dockerfile/package.json +0 -27
  259. package/skills/generate-dockerfile/src/cli.ts +0 -78
  260. package/skills/generate-dockerfile/src/dockerfile-templates.ts +0 -392
  261. package/skills/generate-dockerfile/src/index.ts +0 -81
  262. package/skills/generate-dockerfile/src/logger.ts +0 -30
  263. package/skills/generate-dockerfile/src/project-detection.ts +0 -68
  264. package/skills/generate-dockerfile/src/support-files.ts +0 -171
  265. package/skills/generate-dockerfile/src/types.ts +0 -29
  266. package/skills/generate-dockerfile/tsconfig.json +0 -10
  267. package/skills/generate-env/CLAUDE.md +0 -19
  268. package/skills/generate-env/package.json +0 -29
  269. package/skills/generate-env/src/cli.ts +0 -85
  270. package/skills/generate-env/src/detection.ts +0 -161
  271. package/skills/generate-env/src/env-data.ts +0 -66
  272. package/skills/generate-env/src/generators.ts +0 -240
  273. package/skills/generate-env/src/index.ts +0 -120
  274. package/skills/generate-env/src/runtime.ts +0 -30
  275. package/skills/generate-env/src/types.ts +0 -32
  276. package/skills/generate-env/tsconfig.json +0 -10
  277. package/skills/generate-favicon/CLAUDE.md +0 -19
  278. package/skills/generate-favicon/package.json +0 -29
  279. package/skills/generate-favicon/src/index.ts +0 -421
  280. package/skills/generate-favicon/tsconfig.json +0 -10
  281. package/skills/generate-qrcode/CLAUDE.md +0 -19
  282. package/skills/generate-qrcode/package.json +0 -30
  283. package/skills/generate-qrcode/src/index.ts +0 -584
  284. package/skills/generate-qrcode/tsconfig.json +0 -10
  285. package/skills/generate-resume/CLAUDE.md +0 -19
  286. package/skills/generate-resume/package.json +0 -27
  287. package/skills/generate-resume/src/cli.ts +0 -157
  288. package/skills/generate-resume/src/index.ts +0 -178
  289. package/skills/generate-resume/src/parsers.ts +0 -95
  290. package/skills/generate-resume/src/renderers.ts +0 -538
  291. package/skills/generate-resume/src/security.ts +0 -39
  292. package/skills/generate-resume/src/types.ts +0 -86
  293. package/skills/generate-resume/tsconfig.json +0 -10
  294. package/skills/generate-sitemap/CLAUDE.md +0 -19
  295. package/skills/generate-sitemap/package.json +0 -27
  296. package/skills/generate-sitemap/src/index.ts +0 -626
  297. package/skills/generate-sitemap/tsconfig.json +0 -10
  298. package/skills/gif-maker/CLAUDE.md +0 -19
  299. package/skills/gif-maker/package.json +0 -30
  300. package/skills/gif-maker/src/index.ts +0 -600
  301. package/skills/gif-maker/tsconfig.json +0 -10
  302. package/skills/hook/LICENSE +0 -192
  303. package/skills/hook/README.md +0 -74
  304. package/skills/hook/SKILL.md +0 -85
  305. package/skills/hook/bunfig.toml +0 -5
  306. package/skills/hook/package.json +0 -28
  307. package/skills/hook/src/commands/create.ts +0 -112
  308. package/skills/hook/src/commands/events.ts +0 -37
  309. package/skills/hook/src/commands/validate.ts +0 -117
  310. package/skills/hook/src/index.ts +0 -118
  311. package/skills/hook/src/templates/root.ts +0 -196
  312. package/skills/hook/src/templates/source.ts +0 -647
  313. package/skills/hook/tsconfig.json +0 -18
  314. package/skills/http-server/CLAUDE.md +0 -19
  315. package/skills/http-server/package.json +0 -29
  316. package/skills/http-server/src/index.ts +0 -51
  317. package/skills/http-server/tsconfig.json +0 -10
  318. package/skills/implementation/LICENSE +0 -192
  319. package/skills/implementation/README.md +0 -53
  320. package/skills/implementation/SKILL.md +0 -57
  321. package/skills/implementation/bunfig.toml +0 -5
  322. package/skills/implementation/package.json +0 -28
  323. package/skills/implementation/src/commands/create.ts +0 -187
  324. package/skills/implementation/src/index.ts +0 -62
  325. package/skills/implementation/tsconfig.json +0 -18
  326. package/skills/implementation-plan/CLAUDE.md +0 -19
  327. package/skills/implementation-plan/package.json +0 -29
  328. package/skills/implementation-plan/src/index.ts +0 -520
  329. package/skills/implementation-plan/tsconfig.json +0 -10
  330. package/skills/implementation-todo/CLAUDE.md +0 -19
  331. package/skills/implementation-todo/package.json +0 -29
  332. package/skills/implementation-todo/src/index.ts +0 -429
  333. package/skills/implementation-todo/tsconfig.json +0 -10
  334. package/skills/invoice/.env.example +0 -3
  335. package/skills/invoice/CLAUDE.md +0 -31
  336. package/skills/invoice/LICENSE +0 -192
  337. package/skills/invoice/README.md +0 -70
  338. package/skills/invoice/package.json +0 -26
  339. package/skills/invoice/src/commands/companies.ts +0 -202
  340. package/skills/invoice/src/commands/config.ts +0 -132
  341. package/skills/invoice/src/commands/generate.ts +0 -177
  342. package/skills/invoice/src/commands/invoices.ts +0 -218
  343. package/skills/invoice/src/index.ts +0 -3
  344. package/skills/invoice/src/lib/api.ts +0 -124
  345. package/skills/invoice/src/lib/storage.ts +0 -171
  346. package/skills/invoice/src/types/index.ts +0 -86
  347. package/skills/invoice/src/utils/logger.ts +0 -33
  348. package/skills/invoice/src/utils/paths.ts +0 -25
  349. package/skills/invoice/tsconfig.json +0 -23
  350. package/skills/invoice-reconciliation/SKILL.md +0 -98
  351. package/skills/invoice-reconciliation/package.json +0 -36
  352. package/skills/invoice-reconciliation/src/index.ts +0 -743
  353. package/skills/invoice-reconciliation/tsconfig.json +0 -17
  354. package/skills/landing-page-pack/SKILL.md +0 -55
  355. package/skills/landing-page-pack/package.json +0 -10
  356. package/skills/latex-table-generator/CLAUDE.md +0 -19
  357. package/skills/latex-table-generator/package.json +0 -29
  358. package/skills/latex-table-generator/src/index.ts +0 -113
  359. package/skills/latex-table-generator/tsconfig.json +0 -10
  360. package/skills/logo-design/SKILL.md +0 -94
  361. package/skills/logo-design/package.json +0 -35
  362. package/skills/logo-design/src/cli.ts +0 -132
  363. package/skills/logo-design/src/constants.ts +0 -5
  364. package/skills/logo-design/src/docs.ts +0 -102
  365. package/skills/logo-design/src/geometry.ts +0 -324
  366. package/skills/logo-design/src/index.ts +0 -212
  367. package/skills/logo-design/src/palette.ts +0 -258
  368. package/skills/logo-design/src/types.ts +0 -50
  369. package/skills/logo-design/tsconfig.json +0 -17
  370. package/skills/lorem-generator/CLAUDE.md +0 -19
  371. package/skills/lorem-generator/package.json +0 -29
  372. package/skills/lorem-generator/src/index.ts +0 -59
  373. package/skills/lorem-generator/tsconfig.json +0 -10
  374. package/skills/managemcp/CLAUDE.md +0 -14
  375. package/skills/managemcp/README.md +0 -24
  376. package/skills/managemcp/package.json +0 -16
  377. package/skills/managemcp/src/index.ts +0 -3
  378. package/skills/managemcp/tsconfig.json +0 -27
  379. package/skills/markdown-validator/CLAUDE.md +0 -19
  380. package/skills/markdown-validator/package.json +0 -29
  381. package/skills/markdown-validator/src/index.ts +0 -92
  382. package/skills/markdown-validator/tsconfig.json +0 -10
  383. package/skills/market-research-report/SKILL.md +0 -51
  384. package/skills/market-research-report/package.json +0 -10
  385. package/skills/meeting-pack/SKILL.md +0 -52
  386. package/skills/meeting-pack/package.json +0 -10
  387. package/skills/merge-pdfs/CLAUDE.md +0 -19
  388. package/skills/merge-pdfs/package.json +0 -31
  389. package/skills/merge-pdfs/src/index.ts +0 -427
  390. package/skills/merge-pdfs/tsconfig.json +0 -10
  391. package/skills/migration-plan-pack/SKILL.md +0 -56
  392. package/skills/migration-plan-pack/package.json +0 -10
  393. package/skills/monitor/SKILL.md +0 -69
  394. package/skills/monitor/package.json +0 -33
  395. package/skills/monitor/src/index.ts +0 -34
  396. package/skills/monitor/tsconfig.json +0 -17
  397. package/skills/one-page-website/SKILL.md +0 -128
  398. package/skills/one-page-website/package.json +0 -34
  399. package/skills/one-page-website/src/design.ts +0 -336
  400. package/skills/one-page-website/src/docs.ts +0 -159
  401. package/skills/one-page-website/src/index.ts +0 -357
  402. package/skills/one-page-website/src/page.ts +0 -340
  403. package/skills/one-page-website/src/styles.ts +0 -508
  404. package/skills/one-page-website/src/types.ts +0 -78
  405. package/skills/one-page-website/tsconfig.json +0 -17
  406. package/skills/pdf-generate/CLAUDE.md +0 -19
  407. package/skills/pdf-generate/SKILL.md +0 -86
  408. package/skills/pdf-generate/package.json +0 -21
  409. package/skills/pdf-generate/src/cli.ts +0 -162
  410. package/skills/pdf-generate/src/html.ts +0 -84
  411. package/skills/pdf-generate/src/index.ts +0 -62
  412. package/skills/pdf-generate/src/markdown.ts +0 -27
  413. package/skills/pdf-generate/src/pdf-writer.ts +0 -78
  414. package/skills/pdf-generate/src/runtime.ts +0 -34
  415. package/skills/pdf-generate/src/security.ts +0 -37
  416. package/skills/pdf-generate/src/templates.ts +0 -311
  417. package/skills/pdf-generate/src/types.ts +0 -28
  418. package/skills/pdf-generate/tsconfig.json +0 -16
  419. package/skills/pdf-to-dataset/SKILL.md +0 -88
  420. package/skills/pdf-to-dataset/package.json +0 -37
  421. package/skills/pdf-to-dataset/src/index.ts +0 -790
  422. package/skills/pdf-to-dataset/tsconfig.json +0 -17
  423. package/skills/pdf-to-markdown/SKILL.md +0 -81
  424. package/skills/pdf-to-markdown/package.json +0 -35
  425. package/skills/pdf-to-markdown/src/index.ts +0 -694
  426. package/skills/pdf-to-markdown/tsconfig.json +0 -17
  427. package/skills/performance-audit-report/SKILL.md +0 -49
  428. package/skills/performance-audit-report/package.json +0 -10
  429. package/skills/pitch-deck/SKILL.md +0 -51
  430. package/skills/pitch-deck/package.json +0 -10
  431. package/skills/product-mockup/SKILL.md +0 -107
  432. package/skills/product-mockup/package.json +0 -32
  433. package/skills/product-mockup/src/cli.ts +0 -150
  434. package/skills/product-mockup/src/design.ts +0 -151
  435. package/skills/product-mockup/src/docs.ts +0 -134
  436. package/skills/product-mockup/src/index.ts +0 -182
  437. package/skills/product-mockup/src/render.ts +0 -407
  438. package/skills/product-mockup/src/types.ts +0 -66
  439. package/skills/product-mockup/tsconfig.json +0 -17
  440. package/skills/proposal-pack/SKILL.md +0 -53
  441. package/skills/proposal-pack/package.json +0 -10
  442. package/skills/read-csv/SKILL.md +0 -62
  443. package/skills/read-csv/package.json +0 -37
  444. package/skills/read-csv/src/index.ts +0 -356
  445. package/skills/read-csv/tsconfig.json +0 -17
  446. package/skills/read-excel/SKILL.md +0 -64
  447. package/skills/read-excel/package.json +0 -36
  448. package/skills/read-excel/src/index.ts +0 -266
  449. package/skills/read-excel/tsconfig.json +0 -17
  450. package/skills/regex-tester/CLAUDE.md +0 -19
  451. package/skills/regex-tester/package.json +0 -27
  452. package/skills/regex-tester/src/index.ts +0 -183
  453. package/skills/regex-tester/tsconfig.json +0 -10
  454. package/skills/repo-onboarding-report/SKILL.md +0 -52
  455. package/skills/repo-onboarding-report/package.json +0 -10
  456. package/skills/scancommitpr/SKILL.md +0 -178
  457. package/skills/scancommitpr/package.json +0 -34
  458. package/skills/scancommitpr/src/index.ts +0 -44
  459. package/skills/scancommitpr/tsconfig.json +0 -13
  460. package/skills/scancommitpush/SKILL.md +0 -174
  461. package/skills/scancommitpush/package.json +0 -32
  462. package/skills/scancommitpush/src/index.ts +0 -44
  463. package/skills/scancommitpush/tsconfig.json +0 -13
  464. package/skills/scientific-figure-check/CLAUDE.md +0 -19
  465. package/skills/scientific-figure-check/package.json +0 -29
  466. package/skills/scientific-figure-check/src/index.ts +0 -83
  467. package/skills/scientific-figure-check/tsconfig.json +0 -10
  468. package/skills/security-audit/CLAUDE.md +0 -19
  469. package/skills/security-audit/package.json +0 -27
  470. package/skills/security-audit/src/index.ts +0 -145
  471. package/skills/security-audit/tsconfig.json +0 -10
  472. package/skills/security-audit-report/SKILL.md +0 -52
  473. package/skills/security-audit-report/package.json +0 -10
  474. package/skills/seo-content-pack/SKILL.md +0 -54
  475. package/skills/seo-content-pack/package.json +0 -10
  476. package/skills/siteanalyze/SKILL.md +0 -25
  477. package/skills/siteanalyze/package.json +0 -27
  478. package/skills/siteanalyze/src/index.ts +0 -592
  479. package/skills/slide-deck-generator/SKILL.md +0 -93
  480. package/skills/slide-deck-generator/package.json +0 -38
  481. package/skills/slide-deck-generator/src/cli.ts +0 -133
  482. package/skills/slide-deck-generator/src/index.ts +0 -148
  483. package/skills/slide-deck-generator/src/model.ts +0 -307
  484. package/skills/slide-deck-generator/src/pptx.ts +0 -143
  485. package/skills/slide-deck-generator/src/render.ts +0 -248
  486. package/skills/slide-deck-generator/src/types.ts +0 -114
  487. package/skills/slide-deck-generator/src/utils.ts +0 -53
  488. package/skills/slide-deck-generator/tsconfig.json +0 -17
  489. package/skills/social-content-calendar/SKILL.md +0 -54
  490. package/skills/social-content-calendar/package.json +0 -10
  491. package/skills/split-pdf/CLAUDE.md +0 -19
  492. package/skills/split-pdf/package.json +0 -30
  493. package/skills/split-pdf/src/index.ts +0 -301
  494. package/skills/split-pdf/tsconfig.json +0 -10
  495. package/skills/statistical-test-selector/CLAUDE.md +0 -19
  496. package/skills/statistical-test-selector/package.json +0 -27
  497. package/skills/statistical-test-selector/src/index.ts +0 -75
  498. package/skills/statistical-test-selector/tsconfig.json +0 -10
  499. package/skills/test-suite-generator/SKILL.md +0 -51
  500. package/skills/test-suite-generator/package.json +0 -10
  501. package/skills/tmux-session/SKILL.md +0 -109
  502. package/skills/tmux-session/package.json +0 -33
  503. package/skills/tmux-session/src/index.ts +0 -34
  504. package/skills/tmux-session/tsconfig.json +0 -17
  505. package/skills/todos-plan/SKILL.md +0 -363
  506. package/skills/todos-plan/agents/openai.yaml +0 -4
  507. package/skills/todos-plan/package.json +0 -9
  508. package/skills/todos-plan/src/index.ts +0 -68
  509. package/skills/tsconfig.base.json +0 -12
  510. package/skills/validate-config/CLAUDE.md +0 -19
  511. package/skills/validate-config/package.json +0 -29
  512. package/skills/validate-config/src/index.ts +0 -56
  513. package/skills/validate-config/tsconfig.json +0 -10
  514. package/skills/video-downloader/CLAUDE.md +0 -19
  515. package/skills/video-downloader/package.json +0 -29
  516. package/skills/video-downloader/src/index.ts +0 -561
  517. package/skills/video-downloader/tsconfig.json +0 -10
  518. package/skills/video-highlight-pack/SKILL.md +0 -54
  519. package/skills/video-highlight-pack/package.json +0 -10
  520. package/skills/watermark/CLAUDE.md +0 -19
  521. package/skills/watermark/package.json +0 -32
  522. package/skills/watermark/src/index.ts +0 -587
  523. package/skills/watermark/tsconfig.json +0 -10
@@ -1,17 +0,0 @@
1
- {
2
- "extends": "../tsconfig.base.json",
3
- "compilerOptions": {
4
- "module": "ESNext",
5
- "outDir": "./dist",
6
- "rootDir": "./src",
7
- "resolveJsonModule": true,
8
- "noEmit": true
9
- },
10
- "include": [
11
- "src/**/*"
12
- ],
13
- "exclude": [
14
- "node_modules",
15
- "dist"
16
- ]
17
- }
@@ -1,55 +0,0 @@
1
- ---
2
- name: landing-page-pack
3
- description: Generate landing page copy, wireframes, CTA maps, experiments, and preview artifacts.
4
- kind: instruction
5
- ---
6
-
7
- # Landing Page Pack
8
-
9
- Generate a conversion-focused landing page package for a product, service, or offer.
10
-
11
- ## Requirements
12
-
13
- None. This is an instruction skill: it is prose an agent follows, so it needs no
14
- credentials, no network access, and no local runtime.
15
-
16
- ## Usage
17
-
18
- Ask an agent for the deliverables below and give it the inputs. Reading this file
19
- IS the invocation; `skills run` refuses instruction skills on purpose.
20
-
21
- ## Inputs
22
-
23
- | Input | Description | Default |
24
- |--------|-------------|---------|
25
- | `product` | Product, service, or campaign brief. Positional text also works. | required |
26
- | `audience` | Primary buyer or user segment. | software teams |
27
- | `offer` | Core offer or promise. | derived from product |
28
- | `goal` | Main conversion goal. | book demos |
29
- | `tone` | `direct`, `premium`, `friendly`, or `technical`. | direct |
30
- | `proof` | Proof points, metrics, or trust signals. | case studies and testimonials |
31
- | `sections` | Comma-separated section names. | hero, problem, solution, proof, faq, cta |
32
-
33
- ## Deliverables
34
-
35
- - `landing-page.md`
36
- - `copy-blocks.json`
37
- - `wireframe.md`
38
- - `preview.html`
39
- - `style-guide.md`
40
- - `cta-map.csv`
41
- - `experiment-plan.md`
42
- - `implementation-notes.md`
43
- - `manifest.json`
44
-
45
- ## Method
46
-
47
- 1. Lead with the offer: who it is for, what changes for them, and why now.
48
- 2. Write the hero before anything else. If the hero does not work, no section
49
- below it will rescue the page.
50
- 3. Order sections by the objections a real buyer raises, in the order they raise
51
- them. Do not follow a template order by default.
52
- 4. Make proof specific — named customers, real numbers, concrete screenshots.
53
- Generic testimonials reduce credibility rather than adding to it.
54
- 5. Keep one primary CTA, repeated; secondary CTAs must be visibly subordinate.
55
- 6. Propose experiments as hypotheses with a metric and a decision rule.
@@ -1,10 +0,0 @@
1
- {
2
- "name": "landing-page-pack",
3
- "version": "0.1.0",
4
- "private": true,
5
- "description": "Hosted premium landing page copy and conversion artifact generator",
6
- "type": "module",
7
- "skills": {
8
- "kind": "instruction"
9
- }
10
- }
@@ -1,19 +0,0 @@
1
- # latex-table-generator
2
-
3
- Latex Table Generator skill.
4
-
5
- ## Tech Stack
6
-
7
- - Runtime: Bun
8
- - Language: TypeScript
9
- - CLI: Commander.js
10
-
11
- ## CLI
12
-
13
- ```bash
14
- latex-table-generator run
15
- ```
16
-
17
- ## Data Directory
18
-
19
- ~/.skill/latex-table-generator/
@@ -1,29 +0,0 @@
1
- {
2
- "name": "latex-table-generator",
3
- "version": "0.1.0",
4
- "description": "Latex Table Generator skill",
5
- "type": "module",
6
- "bin": {
7
- "latex-table-generator": "./src/index.ts"
8
- },
9
- "scripts": {
10
- "dev": "bun run src/index.ts",
11
- "build": "bun build src/index.ts --outdir dist --target node",
12
- "typecheck": "tsc --noEmit"
13
- },
14
- "dependencies": {
15
- "csv-parse": "^5.6.0"
16
- },
17
- "devDependencies": {
18
- "@types/bun": "latest",
19
- "typescript": "^5.7.0"
20
- },
21
- "publishConfig": {
22
- "access": "restricted",
23
- "registry": "https://registry.npmjs.org/"
24
- },
25
- "files": [
26
- "src",
27
- "tsconfig.json"
28
- ]
29
- }
@@ -1,113 +0,0 @@
1
- #!/usr/bin/env bun
2
- import { parseArgs } from "util";
3
- import { readFileSync, existsSync } from "fs";
4
- import { parse } from "csv-parse/sync";
5
-
6
- const { values, positionals } = parseArgs({
7
- args: process.argv.slice(2),
8
- options: {
9
- caption: { type: "string" },
10
- label: { type: "string" },
11
- align: { type: "string" }, // e.g., "lcr"
12
- help: { type: "boolean" },
13
- },
14
- allowPositionals: true,
15
- });
16
-
17
- if (values.help || positionals.length === 0) {
18
- console.log(`
19
- LaTeX Table Generator
20
- Usage: skills run latex-table-generator -- <file> [options]
21
-
22
- Options:
23
- --caption <text> Table caption
24
- --label <text> Table label (e.g., tab:results)
25
- --align <str> Column alignment (e.g., "l|c|r")
26
- `);
27
- process.exit(0);
28
- }
29
-
30
- const filePath = positionals[0];
31
-
32
- if (!existsSync(filePath)) {
33
- console.error(`Error: File not found: ${filePath}`);
34
- process.exit(1);
35
- }
36
-
37
- try {
38
- const content = readFileSync(filePath, "utf-8");
39
- let data: string[][] = [];
40
-
41
- if (filePath.endsWith(".json")) {
42
- const json = JSON.parse(content);
43
- if (Array.isArray(json)) {
44
- // Assume array of objects or array of arrays
45
- if (json.length > 0) {
46
- if (Array.isArray(json[0])) {
47
- data = json;
48
- } else if (typeof json[0] === "object") {
49
- const headers = Object.keys(json[0]);
50
- data = [headers, ...json.map((row: any) => headers.map(h => String(row[h] ?? "")))]
51
- }
52
- }
53
- }
54
- } else {
55
- // Assume CSV
56
- data = parse(content, {
57
- skip_empty_lines: true,
58
- relax_column_count: true,
59
- });
60
- }
61
-
62
- if (data.length === 0) {
63
- console.error("Error: No data found in file.");
64
- process.exit(1);
65
- }
66
-
67
- const numCols = data[0].length;
68
- const align = values.align || "l".repeat(numCols);
69
- const caption = values.caption || "Table Caption";
70
- const label = values.label || `tab:${filePath.split("/").pop()?.replace(".", "_")}`;
71
-
72
- let latex = `\begin{table}[h]
73
- \centering
74
- \caption{${caption}}
75
- \label{${label}}
76
- \begin{tabular}{${align}}
77
- \hline
78
- `;
79
-
80
- // Header
81
- latex += ` ${data[0].map(escapeLatex).join(" & ")} \\
82
- \hline
83
- `;
84
-
85
- // Body
86
- for (let i = 1; i < data.length; i++) {
87
- latex += ` ${data[i].map(escapeLatex).join(" & ")} \\
88
- `;
89
- }
90
-
91
- latex += ` \hline
92
- \end{tabular}
93
- \end{table}`;
94
-
95
- console.log(latex);
96
-
97
- } catch (error) {
98
- console.error("Error processing file:", error);
99
- process.exit(1);
100
- }
101
-
102
- function escapeLatex(str: string): string {
103
- return String(str)
104
- .replace(/&/g, "\\&")
105
- .replace(/%/g, "\\%")
106
- .replace(/\$/g, "\\$")
107
- .replace(/#/g, "\\#")
108
- .replace(/_/g, "\\_")
109
- .replace(/{/g, "\\{")
110
- .replace(/}/g, "\\}")
111
- .replace(/~/g, "\\textasciitilde")
112
- .replace(/\^/g, "\\textasciicircum");
113
- }
@@ -1,10 +0,0 @@
1
- {
2
- "extends": "../tsconfig.base.json",
3
- "compilerOptions": {
4
- "outDir": "dist"
5
- },
6
- "include": [
7
- "src/**/*",
8
- "bin/**/*"
9
- ]
10
- }
@@ -1,94 +0,0 @@
1
- ---
2
- name: logo-design
3
- description: Generate multi-variant geometric logo marks as SVG, with horizontal lockups, concept notes, usage guidelines, and a manifest. Runs entirely offline and deterministically from a text brief.
4
- ---
5
-
6
- # Logo Design
7
-
8
- Compose parametric geometric logo marks locally. The brief, brand name, style,
9
- and palette are hashed into a master seed; every shape, rotation, grid cell, and
10
- color role is derived from that seed. The same inputs always produce
11
- byte-identical SVGs, so a concept you like can be regenerated exactly.
12
-
13
- There is no image model in this skill and no network call. If you want a
14
- generative-art or illustrative mark, use this skill for the geometric system and
15
- hand the written brief in `logo-brief.md` to your own image tool.
16
-
17
- ## Requirements
18
-
19
- - Bun (the skill runs as `bun run src/index.ts`).
20
- - No API keys, no network access, no environment variables.
21
- - Optional: `sharp` for `--png` raster exports. It is declared as an optional
22
- dependency, so `bun install` will try to add it but will not fail without it.
23
- If `sharp` is missing, `--png` prints a clear notice and the SVG outputs are
24
- still written. Install it explicitly with `bun add sharp` in this directory.
25
-
26
- ## Usage
27
-
28
- ```bash
29
- # three concepts with the default palette
30
- skills run logo-design -- --brief "minimal geometric owl mark for a developer tool" --brand "Acme"
31
-
32
- # positional brief, custom hex palette, four variations
33
- skills run logo-design -- "vintage badge for a coffee roaster" --brand "Ember" --palette "#2B1B12,cream,rust" -n 4
34
-
35
- # write somewhere specific and rasterize
36
- skills run logo-design -- --brief "ledger app" --brand "Ledgerly" --output ./out/ledgerly --png --png-size 1024
37
-
38
- # machine-readable summary
39
- skills run logo-design -- --brief "mesh networking" --brand "Relay" --json
40
- ```
41
-
42
- Run it directly from the skill directory with `bun run src/index.ts --help`.
43
-
44
- ## Options
45
-
46
- | Flag | Description | Default |
47
- |------|-------------|---------|
48
- | `--brief <text>`, `-b` | Logo brief. A positional string also works. | required |
49
- | `--brand <name>` | Brand or product name. Drives the monogram and the lockup wordmark. | `Brand` |
50
- | `--style <text>` | Style direction. Recorded in the brief and used as the lockup tagline. | `clean geometric mark` |
51
- | `--palette <list>` | Comma-separated colors. Accepts hex (`#1B2A4A`, `#abc`) and ~35 named colors (`navy`, `rust`, `mint`). Unknown words are hashed into a stable derived hue. | `navy,white,accent` |
52
- | `--variations <1-6>`, `-n` | Number of concepts. | `3` |
53
- | `--output <dir>`, `-o` | Output directory. | `./logo-design` |
54
- | `--background` | Draw a solid backdrop rect inside each SVG. | off (transparent) |
55
- | `--png` | Also rasterize each mark to PNG. Requires `sharp`. | off |
56
- | `--png-size <px>` | PNG width and height. | `512` |
57
- | `--json` | Print the run summary as JSON on stdout. | off |
58
- | `--help` | Show help and exit 0. | |
59
- | `--version` | Print the version. | |
60
-
61
- ## Outputs
62
-
63
- | File | Contents |
64
- |------|----------|
65
- | `vector/logo-NN.svg` | Standalone mark on a 256x256 viewBox, transparent by default, with `<title>`/`<desc>` for accessibility. |
66
- | `vector/logo-NN-lockup.svg` | 720x200 horizontal lockup: mark, wordmark, and the style line as a tagline. |
67
- | `png/logo-NN.png` | Raster export, only when `--png` is set and `sharp` is available. |
68
- | `concepts.json` | Per-variant seed, geometry name, description, palette roles, rationale. |
69
- | `logo-brief.md` | The brief as interpreted, the resolved palette table, and the reproducibility note. |
70
- | `usage-notes.md` | Clear space, minimum sizes, color roles, do / don't. |
71
- | `manifest.json` | Every file written, with byte sizes and the run inputs. |
72
-
73
- ## Geometry system
74
-
75
- Eight parametric constructions are available; the seed shuffles them and the
76
- first `--variations` are used, so no two variants in a package repeat.
77
-
78
- | Construction | What it draws |
79
- |--------------|---------------|
80
- | `monogram` | Brand initials knocked out of a circle, squircle, hexagon, or shield, with an accent underline. |
81
- | `glyph-grid` | 3x3 or 4x4 modular grid of squares, circles, and triangles, mirrored across the vertical axis. |
82
- | `orbit` | Open ring with a seeded aperture, an accent core, and a satellite dot on the ring path. |
83
- | `chevron-stack` | Three to four nested chevrons reading as motion or ascent. |
84
- | `prism` | Two rotated equilateral triangles with a translucent intersection. |
85
- | `aperture` | Five to seven rotating blades around a hollow center. |
86
- | `layer-stack` | Three sheared parallelograms reading as stacked planes. |
87
- | `arc-mark` | Alternating half-arcs of even stroke weight. |
88
-
89
- ## Notes on picking a direction
90
-
91
- 1. Judge the mark at 16 px first. Open `vector/logo-01.svg` in a browser and zoom out.
92
- 2. Keep the mark and the wordmark separable — the lockup is a convenience, not the identity.
93
- 3. Change one input at a time (`--palette`, then `--style`) so you can attribute what improved.
94
- 4. Record the seed from `concepts.json` when you find a keeper; it is the only thing needed to reproduce it.
@@ -1,35 +0,0 @@
1
- {
2
- "name": "logo-design",
3
- "version": "0.1.0",
4
- "private": true,
5
- "description": "Generate deterministic geometric logo marks as SVG, with lockups, concept notes, and a manifest",
6
- "type": "module",
7
- "main": "src/index.ts",
8
- "bin": {
9
- "logo-design": "src/index.ts"
10
- },
11
- "files": [
12
- "src",
13
- "SKILL.md",
14
- "tsconfig.json"
15
- ],
16
- "keywords": [
17
- "logo",
18
- "svg",
19
- "branding",
20
- "generator",
21
- "skill"
22
- ],
23
- "scripts": {
24
- "start": "bun run src/index.ts",
25
- "typecheck": "tsc --noEmit"
26
- },
27
- "dependencies": {},
28
- "optionalDependencies": {
29
- "sharp": "^0.33.5"
30
- },
31
- "devDependencies": {
32
- "@types/bun": "latest",
33
- "typescript": "^5.7.0"
34
- }
35
- }
@@ -1,132 +0,0 @@
1
- import { VERSION } from "./constants.js";
2
- import { normalizeHex } from "./palette.js";
3
- import type { CliOptions } from "./types.js";
4
-
5
- function printHelp(): void {
6
- console.log(`logo-design v${VERSION}
7
-
8
- Generate deterministic geometric logo marks as SVG. No network access and no
9
- API keys: every mark is composed locally from a hash of your brief, so the same
10
- inputs always produce the same output.
11
-
12
- USAGE:
13
- logo-design --brief <text> [options]
14
- logo-design "<brief text>" [options]
15
-
16
- OPTIONS:
17
- -b, --brief <text> Logo brief (positional text also works) [required]
18
- --brand <name> Brand or product name [Brand]
19
- --style <text> Style direction, recorded in the brief [clean geometric mark]
20
- --palette <list> Comma-separated colors: names or hex [navy,white,accent]
21
- -n, --variations <1-6> Number of concepts to generate [3]
22
- -o, --output <dir> Output directory [./logo-design]
23
- --background Draw a solid backdrop rect in each SVG [off, transparent]
24
- --png Also rasterize PNGs (requires sharp) [off]
25
- --png-size <px> PNG width/height when --png is used [512]
26
- --json Print the run summary as JSON
27
- --help Show this help message
28
- --version Show the current version
29
-
30
- OUTPUTS:
31
- vector/logo-NN.svg Standalone mark, 256x256 viewBox
32
- vector/logo-NN-lockup.svg Horizontal mark + wordmark lockup
33
- png/logo-NN.png Optional raster export (--png)
34
- concepts.json Per-variant seed, geometry, palette, rationale
35
- logo-brief.md The brief as interpreted by this run
36
- usage-notes.md Clear space, minimum sizes, do / don't
37
- manifest.json Every file written, with byte sizes
38
-
39
- EXAMPLES:
40
- logo-design --brief "minimal geometric owl mark for a developer tool" --brand Acme
41
- logo-design "vintage badge for a coffee roaster" --palette "#2B1B12,cream,rust" -n 4
42
- logo-design --brief "ledger app" --brand Ledgerly --png --png-size 1024
43
- `);
44
- }
45
-
46
- export function parseArgs(argv: string[]): CliOptions {
47
- const options: CliOptions = {
48
- brand: "Brand",
49
- style: "clean geometric mark",
50
- palette: "navy,white,accent",
51
- variations: 3,
52
- output: "./logo-design",
53
- png: false,
54
- pngSize: 512,
55
- background: false,
56
- json: false,
57
- };
58
-
59
- for (let i = 0; i < argv.length; i += 1) {
60
- const arg = argv[i];
61
- switch (arg) {
62
- case "--help":
63
- case "-h":
64
- printHelp();
65
- process.exit(0);
66
- case "--version":
67
- case "-v":
68
- console.log(VERSION);
69
- process.exit(0);
70
- case "--brief":
71
- case "-b":
72
- options.brief = argv[++i];
73
- break;
74
- case "--brand":
75
- options.brand = argv[++i] ?? options.brand;
76
- break;
77
- case "--style":
78
- options.style = argv[++i] ?? options.style;
79
- break;
80
- case "--palette":
81
- options.palette = argv[++i] ?? options.palette;
82
- break;
83
- case "--variations":
84
- case "-n": {
85
- const value = Number.parseInt(argv[++i] ?? "", 10);
86
- if (!Number.isFinite(value) || value < 1 || value > 6) {
87
- throw new Error(`Invalid --variations value: ${argv[i]} (expected 1-6)`);
88
- }
89
- options.variations = value;
90
- break;
91
- }
92
- case "--output":
93
- case "-o":
94
- options.output = argv[++i] ?? options.output;
95
- break;
96
- case "--background":
97
- options.background = true;
98
- break;
99
- case "--png":
100
- options.png = true;
101
- break;
102
- case "--png-size": {
103
- const value = Number.parseInt(argv[++i] ?? "", 10);
104
- if (!Number.isFinite(value) || value < 16 || value > 4096) {
105
- throw new Error(`Invalid --png-size value: ${argv[i]} (expected 16-4096)`);
106
- }
107
- options.pngSize = value;
108
- break;
109
- }
110
- case "--json":
111
- options.json = true;
112
- break;
113
- default:
114
- if (arg.startsWith("-")) {
115
- throw new Error(`Unknown option: ${arg}`);
116
- }
117
- if (!options.brief) {
118
- options.brief = arg;
119
- break;
120
- }
121
- throw new Error(`Unexpected argument: ${arg}`);
122
- }
123
- }
124
-
125
- if (!options.brief || options.brief.trim() === "") {
126
- throw new Error("Missing required --brief <text> argument (a positional brief also works)");
127
- }
128
-
129
- return options;
130
- }
131
-
132
-
@@ -1,5 +0,0 @@
1
- export const VERSION = "0.1.0";
2
- export const CANVAS = 256;
3
- export const MARGIN = 32;
4
- export const SAFE = CANVAS - MARGIN * 2;
5
-
@@ -1,102 +0,0 @@
1
- import type { CliOptions, Concept, Palette } from "./types.js";
2
-
3
- export function usageNotes(brand: string, palette: Palette, concepts: Concept[]): string {
4
- return `# ${brand} logo usage notes
5
-
6
- Generated by the \`logo-design\` skill. Every mark in this package is a plain SVG
7
- you can open in Figma, Illustrator, Inkscape, or any browser.
8
-
9
- ## Clear space
10
-
11
- Reserve clear space equal to **25% of the mark height** (64 units on the 256 unit
12
- artboard) on all four sides. Nothing — type, rules, photography, other logos —
13
- enters that zone.
14
-
15
- ## Minimum sizes
16
-
17
- | Context | Minimum width | Which file |
18
- |---------|---------------|------------|
19
- | Favicon / app icon | 16 px | \`vector/logo-01.svg\` (mark only) |
20
- | UI chrome, avatars | 24 px | mark only |
21
- | Print, business card | 12 mm | mark only |
22
- | Horizontal lockup | 120 px | \`vector/logo-01-lockup.svg\` |
23
-
24
- Below 120 px the wordmark in the lockup stops being legible. Drop to the mark.
25
-
26
- ## Color
27
-
28
- | Role | Hex |
29
- |------|-----|
30
- | Primary | \`${palette.primary}\` |
31
- | Secondary | \`${palette.secondary}\` |
32
- | Accent | \`${palette.accent}\` |
33
- | Background | \`${palette.background}\` |
34
-
35
- The SVGs ship with a transparent background by default. Re-run with
36
- \`--background\` if you need a baked-in backdrop rect.
37
-
38
- ## Do
39
-
40
- - Use the supplied SVG. It scales losslessly and stays crisp on any display.
41
- - Keep the mark on backgrounds that hold a contrast ratio of at least 3:1
42
- against \`${palette.primary}\`.
43
- - Scale the whole group proportionally.
44
-
45
- ## Don't
46
-
47
- - Don't recolor individual shapes ad hoc — swap the palette and regenerate.
48
- - Don't rotate, skew, or add drop shadows, bevels, or outlines.
49
- - Don't reflow the lockup: the mark stays left of the wordmark at the supplied
50
- spacing.
51
- - Don't place the mark over busy photography without a solid or scrimmed plate.
52
-
53
- ## Concepts in this package
54
-
55
- ${concepts
56
- .map((concept) => `- **${concept.id}** (\`${concept.geometry}\`, seed \`${concept.seed}\`) — ${concept.description}`)
57
- .join("\n")}
58
- `;
59
- }
60
-
61
- export function briefDoc(options: CliOptions, palette: Palette, seed: number, concepts: Concept[]): string {
62
- return `# Logo brief — ${options.brand}
63
-
64
- - **Brief**: ${options.brief}
65
- - **Brand**: ${options.brand}
66
- - **Style direction**: ${options.style}
67
- - **Palette request**: ${palette.requested.join(", ")}
68
- - **Master seed**: \`${seed}\` (derived from brief + brand + style + palette)
69
- - **Variations**: ${options.variations}
70
-
71
- ## Resolved palette
72
-
73
- | Token | Hex | Origin |
74
- |-------|-----|--------|
75
- ${palette.resolved.map((entry) => `| ${entry.token} | \`${entry.hex}\` | ${entry.origin} |`).join("\n")}
76
-
77
- Roles: primary \`${palette.primary}\`, secondary \`${palette.secondary}\`, accent \`${palette.accent}\`, background \`${palette.background}\`.
78
-
79
- ## Concepts
80
-
81
- ${concepts
82
- .map(
83
- (concept) => `### ${concept.id} — ${concept.geometry}
84
-
85
- ${concept.description}
86
-
87
- - Seed: \`${concept.seed}\`
88
- - Mark: \`${concept.markFile}\`
89
- - Lockup: \`${concept.lockupFile}\`
90
- - Rationale: ${concept.rationale}`,
91
- )
92
- .join("\n\n")}
93
-
94
- ## Reproducibility
95
-
96
- This package is deterministic. Running the same command with the same
97
- \`--brief\`, \`--brand\`, \`--style\`, and \`--palette\` regenerates byte-identical
98
- SVGs. Change any one of them to explore a different direction.
99
- `;
100
- }
101
-
102
-