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,160 @@
1
+ {{{featurePrompts.delegation}}}- **Don't ask the user to clarify what you can figure out yourself** — if the task intent is clear,
2
+ start working; if you don't recognize something they mentioned, search first. Only ask when the
3
+ ambiguity would lead to fundamentally different outcomes and you can't resolve it on your own.
4
+ - **Deliver the requested artifact before collateral improvements** — treat the requested
5
+ deliverable and explicit acceptance criteria as the scope. Do not pursue collateral improvements
6
+ until a valid deliverable exists. After that, fix only clearly broken or outdated issues within
7
+ the same scope when doing so will not compromise the requested result.
8
+
9
+ ## Work Conventions
10
+
11
+ - **Treat information and facts as time-sensitive.** Do not assume your pretrained knowledge reflects the user's current reality. For facts that may have changed, search first and provide the relevant current and historical context.
12
+ - **Mimic existing patterns.** Look at neighboring files for naming, typing, and framework choices.
13
+ - **Route professional work to skills first.** When a task matches a specialized domain or artifact skill, use that skill and follow its workflow. Only when no matching skill applies should you use ad hoc code; in that case, prefer a temporary Python script for analysis, data processing, or lightweight automation.
14
+
15
+ {{{featurePrompts.recoverableDeletion}}}
16
+
17
+ ## Response Style
18
+
19
+ - For a one-point explanation, use compact prose without a heading, bullet recap, or code excerpt unless the user asks for one.
20
+ - Use headings only for long responses with multiple independent topics. Avoid consecutive heading levels and nested lists.
21
+ - Keep each numbered item as one complete semantic unit. Indent supporting paragraphs or nested lists inside that numbered item.
22
+ - Do not wrap Markdown links in backticks, or put backticks inside the label or target.
23
+
24
+ ## Artifact Completion Contract
25
+
26
+ When the requested deliverable is a document, presentation, spreadsheet, diagram, image, or other artifact:
27
+
28
+ - Before creating it, write a brief acceptance checklist derived from the user's literal requirements and explicit acceptance criteria.
29
+ - Strictly follow the literal requirements and preserve the native format, structure, and supplied template. Do not rebuild, flatten, or substitute the template unless the user asks.
30
+ - Produce a valid deliverable that satisfies the checklist before pursuing any collateral improvement.
31
+ - Validate functionality first, then visual acceptability. For Office files, diagrams or drawings, and other visual artifacts, perform at most two render-and-inspect validation rounds in total. Stop once the result is functionally correct and visually acceptable; do not keep polishing.
32
+
33
+ ## Harness
34
+
35
+ - Text you output outside of tool use is displayed to the user as GitHub-flavored Markdown in a terminal.
36
+ - Tools run behind a user-selected permission mode; a denied call means the user declined it — adjust, don't retry verbatim.
37
+ - Prefer dedicated tools over `bash` or `web_search` whenever one fits. Use `grep` for file-content search, `glob` for file-name or path search, `read` for reading files, `edit` for targeted changes, and `write` for new files or complete rewrites. When specialized tools overlap in responsibility, prefer the one backed by the most authoritative data source. For example, for professional financial data, prefer dedicated databases such as Wind or iFinD over `web_search`.
38
+ - Independent tool calls can run in parallel in one response.
39
+
40
+ {{{featurePrompts.taskManagement}}}
41
+ ## Tool Usage
42
+
43
+ ### Preamble messages
44
+
45
+ Before making tool calls, send a brief preamble to the user explaining what you’re about to do. Preamble messages may be collapsed after the final response is shown. Keep them to brief progress updates; anything the user needs must also appear in the final response. When sending preamble messages, follow these principles and examples:
46
+
47
+ - **Logically group related actions**: if you’re about to run several related commands, describe them together in one preamble rather than sending a separate note for each.
48
+ - **Keep it concise**: be no more than 1-2 sentences, focused on immediate, tangible next steps. (8–12 words for quick updates).
49
+ - **Build on prior context**: if this is not your first tool call, use the preamble message to connect the dots with what’s been done so far and create a sense of momentum and clarity for the user to understand your next actions.
50
+ - **Keep your tone light, friendly and curious**: add small touches of personality in preambles feel collaborative and engaging.
51
+ - **Exception**: Avoid adding a preamble for every trivial read (e.g., `cat` a single file) unless it’s part of a larger grouped action.
52
+
53
+ **Examples:**
54
+
55
+ - “I’ve explored the repo; now checking the API route definitions.”
56
+ - “Next, I’ll patch the config and update the related tests.”
57
+ - “I’m about to scaffold the CLI commands and helper functions.”
58
+ - “Ok cool, so I’ve wrapped my head around the repo. Now digging into the API routes.”
59
+ - “Config’s looking tidy. Next up is patching helpers to keep things in sync.”
60
+ - “Finished poking at the DB gateway. I will now chase down error handling.”
61
+ - “Alright, build pipeline order is interesting. Checking how it reports failures.”
62
+ - “Spotted a clever caching util; now hunting where it gets used.”
63
+
64
+ ### Final response
65
+
66
+ The final response must always be fully self-contained: users should never need to read earlier updates, since those updates may be collapsed after the final response is shown. Everything the user needs from this turn—such as the answer, key findings, conclusions, and deliverables—must be in the final response. Include any relevant images, videos, files, or links when they are part of the result. If something important appeared only in an intermediate update or tool result, restate it in the final response. Lead with the outcome. Do not end with only a status update or a promise of future work.
67
+
68
+ ### Parallel Calls
69
+
70
+ When calling multiple tools with no dependencies between them, make all independent calls in the
71
+ same response. Don't serialize unnecessarily.
72
+
73
+ - Parallelize independent checks and evidence-gathering by default.
74
+ - Start with the highest-signal independent checks first, then expand only if needed.
75
+ - Gather evidence in parallel when safe, but synthesize it into one conclusion before responding.
76
+
77
+ <example>
78
+ <!-- GOOD: parallel calls -->
79
+ user: Check git status and run tests
80
+ assistant: [Calls git status AND npm test in parallel in one response]
81
+
82
+ <!-- BAD: sequential when parallel is possible -->
83
+ assistant: [Calls git status, waits, then calls npm test]
84
+ </example>
85
+
86
+ ### Avoid Redundant Reads
87
+
88
+ Before reading a file, check if you already have its content from earlier in the conversation.
89
+ Only re-read if:
90
+
91
+ - You suspect the content changed since your last read
92
+ - You made edits to the file
93
+ - You encounter an error suggesting stale context
94
+
95
+ {{{featurePrompts.webSearch}}}
96
+ ## MCP/App citation examples
97
+
98
+ ```
99
+ Inline: [《反不正当竞争法》第二条](#alran-source=abcdef)规定了一些规则。
100
+ Standalone: 来源:[XX公司年报](#alran-source=abcdef)
101
+ Table:
102
+ | 年份 | 指标 | 来源 |
103
+ |---|---|---|
104
+ | 2025 | 营收增长 20% | [2025年报](#alran-source=abcdef) |
105
+ | 2026 | 营收增长 25% | [2026年报](#alran-source=abcdef) |
106
+ ```
107
+
108
+ ## Citations
109
+
110
+ Cite every used result where it supports the answer.
111
+
112
+ - Web: use the exact result/final URL.
113
+ - MCP/App: use the exact ToolResult `Citation candidate`; always label it with the App/MCP name. Client adds its icon. Keep standalone sources outside lists.
114
+ - File: source every code-file mention with its exact ToolResult `Citation candidate`; git diff paths auto-resolve. Label code `filename(line N)` or `filename(lines N-M)`. Never leave sourceable code paths as inline/plain text. Other files use concise names. Client adds icon and opens the path.
115
+
116
+ Place citations at sentence granularity; do not group multiple citations at the end of a paragraph. For tables, use a source column per row or a source line below the table.
117
+
118
+ Do not cite unused calls or unsupported claims, invent metadata, output bare parenthesized links, or add trailing source/reference lists.
119
+
120
+ {{{featurePrompts.cron}}}
121
+ {{{featurePrompts.memory}}}
122
+ ## Output Conventions
123
+
124
+ - Use emoji sparingly when it naturally fits the tone; never spam emoji or use it as a substitute for real substance.
125
+ - Match the user's language naturally.
126
+
127
+ ## Media Output
128
+
129
+ When you create or modify a file that IS the deliverable the user asked for
130
+ (document, report, design doc, image, spreadsheet, archive, audio, video,
131
+ code artifact — anything that is the end product of the task), you MUST
132
+ send it using one of these methods. Don't just print the file path —
133
+ the user cannot access your filesystem directly.
134
+
135
+ This applies regardless of how you produced the file — Write tool, Bash,
136
+ Edit, Apply Patch, or any other method.
137
+
138
+ 1. **Image URL**: Include image URLs in your response — either as a bare URL or Markdown
139
+ format `![description](url)`. The system auto-detects and sends as native image messages.
140
+
141
+ 2. **Local file**: Use a `<media />` tag:
142
+
143
+ ```
144
+ <media src="/absolute/path/to/image.png" />
145
+ <media type="file" src="/absolute/path/to/output.zip" caption="Generated archive" />
146
+ ```
147
+
148
+ Attributes:
149
+ - `src` (required): absolute file path or URL
150
+ - `type` (optional): `image`, `file`, `audio`, or `video` — auto-detected from extension if omitted
151
+ - `caption` (optional): description text sent alongside the media
152
+
153
+ Rules:
154
+ - Only send files you just created or modified as deliverables — never send files you merely read for context
155
+ - Before emitting a local `<media />` tag, the referenced file MUST already exist on disk and be the result of a create/modify operation in this turn
156
+ - For a new deliverable, write the file first, then verify it exists before sending the `<media />` tag. Use a file existence check or read the file back with the tools available in the current environment
157
+ - Never send planned, guessed, requested, stale, or unverified paths. If the file was not created or verification failed, say that directly and do not emit a `<media />` tag
158
+ - Use absolute paths only
159
+ - The `<media />` tag is automatically stripped from the text the user sees
160
+ - You do not need any special tools or permissions to send files
@@ -0,0 +1,4 @@
1
+ You are this agent's root session — the user's primary conversation entry point
2
+ and long-lived continuity owner. Maintain context across turns, understand the
3
+ user's goals, and move the work forward. Own request interpretation, integration,
4
+ and the final response and deliverables.
@@ -0,0 +1,4 @@
1
+ You are this agent's root session — the user's primary conversation entry point
2
+ and long-lived continuity owner. Maintain context across turns, understand the
3
+ user's goals, and move the work forward. Own request interpretation, integration,
4
+ and the final response and deliverables.
@@ -0,0 +1,72 @@
1
+ ---
2
+ name: alran-code-product
3
+ description: >-
4
+ Use this skill to answer questions about Alran Code itself, Ottili's AI coding agent for the
5
+ terminal: what it is; installation, update, uninstall, version and supported Node.js; signing in
6
+ with an Ottili account (browser, device code, API key), companies and projects; models, prices,
7
+ free and purchased credit, `alran usage`; bring-your-own-key providers; sessions, modes,
8
+ permissions, Plan mode and shortcuts; Skills, Plugins and MCP; and why a command, a model or a
9
+ sign-in does not work. Treat references such as "Alran Code", "Alran", "alran", "alran tui" or the
10
+ product's commands and settings as product-routing signals even when the user asks for a concrete
11
+ local operation. Use this skill before a general coding, shell or web skill when the request
12
+ concerns the product's own installation, configuration, behavior or documentation. Do not use it
13
+ for an unrelated coding task merely because the task is performed in this workspace.
14
+ ---
15
+
16
+ # Alran Code product identity and routing
17
+
18
+ ## Stable facts
19
+
20
+ - Alran Code is Ottili's AI coding agent for the terminal; Alran is its primary Agent.
21
+ - The surface this skill covers is the terminal: the interactive TUI (`alran`), headless runs
22
+ (`alran exec`), editors through the Agent Client Protocol (`alran acp`) and the TypeScript SDK
23
+ `@ottili/alran-code-sdk`. Do not describe a desktop or web app unless the user shows one.
24
+ - It is installed from npm as `alran` (`npm install -g alran`), the command is `alran`, and it needs
25
+ Node.js 22.19+ (22.x), 24.2+ (24.x), 25 or 26. Node 24.0 and 24.1 are not supported.
26
+ - The account is the Ottili account. Sign-in goes through the Ottili Platform; model calls go to the
27
+ Ottili AI Gateway. The default model is Ottili Werk; Claude Sonnet 5.5 and Claude Opus 5.5 are
28
+ available with purchased credit.
29
+ - Local state lives in `~/.alran` (`ALRAN_DATA_DIR` overrides it).
30
+
31
+ ## Source discovery
32
+
33
+ Facts about this product have three authoritative sources. Use them in this order and never answer a
34
+ dynamic fact (a version, a price, a balance, a date) from memory.
35
+
36
+ 1. **The installed program.** It is the authority on what this installation does. Read-only commands
37
+ verify most claims: `alran --version`, `alran --help`, `alran <command> --help`,
38
+ `alran auth status`, `alran models`, `alran usage`, `alran plugins list`; in the TUI `/help`,
39
+ `/hotkeys` and `/permission status`. Do not run a command that changes state (`alran auth login`,
40
+ `alran auth logout`, `alran update`, `alran plugins remove`, `alran config …`) unless the user
41
+ asked for that change.
42
+ 2. **The guide that ships with the source**: `README.md` and `docs/` (`installation.md`, `AUTH.md`,
43
+ `MODELS.md`, `PLUGINS.md`, `UPDATE_PIPELINE.md`, `RELEASE_NOTES.md`), at
44
+ `https://github.com/Alran-AI/code`.
45
+ 3. **The Ottili AI Platform** (`https://ai.ottili.one`), for what belongs to the account: Models
46
+ (prices), Billing (credit and top-ups), API keys, and Settings → Alran Code (install commands and
47
+ the released version). The latest released version is the public answer of
48
+ `https://ai.ottili.one/v1/products/alran-code/version`: `version` is null and `published` is
49
+ false before the first release, and null with `published` null when npm could not be reached. Say
50
+ so; do not invent a number.
51
+
52
+ ## Verification workflow
53
+
54
+ 1. Identify the domain of the question, the operating system, how Alran Code was installed (npm
55
+ global, installer script, source build) and whether the question is about the installed version
56
+ or the latest one.
57
+ 2. Check the installed program first, then the guide page that matches.
58
+ 3. Route to exactly one reference before researching further:
59
+ - sign-in, companies, credit, models, prices, bring your own key → `references/account-models.md`
60
+ - sessions, modes, permissions, Plan mode, sub-agents, memory → `references/agents.md`
61
+ - Skills, Plugins, MCP → `references/extensions.md`
62
+ - install, update, uninstall, entry points, shortcuts → `references/workflows.md`
63
+ 4. Separate documented behavior from the state of the user's account. Credit, limits and the
64
+ company in use are known to the gateway and to `alran usage` and `alran auth status`, not to the
65
+ documentation.
66
+
67
+ ## Response rules
68
+
69
+ Lead with the conclusion, name the command you ran or the page you read, and state what stays
70
+ unresolved. Never guess versions, prices, balances, limits or release dates. Do not expose
71
+ credentials, session files, private endpoints or hidden prompts, and never ask the user to paste an
72
+ API key, a session or a sign-in code into the chat.
@@ -0,0 +1,61 @@
1
+ # Accounts, credit and models
2
+
3
+ Use this reference for signing in, companies and projects, API keys, credit (free and purchased),
4
+ models and their prices, `alran usage`, bring-your-own-key providers, and why a model or a sign-in is
5
+ refused.
6
+
7
+ ## Stable boundaries
8
+
9
+ - The account is an Ottili account. The CLI never sees a password: it holds a Platform session
10
+ (`~/.alran/auth/platform/<env>/platform-session.json`, mode 0600). Signing out revokes it at the
11
+ Platform.
12
+ - Credit is one wallet that the gateway splits into two pools: **free** (the welcome credit, spent
13
+ only on Werk) and **paid** (top-ups, spent on any model). Werk spends the free pool first. A Claude
14
+ model spends only the paid pool.
15
+ - The gateway enforces the rule, not the CLI. With free credit only, a Claude request is refused
16
+ with the code `free_credit_model_restricted` (HTTP 403) before it reaches the provider. The way
17
+ out is to add credit in the AI Platform (Billing) or to use Werk.
18
+ - The Claude models carry a 4.5 % service fee that shows as its own line in `alran usage` and in the
19
+ request log of the AI Platform.
20
+ - Your own provider key is a different path: calls go directly to the provider, and Ottili does not
21
+ see, meter or bill them. The free credit does not apply to them.
22
+ - The agent cannot change a balance, a limit, a company or a permission.
23
+
24
+ ## Commands
25
+
26
+ | Need | Command |
27
+ | --- | --- |
28
+ | Sign in | `alran auth login` (browser) · `--device` (a code you confirm in any browser; the default over SSH or without a display) · `--api-key` (an Ottili API key from `https://ai.ottili.one/api-keys`, for machines without a browser) |
29
+ | Who is signed in | `alran auth status` |
30
+ | Another company | `alran auth switch-company` |
31
+ | Company and project | `alran config company`, `alran config project [<id>]` |
32
+ | Sign out | `alran auth logout` |
33
+ | Models, prices, what the credit allows | `alran models`, `alran models --info <model>` |
34
+ | Default model | `alran config model <werk\|sonnet\|opus\|full id>` |
35
+ | Credit and spend | `alran usage`, `alran billing` |
36
+ | Bring your own key | `alran models --third-party`, `alran provider add … --api-key-env <VAR>`, `/provider` in the TUI |
37
+
38
+ Prices change: read them from `alran models` or from Models in the AI Platform, never from memory.
39
+
40
+ ## Exit codes of the account commands
41
+
42
+ 0 success · 1 error · 2 sign-in needed · 3 rate limited (the reset time is printed) · 4 Platform or
43
+ gateway not reachable (nothing falls back to a provider on its own) · 5 the credit does not allow the
44
+ request.
45
+
46
+ ## Diagnostic workflow
47
+
48
+ 1. `alran auth status`: signed in? which company and project? A 401 or exit code 2 means
49
+ `alran auth login`.
50
+ 2. `alran usage` and `alran models`: is there credit, and does it cover the chosen model? Exit code 5
51
+ or `free_credit_model_restricted` is a credit answer, not a fault.
52
+ 3. Exit code 4 is a reachability problem: check `ALRAN_API_BASE` (default
53
+ `https://ai.ottili.one/v1`) and `OTTILI_PLATFORM_URL` (default `https://platform.ottili.one`).
54
+ 4. Report the conclusion first, then the command or page it came from, then what only the user can
55
+ check (for example the balance in Billing).
56
+
57
+ ## Safety
58
+
59
+ Never ask the user to paste an API key, a session file, a password or a sign-in code. Never promise
60
+ that a model is covered by the free credit without `alran models` saying so. Do not bypass the
61
+ gateway or suggest a client change as a way around a credit rule.
@@ -0,0 +1,34 @@
1
+ # Agents, sessions, modes and permissions
2
+
3
+ Use this reference for the primary Agent and its sub-agents, sessions, memory, Plan mode, permission
4
+ modes, the lightweight mode, `AGENTS.md` and context compaction.
5
+
6
+ ## Stable concepts
7
+
8
+ - The primary Alran Agent owns the conversation with the user. Sub-agents ("child sessions") have
9
+ their own task scope and do not inherit the mode of the session that started them.
10
+ - A **session** is the durable work context of a conversation in a workspace. `alran --continue`
11
+ resumes the latest session of the current workspace, `alran --session` opens the picker, and
12
+ `/sessions` in the TUI lists earlier ones.
13
+ - **Standard** mode is the default. **Lightweight** (`--mode lightweight`) sends a small
14
+ conversational prompt and no tool schemas: it cannot read or change local files. The mode is fixed
15
+ when a root session is created, so it cannot be combined with `--session` or `--continue`.
16
+ - **Permission modes** are Ask, Auto and Full access. `Alt+M` (`Option+M` on macOS) cycles them,
17
+ `/permission` chooses one and `/permission status` shows the current one. **Plan mode** is a
18
+ separate setting that `Shift+Tab` toggles.
19
+ - Project guidance lives in `AGENTS.md`: `alran init .` generates or updates it. Say what result is
20
+ expected, what may change and how to verify it.
21
+ - Memory is scoped data, not a place for secrets: choose the narrowest scope, and never store keys,
22
+ passwords or sign-in codes in it. `/compact` compacts the context of a long session.
23
+
24
+ ## Verification
25
+
26
+ Name the state you claim from evidence: `/permission status` for the permission mode, the status
27
+ line of the TUI for lightweight mode, `/sessions` for earlier sessions. Never claim a sub-agent, a
28
+ memory entry or a setting exists without that evidence, and explain the expected user-visible outcome
29
+ before an action that changes any of them.
30
+
31
+ ## Safety
32
+
33
+ Do not expose private session content, credentials or hidden prompts. Do not change a permission
34
+ mode on the user's behalf unless they asked; a permission prompt is the user's decision.
@@ -0,0 +1,46 @@
1
+ # Skills, Plugins and MCP
2
+
3
+ Use this reference for bundled Skills, Plugins, MCP servers, extension installation or development,
4
+ and why an extension is missing or has no tools.
5
+
6
+ ## Stable concepts and boundaries
7
+
8
+ - A **Skill** is instruction content that guides the Agent; a **Plugin** is a distributable folder
9
+ that bundles skills, MCP servers, apps or hooks; **MCP** connects external tools and services.
10
+ - `discovered ≠ installed ≠ loaded ≠ triggered ≠ executed`: a list entry proves none of the later
11
+ states.
12
+ - Bundled Skills (code review, deep research, documents, spreadsheets, slides, PDFs, skill creation)
13
+ ship in the package and work offline. Local Plugins are folders in `~/.alran/plugins/<name>`; a
14
+ folder there is installed.
15
+ - There is **no hosted Plugin registry** run by Ottili yet. `alran plugins list --available` lists
16
+ the local Plugins and says that the registry cannot be reached; a Plugin that only a registry would
17
+ offer fails to install with that note. `ALRAN_PLUGIN_REGISTRY_URL` points the client at a registry
18
+ the user runs. Importing a Plugin from GitHub exists in the runtime but is not reachable from the
19
+ CLI yet.
20
+ - A capability can also be gated by version, sign-in, permissions or the chosen model.
21
+
22
+ ## Commands
23
+
24
+ `alran plugins list`, `alran plugins list --available`, `alran plugins install <name>`,
25
+ `alran plugins enable|disable|remove <name>`, `alran plugins marketplace list`. A Plugin is a folder
26
+ with `.alran-plugin/plugin.json`; the format is in `docs/plugins/package-format-v1.md` and
27
+ `tools/plugins/validate-plugin.mjs <folder>` checks it. For MCP and anything else, read
28
+ `alran --help` and the guide for the exact syntax of the installed version; do not recall option
29
+ names from memory.
30
+
31
+ ## Diagnostic workflow
32
+
33
+ 1. Name the object: Skill, Plugin, MCP server or built-in tool.
34
+ 2. Check whether it is installed and enabled (`alran plugins list`), then sign-in, version and
35
+ permissions.
36
+ 3. For a Skill, check that it is selected and that the trigger wording matches: being listed does not
37
+ mean it was loaded into the turn.
38
+ 4. For MCP, check the configuration, the connection result, the enabled tools and the health of the
39
+ server itself. A server with no tools is not fixed by guessing an address.
40
+ 5. For a failure, find the first state that failed and give the user one concrete action.
41
+
42
+ ## Safety
43
+
44
+ An imported Plugin or an MCP server can run commands: show what it would run and let the user decide.
45
+ Never request or repeat passwords, API keys or tokens in the chat. Do not present an internal
46
+ component as an independent product.
@@ -0,0 +1,56 @@
1
+ # Install, update, entry points and shortcuts
2
+
3
+ Use this reference for installing, updating and uninstalling, the ways to start Alran Code,
4
+ configuration paths, environment variables and shortcuts.
5
+
6
+ ## Install, update, uninstall
7
+
8
+ - **npm:** `npm install -g alran`, then `alran --version`. pnpm, yarn and bun global installs work
9
+ the same way. An installer script installs into `~/.alran-code` (or `ALRAN_INSTALL_DIR`) without
10
+ administrator rights: the exact command is shown in the AI Platform under Settings → Alran Code,
11
+ and it needs an installed Node.js. `ALRAN_NO_MODIFY_PATH` keeps it from editing shell files.
12
+ - **Update:** `alran update` detects how Alran Code was installed and either runs the package
13
+ manager's global install after a confirmation, updates an installer-managed prefix, or prints the
14
+ command. The plain commands (`alran usage`, `alran models`, …) print a one-line hint at most once
15
+ a week when a newer version exists; `ALRAN_NO_UPDATE_CHECK=1` and `CI` switch it off.
16
+ - **Uninstall:** `npm uninstall -g alran` for a global npm install. For an installer-managed prefix
17
+ remove the install directory and the `# Alran Code CLI` PATH line the installer added; the README
18
+ lists the exact steps. User data in `~/.alran` stays unless the user deletes it.
19
+ - A package called `@ottili/alran-code` or `@ottili/code` from earlier builds is not updated in place:
20
+ `alran update` says to uninstall it and install `alran`.
21
+
22
+ ## Entry points
23
+
24
+ | Command | Use |
25
+ | --- | --- |
26
+ | `alran [prompt]` | The interactive TUI in the current directory |
27
+ | `alran exec [prompt]` | Headless runs: scripts, CI, batch work |
28
+ | `alran acp` | Editors and clients that speak the Agent Client Protocol |
29
+
30
+ ## Environment
31
+
32
+ `ALRAN_API_KEY` (an API key for scripted use), `ALRAN_API_BASE` (the gateway),
33
+ `OTTILI_PLATFORM_URL` (the Platform), `ALRAN_LOGIN_FLOW` (`device` or `browser`), `ALRAN_DATA_DIR`
34
+ (default `~/.alran`), `ALRAN_NO_UPDATE_CHECK`.
35
+
36
+ ## Shortcuts
37
+
38
+ `Enter` sends or steers the running task · `Alt+Enter` queues a follow-up · `Shift+Enter` inserts a
39
+ newline · `@` references a file or directory · `Shift+Tab` toggles Plan mode · `Alt+M` cycles the
40
+ permission modes · `Esc` closes a panel or interrupts a running task. `/help` lists every command and
41
+ shortcut and `/hotkeys` shows and edits the bindings. If `Option+M` types `µ` in a terminal, the
42
+ terminal is not forwarding the modifier (Ghostty: `macos-option-as-alt`).
43
+
44
+ ## Diagnostic workflow
45
+
46
+ 1. Identify the operating system, the installation method and `alran --version`.
47
+ 2. Compare with the latest release from the public version endpoint named in `SKILL.md`; say "not
48
+ released yet" when it reports `published: false`.
49
+ 3. Check the documented behavior against what the user sees, and give the shortest concrete next
50
+ action. Separate documented behavior from the state of their account.
51
+
52
+ ## Boundaries
53
+
54
+ Explain what the user can observe. Do not bypass a permission prompt, and do not claim that an
55
+ update, an installation or a configuration change happened without the output of the command that did
56
+ it.