openkursar/hello-halo

create-digital-human

Authoring guide for Halo digital humans (automation apps). Read before calling create_automation_app or update_automation_app.

halo-dev

important!!! Must read and follow before writing or editing any code, and equally before planning, designing, or discussing architecture for this codebase (module placement, directory layout, IPC channels, theme, i18n) — decisions made while planning are what…

product-principles

Halo's product design principles. Halo is a performance-sensitive Electron app — performance first, features restrained, never block startup or user interaction; the AI is a partner, not a tool; users never have to learn the tool; a working AI hears new…

halo-logging

Must be invoked when adding or changing a failure path (drop/skip/ignore/timeout/catch), a long-lived stateful link (connection, session, subscription, federation/sync link, IM channel), a log on a hot path (stream/IPC event handler, per-request or…

code-review

Must be invoked when the user asks to commit review.

human-comms

How to report findings, diagnose behavior, and propose changes to the human owner of this repo. Load this before answering any question about why the product behaves a certain way, whether a feature should exist, what is broken, or what to change. The owner…

docx

Work with Microsoft Word documents. Use whenever a .docx file is the input or the deliverable: reading or summarizing a Word document, creating a report/memo/letter/contract as a .docx, editing text in an existing .docx (find-and-replace, filling a template),…

office-runtime-check

Verify that the bundled Office library runtime (halo-node shim + pure-JS office libraries) is working. Use when the user asks to check or debug Office document capabilities, or when an Office skill fails with module-resolution errors.

pdf

Work with PDF files. Use whenever a .pdf is the input or the deliverable: reading or extracting text from a PDF, merging or splitting PDFs, rotating pages, adding watermarks, filling PDF forms, creating a new PDF, or inspecting a PDF's pages/metadata/form…

pptx

Work with PowerPoint presentations. Use whenever a .pptx file is the input or the deliverable: creating a slide deck or pitch deck, reading/extracting text from a presentation, editing or updating slides in an existing deck, or filling a deck template.…

xlsx

Work with Excel spreadsheets. Use whenever a spreadsheet file (.xlsx, .csv, .tsv) is the input or the deliverable: reading or summarizing workbook contents, editing cells/formulas/formatting in an existing file, creating a new spreadsheet from data or from…

code-review-one

Called only when actively triggered by the user..

code-commit

Must be invoked when the user asks to commit code, submit code, or any similar request.

code-merge

Must be invoked when the user asks to resolve merge conflicts, merge a branch, handle an MR/PR conflict, or any similar request.

comment-review

Must be invoked when the user asks to review, optimize, or clean up comments, or wants comments checked before a commit. Detects AND fixes low-quality comments in changed code so they meet open-source benchmark quality.