alran 0.0.0-stage → 0.9.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 (506) hide show
  1. package/ALRAN_TOOLS_NOTICES.md +64 -0
  2. package/LICENSE +27 -0
  3. package/LICENSE-STATUS.md +21 -0
  4. package/NOTICE +6 -0
  5. package/README.md +289 -2
  6. package/THIRD_PARTY_NOTICES.md +113 -0
  7. package/alran-tools.js +3 -0
  8. package/assets/agents/_default/prompt-auto_classifier.md +185 -0
  9. package/assets/agents/_default/prompt-auto_classifier_extras.md +17 -0
  10. package/assets/agents/_default/prompt-base-all.md +133 -0
  11. package/assets/agents/_default/prompt-base-all.md.hbs +228 -0
  12. package/assets/agents/_default/prompt-base-windows.md +5 -0
  13. package/assets/agents/_default/prompt-base-windows.md.hbs +5 -0
  14. package/assets/agents/_default/prompt-base-worker.md +10 -0
  15. package/assets/agents/_default/prompt-base-worker.md.hbs +27 -0
  16. package/assets/agents/_default/prompt-compact.md +76 -0
  17. package/assets/agents/_default/prompt-compact_continue.md +9 -0
  18. package/assets/agents/_default/prompt-git.md +8 -0
  19. package/assets/agents/_default/prompt-goal.md +13 -0
  20. package/assets/agents/_default/prompt-session-branch.md +3 -0
  21. package/assets/agents/_default/prompt-session-branch.md.hbs +30 -0
  22. package/assets/agents/_default/prompt-session-root.md +3 -0
  23. package/assets/agents/_default/prompt-session-root.md.hbs +32 -0
  24. package/assets/agents/_default/prompt-title.md +11 -0
  25. package/assets/agents/_default/prompt-tool_agent.md +22 -0
  26. package/assets/agents/_migration/README.md +20 -0
  27. package/assets/agents/_migration/coder/PERSONA.md +11 -0
  28. package/assets/agents/_migration/coder/system-prompt.md.hbs +42 -0
  29. package/assets/agents/_migration/general/PERSONA.md +11 -0
  30. package/assets/agents/_migration/general/system-prompt.md.hbs +49 -0
  31. package/assets/agents/_v2/AGENT_CONTEXT.md.hbs +245 -0
  32. package/assets/agents/_v2/PTC_TOOL_CALLS.md.hbs +35 -0
  33. package/assets/agents/_v2/coding/SYSTEM.md.hbs +173 -0
  34. package/assets/agents/_v2/explore.md.hbs +38 -0
  35. package/assets/agents/_v2/tui/SYSTEM.md.hbs +211 -0
  36. package/assets/agents/_v2/verifier.md.hbs +32 -0
  37. package/assets/agents/_v2/work/SYSTEM.md.hbs +186 -0
  38. package/assets/agents/_v2/worker.md.hbs +27 -0
  39. package/assets/agents/alran/PERSONA.md +7 -0
  40. package/assets/agents/alran/features/cron.md.hbs +0 -0
  41. package/assets/agents/alran/features/delegation.md.hbs +56 -0
  42. package/assets/agents/alran/features/memory.md.hbs +61 -0
  43. package/assets/agents/alran/features/recoverable-deletion.md.hbs +10 -0
  44. package/assets/agents/alran/features/task-management.md.hbs +11 -0
  45. package/assets/agents/alran/features/web-search.md.hbs +11 -0
  46. package/assets/agents/alran/modes/coding/online/PERSONA.md.hbs +20 -0
  47. package/assets/agents/alran/modes/coding/online/SYSTEM.md.hbs +158 -0
  48. package/assets/agents/alran/modes/work/online/PERSONA.md.hbs +20 -0
  49. package/assets/agents/alran/modes/work/online/SYSTEM.md.hbs +160 -0
  50. package/assets/agents/alran/prompt-session-root.md +4 -0
  51. package/assets/agents/alran/prompt-session-root.md.hbs +4 -0
  52. package/assets/agents/alran/skills/alran-code-product/SKILL.md +72 -0
  53. package/assets/agents/alran/skills/alran-code-product/references/account-models.md +61 -0
  54. package/assets/agents/alran/skills/alran-code-product/references/agents.md +34 -0
  55. package/assets/agents/alran/skills/alran-code-product/references/extensions.md +46 -0
  56. package/assets/agents/alran/skills/alran-code-product/references/workflows.md +56 -0
  57. package/assets/agents/alran/skills/control-in-app-browser/SKILL.md +590 -0
  58. package/assets/agents/alran/system-prompt.md.hbs +97 -0
  59. package/assets/agents/builtin-agents.json +1 -0
  60. package/assets/agents/desktop-task/archive-title/system-en.md +1 -0
  61. package/assets/agents/desktop-task/checkpoint/system.md +19 -0
  62. package/assets/agents/desktop-task/output-revision/system.md +1 -0
  63. package/assets/agents/desktop-task/retry/continuation.md +4 -0
  64. package/assets/agents/desktop-task/session-title/system.md +41 -0
  65. package/assets/agents/explore/PERSONA.md +8 -0
  66. package/assets/agents/explore/agent.md +14 -0
  67. package/assets/agents/explore/system-prompt.md.hbs +35 -0
  68. package/assets/agents/greeting.md +61 -0
  69. package/assets/agents/managed-prompts.json +47 -0
  70. package/assets/agents/prompt-exemptions.json +36 -0
  71. package/assets/agents/verifier/PERSONA.md +8 -0
  72. package/assets/agents/verifier/agent.md +17 -0
  73. package/assets/agents/verifier/system-prompt.md.hbs +28 -0
  74. package/assets/agents/worker/PERSONA.md +8 -0
  75. package/assets/agents/worker/agent.md +18 -0
  76. package/assets/agents/worker/system-prompt.md.hbs +22 -0
  77. package/assets/agents/workflow/code-review/review-candidates.md +120 -0
  78. package/assets/agents/workflow/code-review/reviewer-system.md +75 -0
  79. package/assets/agents/workflow/goal/budget-limit.md +16 -0
  80. package/assets/agents/workflow/goal/continuation.md +62 -0
  81. package/assets/agents/workflow/goal/objective-updated.md +16 -0
  82. package/assets/agents/workflow/goal/recovery-terminal-audit.md +13 -0
  83. package/assets/agents/workflow/goal/recovery.md +11 -0
  84. package/assets/agents/workflow/goal/terminal-audit.md +10 -0
  85. package/assets/agents/workflow/plan-mode/agent-entry.md +72 -0
  86. package/assets/agents/workflow/prompt-hook/system.md +0 -0
  87. package/assets/models-dev-catalog.json.gz +0 -0
  88. package/assets/prompts/code-review/review-candidates.md +120 -0
  89. package/assets/prompts/code-review/reviewer-system.md +75 -0
  90. package/assets/skills/alran-tools-master/SKILL.md +127 -0
  91. package/assets/skills/code-review/SKILL.md +51 -0
  92. package/assets/skills/cu-desktop/SKILL.md +255 -0
  93. package/assets/skills/deep-research/SKILL.md +30 -0
  94. package/assets/skills/deploy-website/SKILL.md +52 -0
  95. package/assets/skills/docx/LICENSE +21 -0
  96. package/assets/skills/docx/SKILL.md +259 -0
  97. package/assets/skills/docx/assets/styles/academic_styles.xml +250 -0
  98. package/assets/skills/docx/assets/styles/corporate_styles.xml +284 -0
  99. package/assets/skills/docx/assets/styles/default_styles.xml +449 -0
  100. package/assets/skills/docx/assets/xsd/aesthetic-rules.xsd +470 -0
  101. package/assets/skills/docx/assets/xsd/business-rules.xsd +130 -0
  102. package/assets/skills/docx/assets/xsd/common-types.xsd +159 -0
  103. package/assets/skills/docx/assets/xsd/wml-subset.xsd +589 -0
  104. package/assets/skills/docx/docs/acceptance-checklists/create.md +7 -0
  105. package/assets/skills/docx/docs/acceptance-checklists/edit.md +6 -0
  106. package/assets/skills/docx/docs/acceptance-checklists/layout-repair.md +7 -0
  107. package/assets/skills/docx/docs/acceptance-checklists/template.md +6 -0
  108. package/assets/skills/docx/docs/acceptance.md +139 -0
  109. package/assets/skills/docx/docs/anti-patterns.md +14 -0
  110. package/assets/skills/docx/docs/backends.md +116 -0
  111. package/assets/skills/docx/docs/evidence.md +73 -0
  112. package/assets/skills/docx/docs/failure-taxonomy.md +71 -0
  113. package/assets/skills/docx/docs/index.md +50 -0
  114. package/assets/skills/docx/docs/rendered-delivery.md +125 -0
  115. package/assets/skills/docx/docs/router.md +122 -0
  116. package/assets/skills/docx/docs/tables-and-numbering.md +27 -0
  117. package/assets/skills/docx/docs/task-apply-template.md +141 -0
  118. package/assets/skills/docx/docs/task-compare-two-docx.md +48 -0
  119. package/assets/skills/docx/docs/task-create.md +124 -0
  120. package/assets/skills/docx/docs/task-edit-fill.md +69 -0
  121. package/assets/skills/docx/docs/task-read-content.md +148 -0
  122. package/assets/skills/docx/docs/task-read-rendered.md +78 -0
  123. package/assets/skills/docx/docs/task-read-structure.md +93 -0
  124. package/assets/skills/docx/docs/task-repair-layout.md +70 -0
  125. package/assets/skills/docx/docs/template-dsl.md +32 -0
  126. package/assets/skills/docx/docs/track-changes.md +15 -0
  127. package/assets/skills/docx/docs/xml-patch-dsl.md +33 -0
  128. package/assets/skills/docx/references/cjk_typography.md +357 -0
  129. package/assets/skills/docx/references/cjk_university_template_guide.md +184 -0
  130. package/assets/skills/docx/references/comments_guide.md +191 -0
  131. package/assets/skills/docx/references/design_good_bad_examples.md +829 -0
  132. package/assets/skills/docx/references/design_principles.md +819 -0
  133. package/assets/skills/docx/references/openxml_element_order.md +308 -0
  134. package/assets/skills/docx/references/openxml_encyclopedia_part1.md +4061 -0
  135. package/assets/skills/docx/references/openxml_encyclopedia_part2.md +2820 -0
  136. package/assets/skills/docx/references/openxml_encyclopedia_part3.md +3381 -0
  137. package/assets/skills/docx/references/openxml_namespaces.md +82 -0
  138. package/assets/skills/docx/references/openxml_units.md +72 -0
  139. package/assets/skills/docx/references/sample-patch-plans.json +22 -0
  140. package/assets/skills/docx/references/sample-task-intents.json +5 -0
  141. package/assets/skills/docx/references/sample-template-manifests.json +21 -0
  142. package/assets/skills/docx/references/scenario_a_create.md +284 -0
  143. package/assets/skills/docx/references/scenario_b_edit_content.md +295 -0
  144. package/assets/skills/docx/references/scenario_c_apply_template.md +456 -0
  145. package/assets/skills/docx/references/track_changes_guide.md +200 -0
  146. package/assets/skills/docx/references/troubleshooting.md +506 -0
  147. package/assets/skills/docx/references/typography_guide.md +294 -0
  148. package/assets/skills/docx/references/xsd_validation_guide.md +158 -0
  149. package/assets/skills/docx/scripts/build_patch_plan.py +29 -0
  150. package/assets/skills/docx/scripts/diff_docx_structure.py +61 -0
  151. package/assets/skills/docx/scripts/doc_to_docx.ps1 +85 -0
  152. package/assets/skills/docx/scripts/doc_to_docx.sh +40 -0
  153. package/assets/skills/docx/scripts/docx_preview.ps1 +76 -0
  154. package/assets/skills/docx/scripts/docx_preview.sh +37 -0
  155. package/assets/skills/docx/scripts/docx_to_pdf.py +87 -0
  156. package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Cli/AlranAIDocx.Cli.csproj +19 -0
  157. package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Cli/Program.cs +18 -0
  158. package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/AlranAIDocx.Core.csproj +15 -0
  159. package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Commands/AnalyzeCommand.cs +147 -0
  160. package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Commands/ApplyTemplateCommand.cs +322 -0
  161. package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Commands/CreateCommand.cs +324 -0
  162. package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Commands/DiffCommand.cs +155 -0
  163. package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Commands/EditContentCommand.cs +487 -0
  164. package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Commands/FixOrderCommand.cs +108 -0
  165. package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Commands/MergeRunsCommand.cs +122 -0
  166. package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Commands/ValidateCommand.cs +107 -0
  167. package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/OpenXml/CommentSynchronizer.cs +169 -0
  168. package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/OpenXml/ElementOrder.cs +80 -0
  169. package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/OpenXml/NamespaceConstants.cs +42 -0
  170. package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/OpenXml/RunMerger.cs +81 -0
  171. package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/OpenXml/StyleAnalyzer.cs +81 -0
  172. package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/OpenXml/TrackChangesHelper.cs +99 -0
  173. package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/OpenXml/UnitConverter.cs +23 -0
  174. package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Samples/AestheticRecipeSamples.cs +1832 -0
  175. package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Samples/AestheticRecipeSamples_Batch1.cs +910 -0
  176. package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Samples/AestheticRecipeSamples_Batch2.cs +999 -0
  177. package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Samples/AestheticRecipeSamples_Batch3.cs +1048 -0
  178. package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Samples/AestheticRecipeSamples_Batch4.cs +1038 -0
  179. package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Samples/CharacterFormattingSamples.cs +1020 -0
  180. package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Samples/DocumentCreationSamples.cs +1121 -0
  181. package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Samples/FieldAndTocSamples.cs +624 -0
  182. package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Samples/FootnoteAndCommentSamples.cs +675 -0
  183. package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Samples/HeaderFooterSamples.cs +838 -0
  184. package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Samples/ImageSamples.cs +917 -0
  185. package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Samples/ListAndNumberingSamples.cs +826 -0
  186. package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Samples/ParagraphFormattingSamples.cs +1199 -0
  187. package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Samples/StyleSystemSamples.cs +1487 -0
  188. package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Samples/TableSamples.cs +1163 -0
  189. package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Samples/TrackChangesSamples.cs +595 -0
  190. package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Typography/CjkHelper.cs +39 -0
  191. package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Typography/FontDefaults.cs +24 -0
  192. package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Typography/PageSizes.cs +20 -0
  193. package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Validation/BusinessRuleValidator.cs +224 -0
  194. package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Validation/GateCheckValidator.cs +148 -0
  195. package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Validation/ValidationResult.cs +23 -0
  196. package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Validation/XsdValidator.cs +69 -0
  197. package/assets/skills/docx/scripts/dotnet/AlranAIDocx.slnx +4 -0
  198. package/assets/skills/docx/scripts/env_check.ps1 +327 -0
  199. package/assets/skills/docx/scripts/env_check.sh +340 -0
  200. package/assets/skills/docx/scripts/extract_docx_text.py +1075 -0
  201. package/assets/skills/docx/scripts/pack_docx.py +31 -0
  202. package/assets/skills/docx/scripts/read_docx_structure.py +1032 -0
  203. package/assets/skills/docx/scripts/render_docx_pages.py +147 -0
  204. package/assets/skills/docx/scripts/rendered_report.py +609 -0
  205. package/assets/skills/docx/scripts/setup.ps1 +542 -0
  206. package/assets/skills/docx/scripts/setup.sh +537 -0
  207. package/assets/skills/docx/scripts/unpack_docx.py +29 -0
  208. package/assets/skills/docx/scripts/validate_template_manifest.py +60 -0
  209. package/assets/skills/docx/scripts/verify_anchor_atomicity.py +87 -0
  210. package/assets/skills/edit-deployed-website/SKILL.md +27 -0
  211. package/assets/skills/init/SKILL.md +135 -0
  212. package/assets/skills/llm-call/SKILL.md +48 -0
  213. package/assets/skills/llm-call/scripts/llm_call.py +458 -0
  214. package/assets/skills/pdf/SKILL.md +280 -0
  215. package/assets/skills/pdf/docs/advanced-reference.md +711 -0
  216. package/assets/skills/pdf/docs/create-guide.md +437 -0
  217. package/assets/skills/pdf/docs/design-guide.md +204 -0
  218. package/assets/skills/pdf/docs/forms-guide.md +462 -0
  219. package/assets/skills/pdf/docs/html-pdf-spec.md +500 -0
  220. package/assets/skills/pdf/docs/latex-academic-thesis-guide.md +233 -0
  221. package/assets/skills/pdf/docs/latex-technical-book-guide.md +112 -0
  222. package/assets/skills/pdf/docs/pitfalls-index.md +792 -0
  223. package/assets/skills/pdf/docs/read-guide.md +358 -0
  224. package/assets/skills/pdf/docs/reformat-guide.md +238 -0
  225. package/assets/skills/pdf/docs/skill-readme-archive.md +151 -0
  226. package/assets/skills/pdf/docs/troubleshooting.md +86 -0
  227. package/assets/skills/pdf/docs/vision-guide.md +188 -0
  228. package/assets/skills/pdf/scripts/__init__.py +0 -0
  229. package/assets/skills/pdf/scripts/_pdf_read_lib.py +284 -0
  230. package/assets/skills/pdf/scripts/fill/__init__.py +0 -0
  231. package/assets/skills/pdf/scripts/fill/acroform_apply.py +153 -0
  232. package/assets/skills/pdf/scripts/fill/overlay_apply.py +109 -0
  233. package/assets/skills/pdf/scripts/lib/__init__.py +0 -0
  234. package/assets/skills/pdf/scripts/lib/acroform_io.py +170 -0
  235. package/assets/skills/pdf/scripts/lib/cli_utils.py +41 -0
  236. package/assets/skills/pdf/scripts/lib/geometry.py +79 -0
  237. package/assets/skills/pdf/scripts/make.sh +388 -0
  238. package/assets/skills/pdf/scripts/merge.py +112 -0
  239. package/assets/skills/pdf/scripts/pdf_inspect/__init__.py +0 -0
  240. package/assets/skills/pdf/scripts/pdf_inspect/acroform_inspect.py +52 -0
  241. package/assets/skills/pdf/scripts/pdf_inspect/acroform_probe.py +57 -0
  242. package/assets/skills/pdf/scripts/pdf_inspect/layout_scan.py +164 -0
  243. package/assets/skills/pdf/scripts/read_pdf_vision.py +473 -0
  244. package/assets/skills/pdf/scripts/reformat_parse.py +181 -0
  245. package/assets/skills/pdf/scripts/render/__init__.py +0 -0
  246. package/assets/skills/pdf/scripts/render/overlay_preview.py +86 -0
  247. package/assets/skills/pdf/scripts/render/page_rasterize.py +85 -0
  248. package/assets/skills/pdf/scripts/render_html.cjs +205 -0
  249. package/assets/skills/pdf/scripts/validate/__init__.py +0 -0
  250. package/assets/skills/pdf/scripts/validate/geometry_lint.py +124 -0
  251. package/assets/skills/pdf/templates/INDEX.md +90 -0
  252. package/assets/skills/pdf/templates/bilingual-menu-premium/README.md +175 -0
  253. package/assets/skills/pdf/templates/bilingual-menu-premium/skeleton.html +343 -0
  254. package/assets/skills/pdf/templates/brand-guide-2page/README.md +140 -0
  255. package/assets/skills/pdf/templates/brand-guide-2page/skeleton.html +264 -0
  256. package/assets/skills/pdf/templates/data-viz-report/README.md +234 -0
  257. package/assets/skills/pdf/templates/data-viz-report/skeleton.html +835 -0
  258. package/assets/skills/pdf/templates/form-fill-acroform/README.md +195 -0
  259. package/assets/skills/pdf/templates/form-fill-acroform/field_values.template.json +118 -0
  260. package/assets/skills/pdf/templates/latex-academic-thesis/README.md +146 -0
  261. package/assets/skills/pdf/templates/latex-academic-thesis/source.tex +334 -0
  262. package/assets/skills/pdf/templates/latex-technical-book/README.md +130 -0
  263. package/assets/skills/pdf/templates/latex-technical-book/README.template-source.md +62 -0
  264. package/assets/skills/pdf/templates/latex-technical-book/source.tex +439 -0
  265. package/assets/skills/pdf/templates/multi-article-aggregator/README.md +148 -0
  266. package/assets/skills/pdf/templates/multi-article-aggregator/pipeline.md +223 -0
  267. package/assets/skills/pdf/templates/multilang-research-report/README.md +136 -0
  268. package/assets/skills/pdf/templates/multilang-research-report/skeleton.html +242 -0
  269. package/assets/skills/pdf/templates/reformat-default/README.md +136 -0
  270. package/assets/skills/pdf/templates/reformat-default/skeleton.html +204 -0
  271. package/assets/skills/pdf/templates/translate-preserve-layout/README.md +136 -0
  272. package/assets/skills/pdf/templates/translate-preserve-layout/skeleton.html +96 -0
  273. package/assets/skills/pdf/templates/translate-preserve-layout/terminology.template.json +66 -0
  274. package/assets/skills/pptx/SKILL.md +283 -0
  275. package/assets/skills/pptx/references/design-system.md +424 -0
  276. package/assets/skills/pptx/references/editing.md +162 -0
  277. package/assets/skills/pptx/references/element-map.md +229 -0
  278. package/assets/skills/pptx/references/pitfalls.md +205 -0
  279. package/assets/skills/pptx/references/pptxgenjs.md +420 -0
  280. package/assets/skills/pptx/references/preview-selection-writeback.md +65 -0
  281. package/assets/skills/pptx/references/python-pptx-recipes.md +63 -0
  282. package/assets/skills/pptx/references/slide-types.md +413 -0
  283. package/assets/skills/pptx/scripts/alran-ppt-map.cjs +280 -0
  284. package/assets/skills/pptx/scripts/audit_pptx.py +708 -0
  285. package/assets/skills/pptx/scripts/extract_comments.py +468 -0
  286. package/assets/skills/pptx/scripts/extract_images.py +226 -0
  287. package/assets/skills/pptx/scripts/extract_pptx.py +285 -0
  288. package/assets/skills/pptx/scripts/pdf2png.swift +203 -0
  289. package/assets/skills/pptx/scripts/pptx-screenshot.sh +105 -0
  290. package/assets/skills/resume-codex/SKILL.md +53 -0
  291. package/assets/skills/resume-codex/scripts/session-reader.mjs +445 -0
  292. package/assets/skills/skill-creator/SKILL.md +188 -0
  293. package/assets/skills/skill-creator/references/anti-patterns.md +149 -0
  294. package/assets/skills/skill-creator/references/commands-macos-linux.md +38 -0
  295. package/assets/skills/skill-creator/references/commands-windows-powershell.md +48 -0
  296. package/assets/skills/skill-creator/references/description-rubric.md +83 -0
  297. package/assets/skills/skill-creator/references/skill-template.md +101 -0
  298. package/assets/skills/skill-creator/references/when-to-bundle-scripts.md +139 -0
  299. package/assets/skills/skill-creator/scripts/lint-skill.js +226 -0
  300. package/assets/skills/skill-refiner/SKILL.md +137 -0
  301. package/assets/skills/visual-page/SKILL.md +194 -0
  302. package/assets/skills/x-link-reader/SKILL.md +108 -0
  303. package/assets/skills/xlsx/SKILL.md +498 -0
  304. package/assets/skills/xlsx/docs/advanced-reference.md +410 -0
  305. package/assets/skills/xlsx/docs/conventions-guide.md +217 -0
  306. package/assets/skills/xlsx/docs/create-edit-guide.md +410 -0
  307. package/assets/skills/xlsx/docs/pitfalls-index.md +759 -0
  308. package/assets/skills/xlsx/docs/raw-xml-escape-hatch.md +201 -0
  309. package/assets/skills/xlsx/docs/recalc-guide.md +295 -0
  310. package/assets/skills/xlsx/scripts/office/helpers/__init__.py +0 -0
  311. package/assets/skills/xlsx/scripts/office/helpers/merge_runs.py +199 -0
  312. package/assets/skills/xlsx/scripts/office/helpers/simplify_redlines.py +197 -0
  313. package/assets/skills/xlsx/scripts/office/pack.py +159 -0
  314. package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/dml-chart.xsd +1499 -0
  315. package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/dml-chartDrawing.xsd +146 -0
  316. package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/dml-diagram.xsd +1085 -0
  317. package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/dml-lockedCanvas.xsd +11 -0
  318. package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/dml-main.xsd +3081 -0
  319. package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/dml-picture.xsd +23 -0
  320. package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/dml-spreadsheetDrawing.xsd +185 -0
  321. package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/dml-wordprocessingDrawing.xsd +287 -0
  322. package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/pml.xsd +1676 -0
  323. package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/shared-additionalCharacteristics.xsd +28 -0
  324. package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/shared-bibliography.xsd +144 -0
  325. package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/shared-commonSimpleTypes.xsd +174 -0
  326. package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/shared-customXmlDataProperties.xsd +25 -0
  327. package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/shared-customXmlSchemaProperties.xsd +18 -0
  328. package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/shared-documentPropertiesCustom.xsd +59 -0
  329. package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/shared-documentPropertiesExtended.xsd +56 -0
  330. package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/shared-documentPropertiesVariantTypes.xsd +195 -0
  331. package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/shared-math.xsd +582 -0
  332. package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/shared-relationshipReference.xsd +25 -0
  333. package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/sml.xsd +4439 -0
  334. package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/vml-main.xsd +570 -0
  335. package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/vml-officeDrawing.xsd +509 -0
  336. package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/vml-presentationDrawing.xsd +12 -0
  337. package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/vml-spreadsheetDrawing.xsd +108 -0
  338. package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/vml-wordprocessingDrawing.xsd +96 -0
  339. package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/wml.xsd +3646 -0
  340. package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/xml.xsd +116 -0
  341. package/assets/skills/xlsx/scripts/office/schemas/ecma/fouth-edition/opc-contentTypes.xsd +42 -0
  342. package/assets/skills/xlsx/scripts/office/schemas/ecma/fouth-edition/opc-coreProperties.xsd +50 -0
  343. package/assets/skills/xlsx/scripts/office/schemas/ecma/fouth-edition/opc-digSig.xsd +49 -0
  344. package/assets/skills/xlsx/scripts/office/schemas/ecma/fouth-edition/opc-relationships.xsd +33 -0
  345. package/assets/skills/xlsx/scripts/office/schemas/mce/mc.xsd +75 -0
  346. package/assets/skills/xlsx/scripts/office/schemas/microsoft/wml-2010.xsd +560 -0
  347. package/assets/skills/xlsx/scripts/office/schemas/microsoft/wml-2012.xsd +67 -0
  348. package/assets/skills/xlsx/scripts/office/schemas/microsoft/wml-2018.xsd +14 -0
  349. package/assets/skills/xlsx/scripts/office/schemas/microsoft/wml-cex-2018.xsd +20 -0
  350. package/assets/skills/xlsx/scripts/office/schemas/microsoft/wml-cid-2016.xsd +13 -0
  351. package/assets/skills/xlsx/scripts/office/schemas/microsoft/wml-sdtdatahash-2020.xsd +4 -0
  352. package/assets/skills/xlsx/scripts/office/schemas/microsoft/wml-symex-2015.xsd +8 -0
  353. package/assets/skills/xlsx/scripts/office/soffice.py +191 -0
  354. package/assets/skills/xlsx/scripts/office/unpack.py +132 -0
  355. package/assets/skills/xlsx/scripts/office/validate.py +117 -0
  356. package/assets/skills/xlsx/scripts/office/validators/__init__.py +15 -0
  357. package/assets/skills/xlsx/scripts/office/validators/base.py +851 -0
  358. package/assets/skills/xlsx/scripts/office/validators/docx.py +446 -0
  359. package/assets/skills/xlsx/scripts/office/validators/pptx.py +275 -0
  360. package/assets/skills/xlsx/scripts/office/validators/redlining.py +247 -0
  361. package/assets/skills/xlsx/scripts/recalc.py +450 -0
  362. package/chunks/account-commands-JZ6NXTTK.js +2 -0
  363. package/chunks/anthropic-MN33DP4E.js +2 -0
  364. package/chunks/application-ITGAJ4HC.js +2 -0
  365. package/chunks/auth-command-V3RVPLZO.js +2 -0
  366. package/chunks/azure-openai-responses-OWHMUNKC.js +2 -0
  367. package/chunks/chunk-2TF6JAQM.js +2 -0
  368. package/chunks/chunk-33CNY6GP.js +2 -0
  369. package/chunks/chunk-3AODGLMF.js +2 -0
  370. package/chunks/chunk-44VPC5LA.js +38 -0
  371. package/chunks/chunk-4CN3IJFH.js +2 -0
  372. package/chunks/chunk-4PDIO3M6.js +2 -0
  373. package/chunks/chunk-4X22UJQH.js +164 -0
  374. package/chunks/chunk-6255CZPL.js +2 -0
  375. package/chunks/chunk-6P4UKHGR.js +2 -0
  376. package/chunks/chunk-7QLAXRD2.js +1085 -0
  377. package/chunks/chunk-7XYOYZX2.js +2 -0
  378. package/chunks/chunk-A7GMJNA2.js +29 -0
  379. package/chunks/chunk-AGUSPIUP.js +2 -0
  380. package/chunks/chunk-BQ3CF3KE.js +2 -0
  381. package/chunks/chunk-C3CMJAAV.js +3 -0
  382. package/chunks/chunk-CJM7ZJ6W.js +7 -0
  383. package/chunks/chunk-CSOUJVKM.js +2 -0
  384. package/chunks/chunk-D66ZSHXR.js +2 -0
  385. package/chunks/chunk-D7MGU75P.js +2 -0
  386. package/chunks/chunk-E3GLGDGC.js +5 -0
  387. package/chunks/chunk-ENHOPPS7.js +16 -0
  388. package/chunks/chunk-EOR6EDNR.js +2 -0
  389. package/chunks/chunk-EYK25HWR.js +2 -0
  390. package/chunks/chunk-F46IELF5.js +2 -0
  391. package/chunks/chunk-FC4M2B7E.js +2 -0
  392. package/chunks/chunk-FSNYOJPJ.js +2 -0
  393. package/chunks/chunk-FUERW2DW.js +3 -0
  394. package/chunks/chunk-FXOH6TEQ.js +21 -0
  395. package/chunks/chunk-GP52JZMY.js +2 -0
  396. package/chunks/chunk-GRXX6I72.js +2 -0
  397. package/chunks/chunk-GSYHBK5Q.js +6 -0
  398. package/chunks/chunk-HNWBFJNO.js +2 -0
  399. package/chunks/chunk-IIE366LR.js +6706 -0
  400. package/chunks/chunk-IWK7PZP7.js +207 -0
  401. package/chunks/chunk-J3KCPYZT.js +2 -0
  402. package/chunks/chunk-KCLRJQ53.js +59 -0
  403. package/chunks/chunk-LU4RPLJ3.js +2 -0
  404. package/chunks/chunk-LZJYNT32.js +2 -0
  405. package/chunks/chunk-M7GW4VMR.js +27 -0
  406. package/chunks/chunk-MACBL5HF.js +2 -0
  407. package/chunks/chunk-N5NTXCJI.js +2 -0
  408. package/chunks/chunk-N5SVBCUB.js +7 -0
  409. package/chunks/chunk-N6W7ZL26.js +2 -0
  410. package/chunks/chunk-NWB7LFOK.js +131 -0
  411. package/chunks/chunk-OIQ336YE.js +16 -0
  412. package/chunks/chunk-OQNU3VPS.js +30 -0
  413. package/chunks/chunk-OTDNOWXG.js +16 -0
  414. package/chunks/chunk-PNXZWSWT.js +3 -0
  415. package/chunks/chunk-QFUV5PX6.js +2 -0
  416. package/chunks/chunk-QIN5ZBE2.js +2 -0
  417. package/chunks/chunk-QKBN5CGI.js +2 -0
  418. package/chunks/chunk-QPGTKSIQ.js +2 -0
  419. package/chunks/chunk-SIOLUFGG.js +2 -0
  420. package/chunks/chunk-TW23QKAD.js +3 -0
  421. package/chunks/chunk-U3RMPDXU.js +2 -0
  422. package/chunks/chunk-U7U3DJHF.js +2 -0
  423. package/chunks/chunk-VLXX22YO.js +2 -0
  424. package/chunks/chunk-WHD2XVT2.js +2 -0
  425. package/chunks/chunk-WTAJMYF2.js +249 -0
  426. package/chunks/chunk-WWNUAU4P.js +29 -0
  427. package/chunks/chunk-WYANV3IX.js +4 -0
  428. package/chunks/chunk-XAGZ6ZEU.js +9 -0
  429. package/chunks/chunk-XFCC2CI2.js +24 -0
  430. package/chunks/chunk-XQK7JM66.js +2 -0
  431. package/chunks/chunk-YLQXZBEL.js +2 -0
  432. package/chunks/chunk-YPV2X2RG.js +2 -0
  433. package/chunks/chunk-Z6BHCXKT.js +25 -0
  434. package/chunks/chunk-Z6HBNJCA.js +8 -0
  435. package/chunks/chunk-ZQKVUPKA.js +2 -0
  436. package/chunks/chunk-ZQOALVGL.js +2 -0
  437. package/chunks/clipboard-image-PQPC4EHR.js +2 -0
  438. package/chunks/data-dir-LDVKDCJ2.js +2 -0
  439. package/chunks/dist-2BRD4JFU.js +11 -0
  440. package/chunks/dist-EXKHRFQO.js +5 -0
  441. package/chunks/emscripten-module-RD6P2XH5.js +2 -0
  442. package/chunks/emscripten-module-WYNDFH3N.js +2 -0
  443. package/chunks/emscripten-module-XPTEOIWW.js +2 -0
  444. package/chunks/emscripten-module-ZS3PMSDF.js +2 -0
  445. package/chunks/ffi-IO7WZQNG.js +2 -0
  446. package/chunks/ffi-M5UP5J6C.js +2 -0
  447. package/chunks/ffi-ORLOPBB3.js +2 -0
  448. package/chunks/ffi-OUPK6AY6.js +2 -0
  449. package/chunks/google-UJAPMFAB.js +2 -0
  450. package/chunks/google-vertex-VLSF55PW.js +2 -0
  451. package/chunks/install-source-JTIUC4G4.js +2 -0
  452. package/chunks/launcher-FCZ3EDBF.js +61 -0
  453. package/chunks/lifecycle-GY435YMF.js +2 -0
  454. package/chunks/main-TQGGRHTS.js +13 -0
  455. package/chunks/mistral-ZJZUEF2X.js +3 -0
  456. package/chunks/module-6F3E5H7Y-BN7QWGYB.js +2 -0
  457. package/chunks/module-asyncify-R6PWJ6ZV-P4FWSBAY.js +2 -0
  458. package/chunks/multipart-parser-L6M455MS.js +2 -0
  459. package/chunks/network-proxy-U72JCK2I.js +2 -0
  460. package/chunks/openai-codex-responses-FPCDNRL5.js +2 -0
  461. package/chunks/openai-completions-D32YW6KL.js +2 -0
  462. package/chunks/openai-responses-ZCGSENM4.js +2 -0
  463. package/chunks/openrouter-G2EHY5BD.js +2 -0
  464. package/chunks/otel-OHXIZ666.js +2 -0
  465. package/chunks/package-contract-GVXTMJ3N.js +2 -0
  466. package/chunks/pdfjs-SHZAF7PF.js +107 -0
  467. package/chunks/photon_rs-C52RL4CI.js +3 -0
  468. package/chunks/plugin-command-OSAFHS7C.js +2 -0
  469. package/chunks/provider-command-SKTCHD4E.js +2 -0
  470. package/chunks/questionnaire-bridge-ISQOCYWY.js +2 -0
  471. package/chunks/run-acp-command-SG2BDMFJ.js +2 -0
  472. package/chunks/run-exec-command-5ADSQR2Z.js +15 -0
  473. package/chunks/skills-command-XXXEZAG6.js +2 -0
  474. package/chunks/src-DNIDEMVV.js +2 -0
  475. package/chunks/src-IBHIRTD7.js +2 -0
  476. package/chunks/telemetry-J7ZLGF5X.js +2 -0
  477. package/chunks/telemetry-command-COQG2AKK.js +5 -0
  478. package/chunks/tools-WDBB2JKV.js +2 -0
  479. package/chunks/undici-TUGHZJSA.js +2 -0
  480. package/chunks/update-NB6OD572.js +14 -0
  481. package/chunks/update-hint-ED7O67WU.js +3 -0
  482. package/chunks/wechat-onboard-UWXQW2HT.js +2 -0
  483. package/cli.js +5 -0
  484. package/configs/data-minimal.yaml +50 -0
  485. package/embedded/alran-tools/cli.mjs +4961 -0
  486. package/embedded/alran-tools/manifest.json +25 -0
  487. package/emscripten-module.wasm +0 -0
  488. package/image-preview-worker.js +2 -0
  489. package/internal-bin/alran-tools +9 -0
  490. package/internal-bin/alran-tools.cmd +8 -0
  491. package/matrix-mcp-stdio.js +4 -0
  492. package/native/darwin/prebuilds/darwin-arm64/darwin-modifiers.node +0 -0
  493. package/native/darwin/prebuilds/darwin-x64/darwin-modifiers.node +0 -0
  494. package/native/win32/prebuilds/win32-arm64/win32-console-mode.node +0 -0
  495. package/native/win32/prebuilds/win32-x64/win32-console-mode.node +0 -0
  496. package/package.json +38 -4
  497. package/photon_rs_bg.wasm +0 -0
  498. package/quickjs-worker.js +152 -0
  499. package/vendor/java-proxy-agent/build.ts +97 -0
  500. package/vendor/java-proxy-agent/srt-proxy-agent.jar +0 -0
  501. package/vendor/seccomp/arm64/apply-seccomp +0 -0
  502. package/vendor/seccomp/build.ts +74 -0
  503. package/vendor/seccomp/x64/apply-seccomp +0 -0
  504. package/vendor/srt-win/arm64/srt-win.exe +0 -0
  505. package/vendor/srt-win/build.ts +40 -0
  506. package/vendor/srt-win/x64/srt-win.exe +0 -0
@@ -0,0 +1,498 @@
1
+ ---
2
+ name: xlsx
3
+ description: >-
4
+ Spreadsheet skill — read, edit, create, and convert .xlsx/.xlsm/.csv/.tsv files.
5
+ Trigger when a spreadsheet file is the primary input or output: editing columns, formulas, formatting, charting, cleaning messy data, or creating new spreadsheets.
6
+ Not for Word/HTML/PDF deliverables even if tabular data is involved.
7
+ license: MIT
8
+ ---
9
+
10
+ # xlsx
11
+
12
+ A pragmatic, recipe-first guide for reading, editing, creating, and
13
+ recalculating `.xlsx` / `.xlsm` / `.csv` / `.tsv` files. The default
14
+ pairing is **pandas for tabular data + openpyxl for formulas, styles,
15
+ named ranges, and charts**. Recalculation through
16
+ [`scripts/recalc.py`](scripts/recalc.py) (LibreOffice headless) is
17
+ mandatory before delivery — openpyxl writes formulas as strings and
18
+ never evaluates them.
19
+
20
+ > **Formula-first.** A spreadsheet without live formulas is just a
21
+ > CSV with a fancier extension. **Every computed value** — totals,
22
+ > averages, growth rates, ratios, cross-sheet references, percent
23
+ > changes, anything derivable from other cells — **must be written as
24
+ > a live `=…` formula**, not as the pre-computed number. Hard-coded
25
+ > numbers belong only in the **Assumptions** block (inputs the user
26
+ > can flip to re-run the model). When in doubt, write the formula.
27
+ > Full convention in §5 and
28
+ > [`docs/conventions-guide.md`](docs/conventions-guide.md) §4.
29
+ >
30
+ > **❌ The most common anti-pattern.** Loading a workbook with pandas,
31
+ > computing derived columns in Python (`df["total"] = df["a"] + df["b"]`,
32
+ > `df.groupby(...).sum()`, etc.), then writing the result back with
33
+ > `df.to_excel(...)` ships **static numbers** — the workbook becomes a
34
+ > dead snapshot the moment any input changes. Use pandas/polars only
35
+ > to load and clean **raw inputs**; emit every derived value as a live
36
+ > `=` formula via openpyxl (§3.2). This rule applies regardless of how
37
+ > easy it would be to compute the value in Python first.
38
+
39
+ > **Spreadsheet output only.** For Word documents, PowerPoint slides,
40
+ > HTML reports, standalone Python scripts, database pipelines, or the
41
+ > Google Sheets API, switch to the matching skill.
42
+
43
+ ## Operational rules — read before doing anything
44
+
45
+ > **1. Match user query against [`docs/pitfalls-index.md`](docs/pitfalls-index.md)
46
+ > FIRST.** It contains 8 production-ready **canonical query templates**
47
+ > (X1–X8), each with a `Match signatures` block (sample queries) and a
48
+ > complete executable prompt that already encodes Formula-first, recalc
49
+ > verification, formula-count gate, sample-data-integrity, slicer
50
+ > handling, and every other rule below. Workflow:
51
+ >
52
+ > 1. Scan the Quick lookup table — match user's query keywords to a row.
53
+ > 2. **Copy the matching canonical query verbatim**, substitute the
54
+ > `Slots` (e.g. `{INPUT}`, `{COMPANY}`, `{OUTPUT_XLSX}`) with the
55
+ > user's actual values, and execute step-by-step.
56
+ > 3. Multiple partial matches → fuse: take the strictest verification
57
+ > from each, never relax a constraint.
58
+ > 4. No match → fall back to the Decision Tree / per-section guides below.
59
+ >
60
+ > Do NOT skip verification steps in the canonical queries — every
61
+ > "ship a wrong workbook" failure traces back to skipping recalc,
62
+ > total_formulas check, or row-count canary.
63
+
64
+ > **2. Formula-first is non-negotiable.** A delivery that ships static
65
+ > numbers where formulas were possible is a **failed delivery** — even
66
+ > if every number is numerically correct the moment you saved it. The
67
+ > user's first edit will expose the lie. Hardcode only the Assumptions
68
+ > block; everything derivable from other cells goes in as `=…`. Full
69
+ > regime in §5.
70
+
71
+ > **3. `total_formulas == 0` is a red flag, not a green light.** A
72
+ > "success" recalc with zero formulas means the workbook is a static
73
+ > dump — the user can't audit, can't re-run scenarios, can't
74
+ > introspect derivations. Treat it as a delivery failure and rewrite
75
+ > via §3.2 / openpyxl `=` formulas. The only legitimate exception is
76
+ > a workbook the user explicitly asked to be a static snapshot
77
+ > (in which case `pandas.to_excel` is the right tool, not this skill).
78
+
79
+ > **4. Source-data-integrity rule — never `df.sample(N)` / `df.head(N)`
80
+ > on the raw sheet.** Down-sampling 400k rows to 100k "because openpyxl
81
+ > writes are slow" silently destroys every aggregation built on top —
82
+ > the pivot or `=SUMIF` summary will be off by ~75% and look entirely
83
+ > plausible. **Write the full row count, even if it takes minutes.**
84
+ > If write throughput is the real bottleneck, switch the writer
85
+ > (xlsxwriter §3.3, or `Workbook(write_only=True)` streaming pattern
86
+ > in [`docs/advanced-reference.md`](docs/advanced-reference.md) §6),
87
+ > never the sample size.
88
+
89
+ > **5. Summaries must be Excel-native — pivot tables or `=SUMIFS` /
90
+ > `=COUNTIFS` over the Raw sheet, never Python `groupby` written back
91
+ > as values.** This is the same rule as §3 phrased for the most
92
+ > common offender. The user expects: edit a Raw row, hit recalc, see
93
+ > the totals move. Static summaries break that contract silently.
94
+
95
+ > **6. Slicers cannot be authored from scratch by openpyxl.** The
96
+ > `xl/slicers/*.xml` part requires GUID-bound pivot cache references
97
+ > that openpyxl has no API for. Two production paths:
98
+ > (a) template-inheritance — author a `template.xlsx` once in Excel
99
+ > or LibreOffice with the slicer wired to a named range, then
100
+ > `load_workbook(template) → write into named range → save as new`;
101
+ > (b) raw-XML transplant from a known-good template via
102
+ > `scripts/office/{unpack,pack}.py`. **If the user asks for a slicer
103
+ > and you have no template, say so before silently downgrading to a
104
+ > static dropdown.**
105
+
106
+ > **7. Don't suppress stderr.** `2>/dev/null` is **never** the right
107
+ > choice in this skill (`recalc.py`, `soffice`, `pdfinfo`, `unpack.py`,
108
+ > `pack.py`). On failure you lose the only signal that explains why
109
+ > and have to rerun blind. If output is too noisy, redirect to a log
110
+ > file and grep on demand:
111
+ > ```bash
112
+ > python scripts/recalc.py file.xlsx 60 2>/tmp/recalc.log
113
+ > # If JSON shows status != "success" or exit != 0, then:
114
+ > # grep -in "error\|trace\|fail" /tmp/recalc.log | head -20
115
+ > ```
116
+
117
+ > **8. When the user states a numeric range for a derived value,
118
+ > enforce it in the formula.** "Composite score 0–100" → wrap the
119
+ > formula with `=ROUND(MIN(MAX(raw, 0), 100), 1)`. Don't ship a
120
+ > 0–1804 column and blame "data anomaly". Spot-check `MIN()` /
121
+ > `MAX()` of the output column after recalc.
122
+
123
+ > **9. 500k+ rows: pandas/polars first, not openpyxl row walking.**
124
+ > For large tabular inputs (roughly **500,000+ rows**, or hundreds of MB),
125
+ > default to `pandas`/`polars` for reading, filtering, type normalization,
126
+ > joins, and QA spot-checks. Do **not** iterate cell-by-cell with openpyxl to
127
+ > inspect or transform the source workbook — it is too slow and encourages
128
+ > accidental sampling. Use openpyxl only at the output boundary for formulas,
129
+ > styles, charts, templates, and final `.xlsx` assembly. If the output is a
130
+ > static raw-data dump, `DataFrame.to_excel`/`xlsxwriter` is acceptable; if it
131
+ > contains derived values, write full raw rows and Excel-native `=` formulas.
132
+
133
+
134
+ > **10. Non-standard XLSX packages: trust recalc raw-XML fallback.**
135
+ > Workbooks with heavy merged cells, charts/drawings, or vendor-generated XML
136
+ > can make openpyxl crash even after LibreOffice recalculated successfully.
137
+ > `scripts/recalc.py` now catches openpyxl parse failures and falls back to a
138
+ > raw worksheet XML scanner. If JSON returns `scanner: "raw_xml_fallback"` with
139
+ > `status: success` / `errors_found`, treat it as authoritative and do not
140
+ > retry blindly. Use the `compatibility_hint` field to decide whether to avoid
141
+ > downstream openpyxl rewrites. Details in [`docs/recalc-guide.md`](docs/recalc-guide.md) §10.
142
+
143
+ For deeper material — creation and edit recipes, recalc internals,
144
+ financial-model conventions, large-file alternatives — see
145
+ [`docs/`](docs/).
146
+
147
+ ---
148
+
149
+ ## 1. Scope and When to Use
150
+
151
+ This skill covers the everyday spreadsheet chores an LLM agent is most
152
+ often asked to perform end-to-end:
153
+
154
+ - inspecting an existing workbook (sheet names, merged regions, headers)
155
+ - reading tabular data into pandas / polars for analysis or QA
156
+ - creating a new workbook with formulas, styles, named ranges, and charts
157
+ - editing an existing workbook in place (insert / delete / restyle / replace)
158
+ - recalculating every formula via [`scripts/recalc.py`](scripts/recalc.py)
159
+ and verifying `total_errors == 0` in the JSON
160
+ - enforcing the financial-model conventions in §5 on every delivery
161
+ - converting between tabular formats (`csv` ↔ `xlsx` ↔ `ods` ↔ `tsv`)
162
+
163
+ Use a different approach when:
164
+
165
+ - the deliverable is a Word document, slide deck, standalone script, or
166
+ database pipeline — switch to the matching skill (`docx`, `pptx`, etc.)
167
+ - the workflow is read-only and the user just wants the cell values
168
+ printed — `extract-text` (`docs/advanced-reference.md` §5) is enough
169
+ - the workbook lives behind the Google Sheets API rather than on disk
170
+
171
+ ---
172
+
173
+ ## 2. Decision Tree
174
+
175
+ ```
176
+ What does the user want from / for this workbook?
177
+ |
178
+ +-- Read tabular data only ───────────────> pandas / polars -> §3.1, §3.4
179
+ +-- Inspect quickly without code ─────────> extract-text CLI -> docs/advanced-reference.md §5
180
+ +-- Create a new workbook ────────────────> openpyxl -> §3.2
181
+ +-- Edit an existing workbook in place ───> openpyxl -> §3.2
182
+ +-- Output has any derived/computed cells > openpyxl + `=` formulas -> §3.2, §5
183
+ +-- Very large workbook (500k+ rows) ─────> pandas/polars read + openpyxl/xlsxwriter output -> §3.1, §3.4, docs/advanced-reference.md §6
184
+ +-- Recalculate formulas (mandatory) ─────> scripts/recalc.py -> §4.1
185
+ +-- Convert format (csv ↔ xlsx ↔ ods) ────> pyexcel -> §3.5
186
+ +-- Sandboxed env (no AF_UNIX) ───────────> office.soffice shim -> §4.1
187
+ ```
188
+
189
+ **Default rule.** Read with pandas, write and edit with openpyxl,
190
+ recalculate with `scripts/recalc.py`. Drop to xlsxwriter when the
191
+ workload is write-only and throughput-bound; drop to polars when the
192
+ input file is too big for pandas to hold in memory. **Never use
193
+ `pandas.to_excel` / `polars.write_excel` for derived/computed values
194
+ — those write static numbers, not live formulas. See §3.1's ⚠️ box.**
195
+
196
+ ---
197
+
198
+ ## 3. Library Cookbook
199
+
200
+ Five subsections, one per library. Each entry is a minimum viable
201
+ example plus a short note. Deeper recipes — full styling, conditional
202
+ formatting, charts, edit gotchas — live in
203
+ [`docs/create-edit-guide.md`](docs/create-edit-guide.md).
204
+
205
+ ### 3.1 pandas — tabular read / write (default)
206
+
207
+ ```python
208
+ import pandas as pd
209
+
210
+ frame = pd.read_excel("mau_forecast.xlsx", engine="openpyxl") # first sheet
211
+ sheets = pd.read_excel("mau_forecast.xlsx", sheet_name=None) # {sheet: DataFrame}
212
+ frame.to_excel("clean_mau.xlsx", sheet_name="clean", index=False)
213
+ ```
214
+
215
+ > ⚠️ **`to_excel()` writes static numbers only — no formulas survive.**
216
+ > Use it strictly for **raw data dumps**: cleaned input data, exported
217
+ > query results, anything where every cell is itself a primary value.
218
+ > The moment the deliverable contains a derived value — totals,
219
+ > averages, ratios, growth rates, anything computable from other cells
220
+ > — switch to §3.2 and write it as a live `=` formula. **Never** do
221
+ > `df["total"] = df["a"] + df["b"]; df.to_excel(...)`: the workbook
222
+ > will look fine until the user edits an input and discovers the
223
+ > "totals" don't move. For aggregations across rows/sheets, write the
224
+ > raw rows here and emit `=SUM(...)` / `=SUMIF(...)` on the openpyxl
225
+ > side (`docs/advanced-reference.md` §6 has the worked large-file
226
+ > example).
227
+
228
+ Default for any "read tabular data" job. For 500k+ rows, prefer pandas/polars
229
+ for source inspection, filtering, joins, and QA; avoid openpyxl cell-by-cell
230
+ source traversal. Pair with openpyxl only on the write side when you need
231
+ formulas or formatting.
232
+
233
+ ### 3.2 openpyxl — create and edit (default for write + edit)
234
+
235
+ ```python
236
+ from openpyxl import Workbook, load_workbook
237
+ from openpyxl.styles import Font
238
+
239
+ book = Workbook() # create
240
+ sheet = book.active
241
+ sheet["A1"], sheet["B1"], sheet["C1"], sheet["D1"], sheet["E1"] = (
242
+ "Quarter", "MAU (mm)", "Tokens/MAU", "Take-rate", "ARR (¥mm)"
243
+ )
244
+ # Inputs (Assumptions) — hardcoded primary values; §5.2 requires blue.
245
+ input_font = Font(color="0000FF")
246
+ sheet["A2"], sheet["B2"], sheet["C2"], sheet["D2"] = "2025Q3", 148, 27, 0.85
247
+ for ref in ("B2", "C2", "D2"):
248
+ sheet[ref].font = input_font
249
+ # Derived ARR — references inputs, not literal numbers; §5.2 requires black.
250
+ sheet["E2"] = "=B2*C2*D2"
251
+ sheet["E2"].font = Font(color="000000")
252
+ book.save("mau_forecast.xlsx")
253
+
254
+ book = load_workbook("mau_forecast.xlsx") # edit
255
+ book["Sheet"]["D2"] = 0.90 # flip take-rate
256
+ # E2 still says "=B2*C2*D2" — recalc.py will refresh the cached value
257
+ book.save("mau_forecast.xlsx")
258
+ ```
259
+
260
+ The edit example flips the **input** (`D2`), not the result — that is
261
+ the whole point of formula-first. If `E2` had been written as the
262
+ literal `=148*27*0.85`, this edit would have left ARR stale.
263
+ `data_only=True` is **read-only safe only** — saving such a workbook
264
+ permanently replaces every formula with its cached value. See
265
+ [`docs/create-edit-guide.md`](docs/create-edit-guide.md) §7.
266
+
267
+ ### 3.3 xlsxwriter — write-only throughput
268
+
269
+ ```python
270
+ import xlsxwriter
271
+
272
+ book = xlsxwriter.Workbook("big_table.xlsx")
273
+ sheet = book.add_worksheet("Tokens")
274
+ for r, row in enumerate(rows):
275
+ sheet.write_row(r, 0, row)
276
+ sheet.write_formula(0, 5, "=SUM(F2:F100001)")
277
+ book.close()
278
+ ```
279
+
280
+ Faster than openpyxl on six-figure-row writes; cannot reopen what it
281
+ wrote. Reach for it when the workbook is the terminal output.
282
+
283
+ ### 3.4 polars — fast read for huge files
284
+
285
+ ```python
286
+ import polars as pl
287
+
288
+ frame = pl.read_excel("big.xlsx")
289
+ as_pandas = frame.to_pandas() # interop
290
+ ```
291
+
292
+ > ⚠️ **`polars.write_excel()` writes static numbers — same trap as
293
+ > `pandas.to_excel`.** No formulas, no charts, no styles. Polars is a
294
+ > read-side accelerator for files above ~500k rows; for the write side,
295
+ > always pair with openpyxl and emit derived values as `=` formulas
296
+ > (`docs/advanced-reference.md` §6 has the worked large-file pattern).
297
+
298
+ ### 3.5 pyexcel — format-agnostic conversion
299
+
300
+ ```python
301
+ import pyexcel as pe
302
+
303
+ records = pe.get_records(file_name="upload.xlsx") # also csv / ods / tsv
304
+ pe.save_book_as(file_name="raw.csv", dest_file_name="clean.xlsx")
305
+ ```
306
+
307
+ Use it when the input format is unknown ahead of time, or when the
308
+ pipeline accepts several formats.
309
+
310
+ ---
311
+
312
+ ## 4. Recalculation Routes
313
+
314
+ openpyxl writes formulas as strings and never evaluates them.
315
+ Recalculation is mandatory before delivery; it refreshes the cached
316
+ values and surfaces the seven Excel error markers.
317
+
318
+ ### 4.1 `scripts/recalc.py` — LibreOffice headless (default)
319
+
320
+ ```bash
321
+ python scripts/recalc.py mau_forecast.xlsx 30
322
+ ```
323
+
324
+ Sample success output on stdout:
325
+
326
+ ```json
327
+ {
328
+ "status": "success",
329
+ "total_errors": 0,
330
+ "total_formulas": 42
331
+ }
332
+ ```
333
+
334
+ If `status == "errors_found"`, the JSON includes an `error_summary`
335
+ keyed by error marker with up to 20 locations per marker. For the full
336
+ JSON schema, the seven error markers, the macro install path, the
337
+ cross-platform timeout wrapper, and the AF_UNIX sandbox shim, see
338
+ [`docs/recalc-guide.md`](docs/recalc-guide.md).
339
+
340
+ ### 4.2 `xlcalculator` / `formulas` — pure-Python fallback
341
+
342
+ In CI containers or serverless runtimes without LibreOffice, fall back
343
+ to [`xlcalculator`](https://github.com/bradbase/xlcalculator) or
344
+ [`formulas`](https://github.com/vinci1it2000/formulas). Neither
345
+ supports array formulas, pivot tables, or custom functions — for
346
+ delivery, always rerun `recalc.py` on a host with LibreOffice. Limits
347
+ in [`docs/recalc-guide.md`](docs/recalc-guide.md) §8.
348
+
349
+ ---
350
+
351
+ ## 5. Conventions for Excel Outputs
352
+
353
+ **Formula-first as the unifying rule.** All four sub-sections below
354
+ exist to enforce one principle: a delivered workbook is a *live model*
355
+ the user can adjust by editing inputs and watching every dependent
356
+ cell recompute. The colour code (§5.2 — black for formulas, blue for
357
+ hardcoded inputs) makes it obvious at a glance whether a number is
358
+ derived or assumed; the recalc gate (§5.1) makes sure every formula
359
+ actually evaluates; the number formats (§5.3) make sure the recomputed
360
+ values stay readable. **Whenever you can express a value as a formula
361
+ referencing other cells, do so** — never paste a pre-computed total /
362
+ average / ratio / growth rate as a literal number. Hard-coded numbers
363
+ belong only in the leading Assumptions block (full rationale in
364
+ [`docs/conventions-guide.md`](docs/conventions-guide.md) §4).
365
+
366
+ ### 5.1 Professional font and zero formula errors
367
+
368
+ Default body font is one of Calibri / Arial / Times New Roman, used
369
+ consistently throughout the workbook. Every workbook with formulas
370
+ must pass `scripts/recalc.py` with `total_errors == 0` before delivery.
371
+
372
+ ### 5.2 Color coding
373
+
374
+ | Color | Hex | RGB | Meaning | Anti-pattern |
375
+ |---|---|---|---|---|
376
+ | Black | `000000` | `0,0,0` | Every formula and computed result | Setting `=A1+B1` to blue makes it look like a manual input |
377
+ | Blue | `0000FF` | `0,0,255` | Hard-coded inputs and scenario assumptions | Setting `=Sheet2!A1` to blue hides the cross-sheet link |
378
+ | Green | `008000` | `0,128,0` | Same-workbook cross-sheet links | Coloring a cross-file link green hides the external dependency |
379
+ | Red | `FF0000` | `255,0,0` | Cross-file external links | Coloring same-sheet `=A1` red implies a fake external dependency |
380
+ | Yellow (fill) | `FFFF00` | `255,255,0` background | Critical assumptions awaiting review | Coloring every cell yellow drowns out the cells that need review |
381
+
382
+ Black-first ordering matches the reviewer's scan order — see
383
+ [`docs/conventions-guide.md`](docs/conventions-guide.md) §1 for the
384
+ rationale. Three- and six-digit hex are equivalent (`#000` ≡ `#000000`);
385
+ both `openpyxl` and `xlsxwriter` accept either form.
386
+
387
+ ### 5.3 Number formatting
388
+
389
+ | Type | Format | Rationale |
390
+ |---|---|---|
391
+ | Year | text (`"FY2025"`) | Numeric `2025` gets thousands-separated to `2,025` |
392
+ | Currency | `$#,##0` or `¥#,##0` with the unit (`mm` / `bn` / `k`) in the header | The unit lives once per column, not per cell |
393
+ | Zero | `"$#,##0;($#,##0);-"` | Em-dash separates "zero by intent" from "missing value" |
394
+ | Percentage | `0.0%` | One decimal is enough for a scan; two is false precision |
395
+ | Multiple | `0.0x` | Used for valuation multiples (EV/EBITDA, P/S, P/E) |
396
+ | Negative | `(123)` (parentheses) | Accounting convention; minus signs blend into table grids |
397
+ | Hardcode | `Source: …` annotation in the next column or as a cell comment | Reviewer can audit every input back to its source |
398
+
399
+ Sample headers: `ARR (¥mm)` / `Tokens (bn)` / `MAU (mm)` /
400
+ `Token unit price 1.2x`. Full hardcode-source grammar and five worked
401
+ examples in [`docs/conventions-guide.md`](docs/conventions-guide.md) §3.
402
+
403
+ ### 5.4 Preserve existing templates
404
+
405
+ When updating someone else's template, observe before editing — colors,
406
+ column widths, fonts, merged cells, number formats, and conditional
407
+ formatting from the existing file all override this skill's defaults.
408
+ Checklist in [`docs/conventions-guide.md`](docs/conventions-guide.md) §5.
409
+
410
+ ---
411
+
412
+ ## 6. Reference Index
413
+
414
+ | File | Purpose |
415
+ |---|---|
416
+ | [`docs/pitfalls-index.md`](docs/pitfalls-index.md) | **Read first when the task matches a known case.** 8 evaluation cases keyed by task signature → past failure → recommended trace |
417
+ | [`docs/create-edit-guide.md`](docs/create-edit-guide.md) | openpyxl create / edit / chart recipes plus merged-cell and shared-strings gotchas |
418
+ | [`docs/recalc-guide.md`](docs/recalc-guide.md) | `recalc.py` reference — macro path, JSON schema, AF_UNIX shim, timeouts, alternatives |
419
+ | [`docs/conventions-guide.md`](docs/conventions-guide.md) | Color coding, number formats, formula construction, hardcode source documentation |
420
+ | [`docs/raw-xml-escape-hatch.md`](docs/raw-xml-escape-hatch.md) | Surgical XML escape hatch via `scripts/office/{pack,unpack}.py` for the few files openpyxl can't safely round-trip (VBA, pivot caches, slicers, connections, externalLinks) |
421
+ | [`docs/advanced-reference.md`](docs/advanced-reference.md) | polars / duckdb / xlcalculator / pyexcel / extract-text / large-file / CI workflows |
422
+ | `scripts/recalc.py` | LibreOffice-driven recalculation entry point — mandatory final step |
423
+ | `scripts/office/soffice.py` | Sandbox-friendly LibreOffice runner with AF_UNIX shim |
424
+ | `scripts/office/{pack,unpack,validate}.py` | DOCX / PPTX / XLSX zip helpers + XSD validate (cross-format; schemas live under `office/schemas/`) |
425
+
426
+ ---
427
+
428
+ ## 7. Troubleshooting
429
+
430
+ | Symptom | Likely cause | First thing to try |
431
+ |---|---|---|
432
+ | Recalc returns `#REF!` after row insertion | Old formulas point at the row that just shifted | Search the workbook for `#REF!`; replace with the new coordinate; rerun `recalc.py` |
433
+ | Recalc returns `#DIV/0!` | Denominator evaluates to zero or empty | Wrap with `IFERROR(num/denom, 0)` or `IF(denom=0, "", num/denom)` |
434
+ | Recalc returns `#N/A` | `VLOOKUP` / `MATCH` key not found in the lookup column | Check key whitespace, case, and type (`123` vs `"123"`); confirm the lookup column is contiguous |
435
+ | `recalc.py` exits with `soffice timed out` | LibreOffice hung on a heavy workbook | Raise the second positional arg (`python scripts/recalc.py file.xlsx 180`); if it persists, see `docs/recalc-guide.md` §5 |
436
+ | `recalc.py` errors with `Address already in use` / AF_UNIX denied | Sandbox blocks AF_UNIX (macOS App Sandbox / Linux seccomp) | Auto-handled by `office.soffice` shim; ensure `gcc` is on `PATH` so the shim can compile (see `docs/recalc-guide.md` §6) |
437
+ | `iter_rows()` returns `None` for cells that visibly have a value | Cells live inside a merged region; only the anchor carries the value | `unmerge_cells()` first, broadcast the anchor value, then re-merge if layout matters (see `docs/create-edit-guide.md` §9) |
438
+ | `save()` deletes every formula in the workbook | The file was opened with `data_only=True` | Reload with `load_workbook(path)` (default `data_only=False`); `data_only=True` is read-only safe only |
439
+ | `load_workbook` raises `TypeError: expected <class 'int'>` after `recalc.py` ran | LibreOffice rewrote the workbook's `<mergeCell>` XML in a form openpyxl's default parser cannot read | The file itself is intact and openable in Excel — `recalc.py` already returned `status: success` via its raw-XML fallback (see `docs/recalc-guide.md` §9). For programmatic readback, retry with `load_workbook(path, read_only=True, data_only=True)` (streaming reader skips the merged-cell parser); when you also need formula strings, drop to the raw-XML pattern in `docs/create-edit-guide.md` §11 |
440
+ | Polars `write_excel` output has no formulas, no charts, no styles | Expected — polars does not write formulas / charts / styles | Use openpyxl on the write side (see `docs/advanced-reference.md` §6) |
441
+ | `load_workbook` strips VBA / pivot tables / slicers / connections | openpyxl can't round-trip these binary or strongly-coupled artefacts | Drop to `scripts/office/unpack.py` + manual XML edit + `scripts/office/pack.py`; see `docs/raw-xml-escape-hatch.md` §1 for the full no-go table |
442
+
443
+ ---
444
+
445
+ ## 8. Environment
446
+
447
+ | Dependency | Purpose | Install |
448
+ |---|---|---|
449
+ | Python 3.9+ | All `.py` scripts | system |
450
+ | `openpyxl` | Read / write `.xlsx` with formulas, styles, named ranges | `pip install openpyxl` |
451
+ | `pandas` | Tabular read / write (default for §3.1) | `pip install pandas openpyxl` |
452
+ | `polars` (optional) | Fast read for large files (§3.4) | `pip install polars` |
453
+ | `xlsxwriter` (optional) | Write-only throughput (§3.3) | `pip install xlsxwriter` |
454
+ | `pyexcel` (optional) | Format-agnostic conversion (§3.5) | `pip install pyexcel pyexcel-xlsx` |
455
+ | LibreOffice (`soffice` on PATH) | `recalc.py` headless recalculation | macOS: `brew install --cask libreoffice`; Debian/Ubuntu: `apt install libreoffice` |
456
+ | `coreutils` (macOS) | Provides `gtimeout` for the recalc timeout wrapper | `brew install coreutils` (optional; falls back to `subprocess` kwarg) |
457
+
458
+ `scripts/office/soffice.py` auto-activates an `LD_PRELOAD` AF_UNIX shim
459
+ when the host sandbox denies AF_UNIX (macOS App Sandbox, Linux seccomp);
460
+ `recalc.py` already routes through `get_soffice_env()`, so it is transparent.
461
+
462
+ For long-running batch jobs (hundreds of workbooks per hour), swap
463
+ `soffice` per-call for [`unoserver`](https://github.com/unoconv/unoserver) —
464
+ see [`docs/recalc-guide.md`](docs/recalc-guide.md) §7.
465
+
466
+ ## Windows (win32) platform notes
467
+
468
+ Scripts and code examples in this skill use bash syntax (heredocs, pipes, `python3`). On Windows,
469
+ execute them via **Git Bash**:
470
+
471
+ ```powershell
472
+ # Raw XML escape hatch
473
+ bash -c "python scripts/office/unpack.py input.xlsx /tmp/work/"
474
+ bash -c "python scripts/office/pack.py /tmp/work/ output.xlsx"
475
+
476
+ # Piped inspection
477
+ bash -c "python -c \"from openpyxl import load_workbook; wb=load_workbook('file.xlsx', read_only=True); print(wb.sheetnames)\""
478
+ ```
479
+
480
+ > **⚠️ recalc.py limitation on Windows:** `scripts/recalc.py` installs a LibreOffice Basic macro
481
+ > to `~/.config/libreoffice/...` (Linux path). On Windows, LibreOffice stores macros in
482
+ > `%APPDATA%\LibreOffice\4\user\basic\Standard\`. Until `recalc.py` is patched to resolve the
483
+ > Windows macro directory, recalc will fail to find the macro. **Workaround:** open the workbook
484
+ > in LibreOffice GUI, run Ctrl+Shift+F9 (recalculate all), then save.
485
+
486
+ **Key differences on Windows:**
487
+
488
+ | Unix reference | Windows handling |
489
+ |---|---|
490
+ | `python3` | Use `python` — Git Bash finds it on PATH if installed |
491
+ | `python3 <<EOF ... EOF` | Use `bash -c "python -c '...'"` or write a .py file and run it |
492
+ | `/tmp/` | Git Bash maps `/tmp/` automatically — scripts work as-is |
493
+ | `grep -in ... \| head -20` | Works inside `bash -c "..."` |
494
+ | `brew install --cask libreoffice` | `winget install TheDocumentFoundation.LibreOffice` |
495
+ | `coreutils` (`gtimeout`) | Not needed — `recalc.py` falls back to `subprocess` timeout kwarg |
496
+
497
+ **If Git Bash or any tool is missing**, read the `alran` skill's
498
+ `references/windows-tool-bootstrap.md` for detection + auto-install commands.