← Back to Skills Marketplace
rokokol

Math Notes KaTeX

by ilysha · GitHub ↗ · v0.1.3 · MIT-0
cross-platform ⚠ suspicious
165
Downloads
0
Stars
0
Active Installs
4
Versions
Install in OpenClaw
/install math-notes-katex
Description
Render math-heavy notes to PNG using KaTeX (LaTeX) + headless Brave. Use when the user asks for a clean “solution/конспект as an image”, “formulas as a pictu...
Usage Guidance
This skill seems to do what it claims (turn LaTeX-like notes into PNGs) but it's incomplete in practice. Before installing or running it: - Do not run blindly. Inspect the full render_note_png.js (the portion that launches Brave) to confirm it only screenshots local HTML and does not fetch or post to external URLs. - The package has no install spec or package.json. You will need Node.js and the katex module available in the runtime, and an executable Brave/Chromium on PATH (or pass a full --brave path). Add/verify a package.json or run npm install katex in a controlled environment. - Running headless Chromium as root may require flags (--no-sandbox --disable-setuid-sandbox); using those flags reduces sandboxing — avoid running the browser as root where possible. Prefer running inside an isolated container or dedicated VM if you are unsure. - The scripts link KaTeX CSS via file:// to load fonts locally; ensure the katex package and fonts are present and that CSS does not include remote font URLs. If you must allow remote resources, be aware that could introduce network fetches. If you want to proceed: run the scripts in an isolated environment (container or VM), add explicit dependency/install steps (npm install katex and any other modules), and verify the Brave invocation flags are reasonable for your security posture.
Capability Analysis
Type: OpenClaw Skill Name: math-notes-katex Version: 0.1.3 The math-notes-katex skill is a utility for rendering LaTeX-formatted notes into PNG images using KaTeX and a headless Brave/Chromium browser. The bundle includes Node.js scripts for splitting markdown into pages (split_note_md.js) and rendering them (render_note_png.js), along with a shell script wrapper (render_note_pages.sh). The renderer includes a helpful 'preflight lint' feature to detect common character confusables (e.g., Cyrillic vs. Latin letters) that break LaTeX. While the browser is invoked with high-privilege flags like --no-sandbox and --allow-file-access-from-files, these are used to render locally generated HTML and are documented as necessary for headless operation in restricted environments. No indicators of malicious intent, data exfiltration, or unauthorized execution were found.
Capability Assessment
Purpose & Capability
Name/description match the code: the JS and shell scripts implement KaTeX -> HTML -> headless Brave screenshot flows. However the skill declares no required binaries or env vars while its runtime clearly needs node, the 'katex' node package, and a Chromium-family browser (Brave). That omission is an incoherence: someone building this feature would reasonably need to declare these dependencies or provide an install step.
Instruction Scope
Runtime instructions (SKILL.md and scripts) stay on-topic: they read a local markdown file, split/render it, build local HTML, and invoke a headless browser to produce PNGs. There are no instructions to read unrelated system files or to send data to external endpoints. The troubleshooting notes explicitly call out the headless flags needed to access local files.
Install Mechanism
No install specification is provided despite code that depends on Node modules (katex) and an external browser binary. There is no package.json or npm install guidance, so it's unclear how katex (and any other runtime modules) will be made available. This is a practical and security concern: missing install instructions may lead users to run ad-hoc installs or run the code in an unexpected environment.
Credentials
The skill requests no environment variables or credentials. That is proportionate for the stated purpose. Note: runtime access to the filesystem (reading input file, writing out/ directories) is required and expected for rendering; no credentials are requested.
Persistence & Privilege
The skill does not request elevated or persistent privileges and 'always' is false. It does invoke an external browser (headless Brave) which will be run when the script is executed — this is expected for the task and not flagged by itself.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install math-notes-katex
  3. After installation, invoke the skill by name or use /math-notes-katex
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v0.1.3
Tidy docs; clarify usage without extra security notes
v0.1.2
Add multi-page rendering (heuristic split + per-page PNG render)
v0.1.1
EN docs + clearer scope; remove --disable-web-security; keep local file-only rendering
v0.1.0
Initial release: render LaTeX-heavy notes to PNG via KaTeX + headless Brave; includes preflight lint for common confusable symbols
Metadata
Slug math-notes-katex
Version 0.1.3
License MIT-0
All-time Installs 0
Active Installs 0
Total Versions 4
Frequently Asked Questions

What is Math Notes KaTeX?

Render math-heavy notes to PNG using KaTeX (LaTeX) + headless Brave. Use when the user asks for a clean “solution/конспект as an image”, “formulas as a pictu... It is an AI Agent Skill for Claude Code / OpenClaw, with 165 downloads so far.

How do I install Math Notes KaTeX?

Run "/install math-notes-katex" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Math Notes KaTeX free?

Yes, Math Notes KaTeX is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does Math Notes KaTeX support?

Math Notes KaTeX is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Math Notes KaTeX?

It is built and maintained by ilysha (@rokokol); the current version is v0.1.3.

💬 Comments