# Archive Index

> Refresh and use the searchable index of the entire society archive. Use to get a fast overview of everything the society has ever done, or to locate which note/year/term discusses a topic before reading it in detail. Regenerates _converted/ and ARCHIVE_INDEX.md from the raw Box Notes.

- Skill: `faaz17/archive-index` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add faaz17/archive-index`
- Raw SKILL.md: https://api.skillmd.com/api/skills/faaz17/archive-index/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: Faaz17 (https://skillmd.com/u/faaz17)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/faaz17/archive-index

---


# Archive Index

Keeps the archive readable and searchable so the president never has to open raw
`.boxnote` files or hold four years of history in their head.

## What it produces

- **`_converted/`** — a Markdown mirror of every `.boxnote`, same folder layout.
- **`_converted/ARCHIVE_INDEX.md`** — one file containing the full text of every
  note, section-separated by source path. Grep this to find anything fast.

## Refresh (run after Box Notes are added or edited)

From the society root (`Scoiety Folders/`):

```bash
python ".claude/skills/read-boxnote/boxnote_to_text.py" --all "."
python ".claude/skills/read-boxnote/boxnote_to_text.py" --index "." -o "_converted/ARCHIVE_INDEX.md"
```

## Office documents (Word/Excel — e.g. Google Drive exports)

2022–2025 live in Box Notes; 2025–26 arrived as a Google Drive export of `.docx`/
`.xlsx`. `office_to_md.py` mirrors those into `_converted/` and builds an index
(PDFs/images/video are inventoried, not converted):

```bash
python ".claude/skills/archive-index/office_to_md.py" "2025-2026 google drive" \
    --outdir "_converted/2025-2026 google drive" \
    --index  "_converted/DRIVE_2025-2026_INDEX.md"
```

The 2025–26 detail (team minutes, ~20 event proposals, feedback sheets, research
drafts) is greppable in **`_converted/DRIVE_2025-2026_INDEX.md`**.

## Use it to answer questions

1. **Locate:** grep `_converted/ARCHIVE_INDEX.md` for the topic/event/name/year.
   ```bash
   grep -in "hackathon\|escape room\|budget" "_converted/ARCHIVE_INDEX.md"
   ```
2. **Read in full:** open the specific `_converted/<year>/<term>/<note>.md` that
   the index pointed to, for dates/attendees/decisions/outcomes.
3. **Cite:** reference the converted file path so the user can click through.

## Good first-overview queries

- Recurring events across years (workshops, competitions, trips, socials).
- Which budgets were approved vs. rejected (search `budget`, `approv`, `reject`).
- Committee rosters per year (search `President`, `Secretary`, `Working Group`).
- Venues and external contacts reused (search `lab`, `functions room`, company
  names).

Pair this with the `archive-historian` agent for a written, cited synthesis
rather than raw grep output. Respect `rules/data_privacy.md` when quoting.