@rune-kit/rune 2.8.0 → 2.11.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 (287) hide show
  1. package/LICENSE +21 -21
  2. package/README.md +68 -34
  3. package/agents/adversary.md +27 -0
  4. package/agents/architect.md +19 -29
  5. package/agents/asset-creator.md +18 -4
  6. package/agents/audit.md +25 -4
  7. package/agents/autopsy.md +19 -4
  8. package/agents/ba.md +35 -0
  9. package/agents/brainstorm.md +31 -4
  10. package/agents/browser-pilot.md +21 -4
  11. package/agents/coder.md +21 -29
  12. package/agents/completion-gate.md +20 -4
  13. package/agents/constraint-check.md +18 -4
  14. package/agents/context-engine.md +22 -4
  15. package/agents/context-pack.md +32 -0
  16. package/agents/cook.md +41 -4
  17. package/agents/db.md +19 -4
  18. package/agents/debug.md +33 -4
  19. package/agents/dependency-doctor.md +20 -4
  20. package/agents/deploy.md +27 -4
  21. package/agents/design.md +22 -4
  22. package/agents/doc-processor.md +27 -0
  23. package/agents/docs-seeker.md +19 -4
  24. package/agents/docs.md +31 -0
  25. package/agents/fix.md +37 -4
  26. package/agents/git.md +29 -0
  27. package/agents/hallucination-guard.md +20 -4
  28. package/agents/incident.md +21 -4
  29. package/agents/integrity-check.md +18 -4
  30. package/agents/journal.md +19 -4
  31. package/agents/launch.md +32 -4
  32. package/agents/logic-guardian.md +26 -11
  33. package/agents/marketing.md +23 -4
  34. package/agents/mcp-builder.md +26 -0
  35. package/agents/neural-memory.md +30 -0
  36. package/agents/onboard.md +22 -4
  37. package/agents/perf.md +21 -4
  38. package/agents/plan.md +29 -4
  39. package/agents/preflight.md +22 -4
  40. package/agents/problem-solver.md +20 -4
  41. package/agents/rescue.md +23 -4
  42. package/agents/research.md +19 -4
  43. package/agents/researcher.md +19 -29
  44. package/agents/retro.md +32 -0
  45. package/agents/review-intake.md +20 -4
  46. package/agents/review.md +32 -4
  47. package/agents/reviewer.md +20 -28
  48. package/agents/safeguard.md +19 -4
  49. package/agents/sast.md +18 -4
  50. package/agents/scaffold.md +41 -0
  51. package/agents/scanner.md +19 -28
  52. package/agents/scope-guard.md +18 -4
  53. package/agents/scout.md +23 -4
  54. package/agents/sentinel-env.md +26 -0
  55. package/agents/sentinel.md +33 -4
  56. package/agents/sequential-thinking.md +20 -4
  57. package/agents/session-bridge.md +24 -4
  58. package/agents/skill-forge.md +22 -4
  59. package/agents/skill-router.md +26 -4
  60. package/agents/slides.md +24 -0
  61. package/agents/surgeon.md +19 -4
  62. package/agents/team.md +30 -4
  63. package/agents/test.md +36 -4
  64. package/agents/trend-scout.md +17 -4
  65. package/agents/verification.md +20 -4
  66. package/agents/video-creator.md +20 -4
  67. package/agents/watchdog.md +19 -4
  68. package/agents/worktree.md +17 -4
  69. package/commands/rune.md +168 -168
  70. package/compiler/__tests__/analytics.test.js +370 -0
  71. package/compiler/adapters/openclaw.js +2 -2
  72. package/compiler/analytics.js +385 -0
  73. package/compiler/bin/rune.js +68 -2
  74. package/compiler/dashboard.js +883 -0
  75. package/compiler/transforms/branding.js +1 -1
  76. package/contexts/dev.md +34 -34
  77. package/contexts/research.md +43 -43
  78. package/contexts/review.md +55 -55
  79. package/extensions/ai-ml/PACK.md +88 -88
  80. package/extensions/ai-ml/skills/ai-agents.md +172 -172
  81. package/extensions/ai-ml/skills/code-sandbox.md +187 -187
  82. package/extensions/ai-ml/skills/deep-research.md +146 -146
  83. package/extensions/ai-ml/skills/embedding-search.md +66 -66
  84. package/extensions/ai-ml/skills/fine-tuning-guide.md +74 -74
  85. package/extensions/ai-ml/skills/llm-architect.md +125 -125
  86. package/extensions/ai-ml/skills/llm-integration.md +64 -64
  87. package/extensions/ai-ml/skills/prompt-patterns.md +72 -72
  88. package/extensions/ai-ml/skills/rag-patterns.md +66 -66
  89. package/extensions/ai-ml/skills/web-extraction.md +114 -114
  90. package/extensions/analytics/PACK.md +92 -92
  91. package/extensions/analytics/skills/ab-testing.md +72 -72
  92. package/extensions/analytics/skills/dashboard-patterns.md +83 -83
  93. package/extensions/analytics/skills/data-validation.md +68 -68
  94. package/extensions/analytics/skills/funnel-analysis.md +81 -81
  95. package/extensions/analytics/skills/sql-patterns.md +57 -57
  96. package/extensions/analytics/skills/statistical-analysis.md +79 -79
  97. package/extensions/analytics/skills/tracking-setup.md +71 -71
  98. package/extensions/backend/PACK.md +104 -104
  99. package/extensions/backend/skills/api-patterns.md +84 -84
  100. package/extensions/backend/skills/async-pipeline.md +193 -193
  101. package/extensions/backend/skills/auth-patterns.md +97 -97
  102. package/extensions/backend/skills/background-jobs.md +133 -133
  103. package/extensions/backend/skills/caching-patterns.md +108 -108
  104. package/extensions/backend/skills/cli-generation.md +133 -133
  105. package/extensions/backend/skills/database-patterns.md +87 -87
  106. package/extensions/backend/skills/middleware-patterns.md +104 -104
  107. package/extensions/chrome-ext/PACK.md +93 -93
  108. package/extensions/chrome-ext/skills/cws-preflight.md +143 -143
  109. package/extensions/chrome-ext/skills/cws-publish.md +104 -104
  110. package/extensions/chrome-ext/skills/ext-ai-integration.md +251 -251
  111. package/extensions/chrome-ext/skills/ext-messaging.md +139 -139
  112. package/extensions/chrome-ext/skills/ext-storage.md +133 -133
  113. package/extensions/chrome-ext/skills/mv3-scaffold.md +164 -164
  114. package/extensions/content/PACK.md +96 -96
  115. package/extensions/content/skills/blog-patterns.md +88 -88
  116. package/extensions/content/skills/cms-integration.md +131 -131
  117. package/extensions/content/skills/content-scoring.md +107 -107
  118. package/extensions/content/skills/i18n.md +83 -83
  119. package/extensions/content/skills/mdx-authoring.md +137 -137
  120. package/extensions/content/skills/reference.md +1014 -1014
  121. package/extensions/content/skills/seo-patterns.md +67 -67
  122. package/extensions/content/skills/video-repurpose.md +153 -153
  123. package/extensions/devops/PACK.md +101 -101
  124. package/extensions/devops/skills/chaos-testing.md +67 -67
  125. package/extensions/devops/skills/ci-cd.md +75 -75
  126. package/extensions/devops/skills/docker.md +58 -58
  127. package/extensions/devops/skills/edge-serverless.md +163 -163
  128. package/extensions/devops/skills/infra-as-code.md +158 -158
  129. package/extensions/devops/skills/kubernetes.md +110 -110
  130. package/extensions/devops/skills/monitoring.md +57 -57
  131. package/extensions/devops/skills/server-setup.md +64 -64
  132. package/extensions/devops/skills/ssl-domain.md +42 -42
  133. package/extensions/ecommerce/PACK.md +116 -116
  134. package/extensions/ecommerce/skills/cart-system.md +79 -79
  135. package/extensions/ecommerce/skills/inventory-mgmt.md +102 -102
  136. package/extensions/ecommerce/skills/order-management.md +126 -126
  137. package/extensions/ecommerce/skills/payment-integration.md +472 -472
  138. package/extensions/ecommerce/skills/shopify-dev.md +69 -69
  139. package/extensions/ecommerce/skills/subscription-billing.md +93 -93
  140. package/extensions/ecommerce/skills/tax-compliance.md +117 -117
  141. package/extensions/gamedev/PACK.md +142 -142
  142. package/extensions/gamedev/skills/asset-pipeline.md +74 -74
  143. package/extensions/gamedev/skills/audio-system.md +129 -129
  144. package/extensions/gamedev/skills/camera-system.md +87 -87
  145. package/extensions/gamedev/skills/ecs.md +98 -98
  146. package/extensions/gamedev/skills/game-loops.md +72 -72
  147. package/extensions/gamedev/skills/input-system.md +199 -199
  148. package/extensions/gamedev/skills/multiplayer.md +180 -180
  149. package/extensions/gamedev/skills/particles.md +105 -105
  150. package/extensions/gamedev/skills/physics-engine.md +89 -89
  151. package/extensions/gamedev/skills/scene-management.md +146 -146
  152. package/extensions/gamedev/skills/threejs-patterns.md +90 -90
  153. package/extensions/gamedev/skills/webgl.md +71 -71
  154. package/extensions/mobile/PACK.md +106 -106
  155. package/extensions/mobile/skills/app-store-connect.md +152 -152
  156. package/extensions/mobile/skills/app-store-prep.md +66 -66
  157. package/extensions/mobile/skills/deep-linking.md +109 -109
  158. package/extensions/mobile/skills/flutter.md +60 -60
  159. package/extensions/mobile/skills/ios-build-pipeline.md +142 -142
  160. package/extensions/mobile/skills/native-bridge.md +66 -66
  161. package/extensions/mobile/skills/ota-updates.md +97 -97
  162. package/extensions/mobile/skills/push-notifications.md +111 -111
  163. package/extensions/mobile/skills/react-native.md +82 -82
  164. package/extensions/saas/PACK.md +116 -116
  165. package/extensions/saas/skills/billing-integration.md +200 -200
  166. package/extensions/saas/skills/feature-flags.md +130 -130
  167. package/extensions/saas/skills/multi-tenant.md +103 -103
  168. package/extensions/saas/skills/onboarding-flow.md +139 -139
  169. package/extensions/saas/skills/subscription-flow.md +95 -95
  170. package/extensions/saas/skills/team-management.md +144 -144
  171. package/extensions/security/PACK.md +99 -99
  172. package/extensions/security/skills/api-security.md +140 -140
  173. package/extensions/security/skills/compliance.md +68 -68
  174. package/extensions/security/skills/owasp-audit.md +64 -64
  175. package/extensions/security/skills/pentest-patterns.md +77 -77
  176. package/extensions/security/skills/secret-mgmt.md +65 -65
  177. package/extensions/security/skills/supply-chain.md +65 -65
  178. package/extensions/trading/PACK.md +80 -80
  179. package/extensions/trading/skills/chart-components.md +55 -55
  180. package/extensions/trading/skills/experiment-loop.md +125 -125
  181. package/extensions/trading/skills/fintech-patterns.md +47 -47
  182. package/extensions/trading/skills/indicator-library.md +58 -58
  183. package/extensions/trading/skills/quant-analysis.md +111 -111
  184. package/extensions/trading/skills/realtime-data.md +58 -58
  185. package/extensions/trading/skills/trade-logic.md +104 -104
  186. package/extensions/ui/PACK.md +130 -130
  187. package/extensions/ui/skills/a11y-audit.md +91 -91
  188. package/extensions/ui/skills/animation-patterns.md +127 -106
  189. package/extensions/ui/skills/component-patterns.md +100 -75
  190. package/extensions/ui/skills/design-decision.md +108 -108
  191. package/extensions/ui/skills/design-system.md +68 -68
  192. package/extensions/ui/skills/landing-patterns.md +155 -155
  193. package/extensions/ui/skills/palette-picker.md +173 -173
  194. package/extensions/ui/skills/react-health.md +90 -90
  195. package/extensions/ui/skills/type-system.md +125 -125
  196. package/extensions/ui/skills/web-vitals.md +153 -153
  197. package/extensions/zalo/PACK.md +145 -145
  198. package/extensions/zalo/skills/zalo-oa-mcp.md +317 -317
  199. package/extensions/zalo/skills/zalo-oa-messaging.md +429 -429
  200. package/extensions/zalo/skills/zalo-oa-setup.md +236 -236
  201. package/extensions/zalo/skills/zalo-oa-webhook.md +189 -189
  202. package/extensions/zalo/skills/zalo-personal-messaging.md +194 -194
  203. package/extensions/zalo/skills/zalo-personal-setup.md +153 -153
  204. package/extensions/zalo/skills/zalo-rate-guard.md +219 -219
  205. package/hooks/auto-format/index.cjs +48 -48
  206. package/hooks/context-watch/index.cjs +95 -68
  207. package/hooks/hooks.json +111 -111
  208. package/hooks/metrics-collector/index.cjs +86 -42
  209. package/hooks/post-session-reflect/index.cjs +189 -153
  210. package/hooks/pre-compact/index.cjs +95 -95
  211. package/hooks/run-hook.cmd +1 -1
  212. package/hooks/secrets-scan/index.cjs +100 -100
  213. package/hooks/session-start/index.cjs +71 -65
  214. package/hooks/typecheck/index.cjs +65 -65
  215. package/package.json +63 -63
  216. package/references/ui-pro-max-data/LICENSE-UI-PRO-MAX +21 -21
  217. package/references/ui-pro-max-data/charts.csv +26 -26
  218. package/references/ui-pro-max-data/colors.csv +161 -161
  219. package/references/ui-pro-max-data/styles.csv +68 -68
  220. package/references/ui-pro-max-data/typography.csv +74 -74
  221. package/references/ui-pro-max-data/ui-reasoning.csv +162 -162
  222. package/references/ui-pro-max-data/ux-guidelines.csv +99 -99
  223. package/skills/adversary/SKILL.md +283 -283
  224. package/skills/asset-creator/SKILL.md +157 -157
  225. package/skills/audit/SKILL.md +148 -2
  226. package/skills/autopsy/SKILL.md +335 -259
  227. package/skills/autopsy/references/repo-analysis-patterns.md +113 -0
  228. package/skills/ba/SKILL.md +72 -2
  229. package/skills/brainstorm/SKILL.md +342 -341
  230. package/skills/browser-pilot/SKILL.md +168 -168
  231. package/skills/constraint-check/SKILL.md +165 -165
  232. package/skills/context-engine/SKILL.md +404 -404
  233. package/skills/cook/SKILL.md +917 -834
  234. package/skills/cook/references/output-format.md +33 -0
  235. package/skills/db/SKILL.md +273 -272
  236. package/skills/debug/SKILL.md +465 -443
  237. package/skills/dependency-doctor/SKILL.md +265 -235
  238. package/skills/deploy/SKILL.md +274 -231
  239. package/skills/design/DESIGN-REFERENCE.md +365 -365
  240. package/skills/design/SKILL.md +589 -482
  241. package/skills/doc-processor/SKILL.md +254 -254
  242. package/skills/docs/SKILL.md +374 -373
  243. package/skills/docs-seeker/SKILL.md +177 -177
  244. package/skills/fix/SKILL.md +330 -308
  245. package/skills/git/SKILL.md +339 -339
  246. package/skills/graft/SKILL.md +352 -0
  247. package/skills/graft/references/challenge-framework.md +98 -0
  248. package/skills/graft/references/mode-decision.md +44 -0
  249. package/skills/hallucination-guard/SKILL.md +219 -219
  250. package/skills/incident/SKILL.md +254 -251
  251. package/skills/integrity-check/SKILL.md +169 -169
  252. package/skills/journal/SKILL.md +240 -238
  253. package/skills/launch/SKILL.md +344 -342
  254. package/skills/logic-guardian/SKILL.md +251 -251
  255. package/skills/marketing/SKILL.md +290 -245
  256. package/skills/mcp-builder/SKILL.md +425 -423
  257. package/skills/mcp-builder/references/auto-discovery-pattern.md +169 -0
  258. package/skills/neural-memory/SKILL.md +362 -362
  259. package/skills/onboard/SKILL.md +404 -403
  260. package/skills/perf/SKILL.md +346 -346
  261. package/skills/plan/SKILL.md +433 -370
  262. package/skills/plan/references/feature-map.md +84 -0
  263. package/skills/preflight/SKILL.md +415 -396
  264. package/skills/problem-solver/SKILL.md +380 -284
  265. package/skills/rescue/SKILL.md +474 -450
  266. package/skills/retro/SKILL.md +5 -1
  267. package/skills/review/SKILL.md +612 -535
  268. package/skills/review-intake/SKILL.md +249 -249
  269. package/skills/safeguard/SKILL.md +200 -200
  270. package/skills/sast/SKILL.md +190 -190
  271. package/skills/scaffold/SKILL.md +328 -286
  272. package/skills/scope-guard/SKILL.md +180 -162
  273. package/skills/scout/SKILL.md +263 -263
  274. package/skills/sentinel/SKILL.md +382 -353
  275. package/skills/sentinel-env/SKILL.md +254 -254
  276. package/skills/sequential-thinking/SKILL.md +234 -234
  277. package/skills/session-bridge/SKILL.md +543 -397
  278. package/skills/skill-forge/SKILL.md +581 -539
  279. package/skills/skill-router/{skill.md → SKILL.md} +30 -2
  280. package/skills/surgeon/SKILL.md +215 -215
  281. package/skills/team/SKILL.md +556 -514
  282. package/skills/test/SKILL.md +614 -587
  283. package/skills/trend-scout/SKILL.md +145 -145
  284. package/skills/verification/SKILL.md +326 -325
  285. package/skills/video-creator/SKILL.md +201 -201
  286. package/skills/watchdog/SKILL.md +168 -168
  287. package/skills/worktree/SKILL.md +140 -140
package/skills/doc-processor/SKILL.md CHANGED
@@ -1,254 +1,254 @@
1
- ---
2
- name: doc-processor
3
- description: Generate and parse office documents — PDF, DOCX, XLSX, PPTX, CSV. Pure format utility for creating reports, exporting data, and processing uploaded documents.
4
- metadata:
5
- author: runedev
6
- version: "0.2.0"
7
- layer: L3
8
- model: sonnet
9
- group: utility
10
- tools: "Read, Write, Edit, Bash, Glob, Grep"
11
- ---
12
-
13
- # doc-processor
14
-
15
- ## Purpose
16
-
17
- Document format utility. Generates and parses office documents (PDF, DOCX, XLSX, PPTX, CSV). Pure utility — no business logic, just format handling. Other skills call doc-processor when they need to produce or consume structured documents.
18
-
19
- ## Triggers
20
-
21
- - Called by `docs` when export to PDF/DOCX is requested
22
- - Called by `marketing` for generating PDF reports, PPTX presentations
23
- - Called by Rune Pro packs for business document generation
24
- - `/rune doc-processor generate <format> <source>` — manual document generation
25
- - `/rune doc-processor parse <file>` — manual document parsing
26
-
27
- ## Calls (outbound)
28
-
29
- None — pure L3 utility. Receives content, produces formatted output.
30
-
31
- ## Called By (inbound)
32
-
33
- - `docs` (L2): export documentation to PDF/DOCX
34
- - `marketing` (L2): generate PDF reports, PPTX pitch decks
35
- - Rune Pro packs: business document generation (invoices, proposals, reports)
36
- - User: `/rune doc-processor` direct invocation
37
-
38
- ## Format Reference
39
-
40
- ### Supported Formats
41
-
42
- | Format | Generate | Parse | Node.js Library | Python Library |
43
- |--------|----------|-------|-----------------|----------------|
44
- | PDF | Yes | Yes (via Read tool) | jsPDF, Puppeteer (HTML→PDF) | reportlab, weasyprint |
45
- | DOCX | Yes | Yes | docx (officegen) | python-docx |
46
- | XLSX | Yes | Yes | ExcelJS | openpyxl |
47
- | PPTX | Yes | Yes | pptxgenjs | python-pptx |
48
- | CSV | Yes | Yes | Built-in (fs + string ops) | Built-in (csv module) |
49
- | HTML | Yes | Yes | Built-in | Built-in |
50
-
51
- ### Library Selection
52
-
53
- Detect project language from context:
54
- - If Node.js project → use Node.js libraries
55
- - If Python project → use Python libraries
56
- - If unclear → default to Node.js (wider ecosystem)
57
- - For HTML→PDF → prefer Puppeteer (best fidelity) or weasyprint (Python)
58
-
59
- ## Executable Steps
60
-
61
- ### Generate Mode
62
-
63
- #### Step 1 — Determine Format and Template
64
-
65
- Identify:
66
- - Target format (PDF, DOCX, XLSX, PPTX, CSV)
67
- - Content source (markdown, data object, template + data)
68
- - Styling requirements (brand colors, fonts, layout)
69
- - Output path
70
-
71
- #### Step 2 — Select Generation Strategy
72
-
73
- | Source | Target | Strategy |
74
- |--------|--------|----------|
75
- | Markdown → PDF | HTML intermediate | Render MD → HTML → Puppeteer → PDF |
76
- | Markdown → DOCX | Direct conversion | Parse MD → docx library → DOCX |
77
- | Data → XLSX | Direct write | Map data to sheets/cells → ExcelJS |
78
- | Slides → PPTX | Template + data | Build slides from content → pptxgenjs |
79
- | Data → CSV | Direct write | Serialize rows → CSV string → file |
80
- | Any → HTML | Direct render | Template engine → HTML file |
81
-
82
- #### Step 3 — Generate Code
83
-
84
- Produce the generation script:
85
-
86
- **PDF from Markdown:**
87
- ```javascript
88
- // Strategy: Markdown → HTML → Puppeteer → PDF
89
- const puppeteer = require('puppeteer');
90
- const { marked } = require('marked');
91
-
92
- async function generatePDF(markdownContent, outputPath, options = {}) {
93
- const html = `
94
- <!DOCTYPE html>
95
- <html>
96
- <head><style>${options.css || defaultCSS}</style></head>
97
- <body>${marked(markdownContent)}</body>
98
- </html>
99
- `;
100
- const browser = await puppeteer.launch();
101
- const page = await browser.newPage();
102
- await page.setContent(html, { waitUntil: 'networkidle0' });
103
- await page.pdf({ path: outputPath, format: 'A4', margin: { top: '1in', bottom: '1in', left: '1in', right: '1in' } });
104
- await browser.close();
105
- }
106
- ```
107
-
108
- **XLSX from Data:**
109
- ```javascript
110
- const ExcelJS = require('exceljs');
111
-
112
- async function generateXLSX(data, outputPath, options = {}) {
113
- const workbook = new ExcelJS.Workbook();
114
- const sheet = workbook.addWorksheet(options.sheetName || 'Sheet1');
115
- if (data.length > 0) {
116
- sheet.columns = Object.keys(data[0]).map(key => ({ header: key, key, width: 20 }));
117
- data.forEach(row => sheet.addRow(row));
118
- // Style header row
119
- sheet.getRow(1).font = { bold: true };
120
- sheet.getRow(1).fill = { type: 'pattern', pattern: 'solid', fgColor: { argb: 'FFE0E0E0' } };
121
- }
122
- await workbook.xlsx.writeFile(outputPath);
123
- }
124
- ```
125
-
126
- **PPTX from Slides:**
127
- ```javascript
128
- const PptxGenJS = require('pptxgenjs');
129
-
130
- function generatePPTX(slides, outputPath, options = {}) {
131
- const pptx = new PptxGenJS();
132
- pptx.author = options.author || 'Generated by Rune';
133
- slides.forEach(slide => {
134
- const s = pptx.addSlide();
135
- if (slide.title) s.addText(slide.title, { x: 0.5, y: 0.5, fontSize: 28, bold: true });
136
- if (slide.body) s.addText(slide.body, { x: 0.5, y: 1.5, fontSize: 16 });
137
- if (slide.bullets) s.addText(slide.bullets.map(b => ({ text: b, options: { bullet: true } })), { x: 0.5, y: 1.5, fontSize: 16 });
138
- });
139
- return pptx.writeFile({ fileName: outputPath });
140
- }
141
- ```
142
-
143
- #### Step 4 — Execute and Verify
144
-
145
- Run the generation script. Verify:
146
- - Output file exists and is non-empty
147
- - File can be opened (basic format validation)
148
- - Content matches expected structure
149
-
150
- ### Parse Mode
151
-
152
- #### Step 1 — Detect Format
153
-
154
- Identify file format from extension and MIME type.
155
-
156
- #### Step 2 — Extract Content
157
-
158
- | Format | Extraction Strategy |
159
- |--------|-------------------|
160
- | PDF | Use Read tool (Claude can read PDFs natively) |
161
- | DOCX | docx library → extract text, tables, images |
162
- | XLSX | ExcelJS → extract sheets, rows, formulas |
163
- | PPTX | pptxgenjs → extract slides, text, notes |
164
- | CSV | Built-in parser → structured data |
165
-
166
- #### Step 3 — Structure Output
167
-
168
- Return parsed content as structured data:
169
- ```json
170
- {
171
- "format": "xlsx",
172
- "sheets": [
173
- {
174
- "name": "Sheet1",
175
- "headers": ["Name", "Email", "Role"],
176
- "rows": [["Alice", "alice@co.com", "Engineer"], ...],
177
- "rowCount": 100
178
- }
179
- ]
180
- }
181
- ```
182
-
183
- ## Output Format
184
-
185
- ### Generate Mode Output
186
- - Generated document file at specified output path
187
- - Verification report: file exists, non-empty, format valid
188
-
189
- ```
190
- Document Generated:
191
- - Format: [PDF/DOCX/XLSX/PPTX/CSV]
192
- - Path: [output file path]
193
- - Size: [file size]
194
- - Strategy: [e.g., Markdown → HTML → Puppeteer → PDF]
195
- - Status: verified ✓
196
- ```
197
-
198
- ### Parse Mode Output
199
- Structured JSON returned to calling skill:
200
-
201
- ```json
202
- {
203
- "format": "xlsx",
204
- "metadata": { "author": "...", "created": "..." },
205
- "content": {
206
- "sheets": [
207
- {
208
- "name": "Sheet1",
209
- "headers": ["Col1", "Col2"],
210
- "rows": [["val1", "val2"]],
211
- "rowCount": 100
212
- }
213
- ]
214
- }
215
- }
216
- ```
217
-
218
- Format-specific fields: `sheets` (XLSX), `pages` (PDF/DOCX), `slides` (PPTX), `rows` (CSV).
219
-
220
- ## Constraints
221
-
222
- 1. MUST verify output file exists and is non-empty after generation
223
- 2. MUST handle missing libraries gracefully — suggest `npm install` / `pip install` if not found
224
- 3. MUST NOT embed secrets or sensitive data in generated documents
225
- 4. MUST preserve formatting fidelity — generated docs should look professional
226
- 5. Parse mode MUST handle malformed files gracefully — report errors, don't crash
227
- 6. MUST use appropriate library for each format — don't force one library for all formats
228
-
229
- ## Sharp Edges
230
-
231
- | Failure Mode | Severity | Mitigation |
232
- |---|---|---|
233
- | Library not installed in project | HIGH | Check package.json/requirements.txt, suggest install command |
234
- | PDF generation fails without headless browser | HIGH | Puppeteer needs chromium — suggest alternative (jsPDF) if unavailable |
235
- | XLSX with formulas not evaluated | MEDIUM | Use ExcelJS formula support, warn if complex formulas |
236
- | Large file generation runs out of memory | MEDIUM | Stream large datasets instead of loading all at once |
237
- | Generated file is empty or corrupt | HIGH | Step 4 verification catches this — retry or report |
238
-
239
- ## Done When
240
-
241
- ### Generate Mode
242
- - Target format and source identified
243
- - Generation strategy selected
244
- - Code produced and executed
245
- - Output file verified (exists, non-empty, valid format)
246
-
247
- ### Parse Mode
248
- - File format detected
249
- - Content extracted to structured data
250
- - Output returned in consistent JSON format
251
-
252
- ## Cost Profile
253
-
254
- ~1000-3000 tokens input, ~500-2000 tokens output. Sonnet — document processing requires understanding format libraries and generating correct code, but not deep reasoning.
1
+ ---
2
+ name: doc-processor
3
+ description: Generate and parse office documents — PDF, DOCX, XLSX, PPTX, CSV. Pure format utility for creating reports, exporting data, and processing uploaded documents.
4
+ metadata:
5
+ author: runedev
6
+ version: "0.2.0"
7
+ layer: L3
8
+ model: sonnet
9
+ group: utility
10
+ tools: "Read, Write, Edit, Bash, Glob, Grep"
11
+ ---
12
+
13
+ # doc-processor
14
+
15
+ ## Purpose
16
+
17
+ Document format utility. Generates and parses office documents (PDF, DOCX, XLSX, PPTX, CSV). Pure utility — no business logic, just format handling. Other skills call doc-processor when they need to produce or consume structured documents.
18
+
19
+ ## Triggers
20
+
21
+ - Called by `docs` when export to PDF/DOCX is requested
22
+ - Called by `marketing` for generating PDF reports, PPTX presentations
23
+ - Called by Rune Pro packs for business document generation
24
+ - `/rune doc-processor generate <format> <source>` — manual document generation
25
+ - `/rune doc-processor parse <file>` — manual document parsing
26
+
27
+ ## Calls (outbound)
28
+
29
+ None — pure L3 utility. Receives content, produces formatted output.
30
+
31
+ ## Called By (inbound)
32
+
33
+ - `docs` (L2): export documentation to PDF/DOCX
34
+ - `marketing` (L2): generate PDF reports, PPTX pitch decks
35
+ - Rune Pro packs: business document generation (invoices, proposals, reports)
36
+ - User: `/rune doc-processor` direct invocation
37
+
38
+ ## Format Reference
39
+
40
+ ### Supported Formats
41
+
42
+ | Format | Generate | Parse | Node.js Library | Python Library |
43
+ |--------|----------|-------|-----------------|----------------|
44
+ | PDF | Yes | Yes (via Read tool) | jsPDF, Puppeteer (HTML→PDF) | reportlab, weasyprint |
45
+ | DOCX | Yes | Yes | docx (officegen) | python-docx |
46
+ | XLSX | Yes | Yes | ExcelJS | openpyxl |
47
+ | PPTX | Yes | Yes | pptxgenjs | python-pptx |
48
+ | CSV | Yes | Yes | Built-in (fs + string ops) | Built-in (csv module) |
49
+ | HTML | Yes | Yes | Built-in | Built-in |
50
+
51
+ ### Library Selection
52
+
53
+ Detect project language from context:
54
+ - If Node.js project → use Node.js libraries
55
+ - If Python project → use Python libraries
56
+ - If unclear → default to Node.js (wider ecosystem)
57
+ - For HTML→PDF → prefer Puppeteer (best fidelity) or weasyprint (Python)
58
+
59
+ ## Executable Steps
60
+
61
+ ### Generate Mode
62
+
63
+ #### Step 1 — Determine Format and Template
64
+
65
+ Identify:
66
+ - Target format (PDF, DOCX, XLSX, PPTX, CSV)
67
+ - Content source (markdown, data object, template + data)
68
+ - Styling requirements (brand colors, fonts, layout)
69
+ - Output path
70
+
71
+ #### Step 2 — Select Generation Strategy
72
+
73
+ | Source | Target | Strategy |
74
+ |--------|--------|----------|
75
+ | Markdown → PDF | HTML intermediate | Render MD → HTML → Puppeteer → PDF |
76
+ | Markdown → DOCX | Direct conversion | Parse MD → docx library → DOCX |
77
+ | Data → XLSX | Direct write | Map data to sheets/cells → ExcelJS |
78
+ | Slides → PPTX | Template + data | Build slides from content → pptxgenjs |
79
+ | Data → CSV | Direct write | Serialize rows → CSV string → file |
80
+ | Any → HTML | Direct render | Template engine → HTML file |
81
+
82
+ #### Step 3 — Generate Code
83
+
84
+ Produce the generation script:
85
+
86
+ **PDF from Markdown:**
87
+ ```javascript
88
+ // Strategy: Markdown → HTML → Puppeteer → PDF
89
+ const puppeteer = require('puppeteer');
90
+ const { marked } = require('marked');
91
+
92
+ async function generatePDF(markdownContent, outputPath, options = {}) {
93
+ const html = `
94
+ <!DOCTYPE html>
95
+ <html>
96
+ <head><style>${options.css || defaultCSS}</style></head>
97
+ <body>${marked(markdownContent)}</body>
98
+ </html>
99
+ `;
100
+ const browser = await puppeteer.launch();
101
+ const page = await browser.newPage();
102
+ await page.setContent(html, { waitUntil: 'networkidle0' });
103
+ await page.pdf({ path: outputPath, format: 'A4', margin: { top: '1in', bottom: '1in', left: '1in', right: '1in' } });
104
+ await browser.close();
105
+ }
106
+ ```
107
+
108
+ **XLSX from Data:**
109
+ ```javascript
110
+ const ExcelJS = require('exceljs');
111
+
112
+ async function generateXLSX(data, outputPath, options = {}) {
113
+ const workbook = new ExcelJS.Workbook();
114
+ const sheet = workbook.addWorksheet(options.sheetName || 'Sheet1');
115
+ if (data.length > 0) {
116
+ sheet.columns = Object.keys(data[0]).map(key => ({ header: key, key, width: 20 }));
117
+ data.forEach(row => sheet.addRow(row));
118
+ // Style header row
119
+ sheet.getRow(1).font = { bold: true };
120
+ sheet.getRow(1).fill = { type: 'pattern', pattern: 'solid', fgColor: { argb: 'FFE0E0E0' } };
121
+ }
122
+ await workbook.xlsx.writeFile(outputPath);
123
+ }
124
+ ```
125
+
126
+ **PPTX from Slides:**
127
+ ```javascript
128
+ const PptxGenJS = require('pptxgenjs');
129
+
130
+ function generatePPTX(slides, outputPath, options = {}) {
131
+ const pptx = new PptxGenJS();
132
+ pptx.author = options.author || 'Generated by Rune';
133
+ slides.forEach(slide => {
134
+ const s = pptx.addSlide();
135
+ if (slide.title) s.addText(slide.title, { x: 0.5, y: 0.5, fontSize: 28, bold: true });
136
+ if (slide.body) s.addText(slide.body, { x: 0.5, y: 1.5, fontSize: 16 });
137
+ if (slide.bullets) s.addText(slide.bullets.map(b => ({ text: b, options: { bullet: true } })), { x: 0.5, y: 1.5, fontSize: 16 });
138
+ });
139
+ return pptx.writeFile({ fileName: outputPath });
140
+ }
141
+ ```
142
+
143
+ #### Step 4 — Execute and Verify
144
+
145
+ Run the generation script. Verify:
146
+ - Output file exists and is non-empty
147
+ - File can be opened (basic format validation)
148
+ - Content matches expected structure
149
+
150
+ ### Parse Mode
151
+
152
+ #### Step 1 — Detect Format
153
+
154
+ Identify file format from extension and MIME type.
155
+
156
+ #### Step 2 — Extract Content
157
+
158
+ | Format | Extraction Strategy |
159
+ |--------|-------------------|
160
+ | PDF | Use Read tool (Claude can read PDFs natively) |
161
+ | DOCX | docx library → extract text, tables, images |
162
+ | XLSX | ExcelJS → extract sheets, rows, formulas |
163
+ | PPTX | pptxgenjs → extract slides, text, notes |
164
+ | CSV | Built-in parser → structured data |
165
+
166
+ #### Step 3 — Structure Output
167
+
168
+ Return parsed content as structured data:
169
+ ```json
170
+ {
171
+ "format": "xlsx",
172
+ "sheets": [
173
+ {
174
+ "name": "Sheet1",
175
+ "headers": ["Name", "Email", "Role"],
176
+ "rows": [["Alice", "alice@co.com", "Engineer"], ...],
177
+ "rowCount": 100
178
+ }
179
+ ]
180
+ }
181
+ ```
182
+
183
+ ## Output Format
184
+
185
+ ### Generate Mode Output
186
+ - Generated document file at specified output path
187
+ - Verification report: file exists, non-empty, format valid
188
+
189
+ ```
190
+ Document Generated:
191
+ - Format: [PDF/DOCX/XLSX/PPTX/CSV]
192
+ - Path: [output file path]
193
+ - Size: [file size]
194
+ - Strategy: [e.g., Markdown → HTML → Puppeteer → PDF]
195
+ - Status: verified ✓
196
+ ```
197
+
198
+ ### Parse Mode Output
199
+ Structured JSON returned to calling skill:
200
+
201
+ ```json
202
+ {
203
+ "format": "xlsx",
204
+ "metadata": { "author": "...", "created": "..." },
205
+ "content": {
206
+ "sheets": [
207
+ {
208
+ "name": "Sheet1",
209
+ "headers": ["Col1", "Col2"],
210
+ "rows": [["val1", "val2"]],
211
+ "rowCount": 100
212
+ }
213
+ ]
214
+ }
215
+ }
216
+ ```
217
+
218
+ Format-specific fields: `sheets` (XLSX), `pages` (PDF/DOCX), `slides` (PPTX), `rows` (CSV).
219
+
220
+ ## Constraints
221
+
222
+ 1. MUST verify output file exists and is non-empty after generation
223
+ 2. MUST handle missing libraries gracefully — suggest `npm install` / `pip install` if not found
224
+ 3. MUST NOT embed secrets or sensitive data in generated documents
225
+ 4. MUST preserve formatting fidelity — generated docs should look professional
226
+ 5. Parse mode MUST handle malformed files gracefully — report errors, don't crash
227
+ 6. MUST use appropriate library for each format — don't force one library for all formats
228
+
229
+ ## Sharp Edges
230
+
231
+ | Failure Mode | Severity | Mitigation |
232
+ |---|---|---|
233
+ | Library not installed in project | HIGH | Check package.json/requirements.txt, suggest install command |
234
+ | PDF generation fails without headless browser | HIGH | Puppeteer needs chromium — suggest alternative (jsPDF) if unavailable |
235
+ | XLSX with formulas not evaluated | MEDIUM | Use ExcelJS formula support, warn if complex formulas |
236
+ | Large file generation runs out of memory | MEDIUM | Stream large datasets instead of loading all at once |
237
+ | Generated file is empty or corrupt | HIGH | Step 4 verification catches this — retry or report |
238
+
239
+ ## Done When
240
+
241
+ ### Generate Mode
242
+ - Target format and source identified
243
+ - Generation strategy selected
244
+ - Code produced and executed
245
+ - Output file verified (exists, non-empty, valid format)
246
+
247
+ ### Parse Mode
248
+ - File format detected
249
+ - Content extracted to structured data
250
+ - Output returned in consistent JSON format
251
+
252
+ ## Cost Profile
253
+
254
+ ~1000-3000 tokens input, ~500-2000 tokens output. Sonnet — document processing requires understanding format libraries and generating correct code, but not deep reasoning.