How do I install the Read Boxnote skill?

Run npx skillmds@latest add faaz17/read-boxnote in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Read Boxnote safe to use?

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Read Boxnote?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Read Boxnote free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Read Boxnote?

Faaz17 (@faaz17) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Read Boxnote by faaz17 — Agent Skill

Name: Read Boxnote
Author: Faaz17

Read Boxnote

Convert Box Notes (.boxnote files) into readable Markdown. Use whenever you need to read, search, or quote the society's meeting notes, calendars, event proposals, or member lists — most of the archive is stored as .boxnote (ProseMirror JSON) which is not human-readable as-is. Also builds a full-text index of the whole archive.

Faaz17 900a4e3 2 files · 11.0 KB Updated Sep 17, 2026

File contents

Reading Box Notes

The society archive is mostly .boxnote files — Box Notes stored as ProseMirror JSON. They can't be read directly. boxnote_to_text.py (stdlib Python only, lossless UTF-8) renders them to clean Markdown: headings, bullet/numbered lists, checkboxes, tables, links, and formatting.

When to use

You need to read/search/quote any .boxnote (meeting notes, calendars, proposals, rosters).
Someone added or edited Box Notes and the _converted/ mirror is stale.
You want one searchable file covering the entire archive.

Commands

Run from the society root (Scoiety Folders/):

# One note → screen
python ".claude/skills/read-boxnote/boxnote_to_text.py" "2022 - 2023/Autumn 2022/Meeting #1.boxnote"

# One note → a .md file
python ".claude/skills/read-boxnote/boxnote_to_text.py" "path/to/Note.boxnote" -o out.md

# Convert EVERY .boxnote into a mirror tree under _converted/
python ".claude/skills/read-boxnote/boxnote_to_text.py" --all "."

# Build one master full-text index of every note
python ".claude/skills/read-boxnote/boxnote_to_text.py" --index "." -o "_converted/ARCHIVE_INDEX.md"

Normal workflow

To read/search the archive: prefer the already-generated _converted/*.md files and _converted/ARCHIVE_INDEX.md. Grep the index to find the note, then open the specific converted file for full context.
After Box Notes change: re-run --all then --index to refresh.
Do not edit files in _converted/ by hand — they're regenerated. Edit the source .boxnote in Box, or a real doc in the term folder.

Notes

Windows + Python 3.11 confirmed working; no third-party packages needed.
Output is UTF-8. Terminal (Git Bash) may show � for smart quotes/bullets — that's a console display quirk only; the written .md files are correct.
Old notes' manual · bullets and non-breaking spaces are normalized to clean Markdown automatically.

---name: read-boxnotedescription: Convert Box Notes (.boxnote files) into readable Markdown. Use whenever you need to read, search, or quote the society's meeting notes, calendars, event proposals, or member lists — most of the archive is stored as .boxnote (ProseMirror JSON) which is not human-readable as-is. Also builds a full-text index of the whole archive.---# Reading Box NotesThe society archive is mostly `.boxnote` files — Box Notes stored as ProseMirrorJSON. They can't be read directly. `boxnote_to_text.py` (stdlib Python only,lossless UTF-8) renders them to clean Markdown: headings, bullet/numbered lists,checkboxes, tables, links, and formatting.## When to use- You need to read/search/quote any `.boxnote` (meeting notes, calendars, proposals, rosters).- Someone added or edited Box Notes and the `_converted/` mirror is stale.- You want one searchable file covering the entire archive.## CommandsRun from the society root (`Scoiety Folders/`):```bash# One note → screenpython ".claude/skills/read-boxnote/boxnote_to_text.py" "2022 - 2023/Autumn 2022/Meeting #1.boxnote"# One note → a .md filepython ".claude/skills/read-boxnote/boxnote_to_text.py" "path/to/Note.boxnote" -o out.md# Convert EVERY .boxnote into a mirror tree under _converted/python ".claude/skills/read-boxnote/boxnote_to_text.py" --all "."# Build one master full-text index of every notepython ".claude/skills/read-boxnote/boxnote_to_text.py" --index "." -o "_converted/ARCHIVE_INDEX.md"```## Normal workflow1. **To read/search the archive:** prefer the already-generated `_converted/*.md` files and `_converted/ARCHIVE_INDEX.md`. Grep the index to find the note, then open the specific converted file for full context.2. **After Box Notes change:** re-run `--all` then `--index` to refresh.3. **Do not edit** files in `_converted/` by hand — they're regenerated. Edit the source `.boxnote` in Box, or a real doc in the term folder.## Notes- Windows + Python 3.11 confirmed working; no third-party packages needed.- Output is UTF-8. Terminal (Git Bash) may show `�` for smart quotes/bullets — that's a console display quirk only; the written `.md` files are correct.- Old notes' manual `·` bullets and non-breaking spaces are normalized to clean Markdown automatically.

Frequently asked questions