← ClaudeAtlas

adapter-authoringlisted

Build a custom source → raw-intake adapter for Athenaeum. Use when someone wants to feed an external source (an API, an export file, a message feed, a scraper, another tool's output) into an Athenaeum knowledge base, asks "how do I write an adapter / integration for athenaeum", or wants to turn some data source into wiki entities the librarian can compile.
Kromatic-Innovation/athenaeum · ★ 11 · API & Backend · score 72
Install: claude install-skill Kromatic-Innovation/athenaeum
# adapter-authoring Teach the user (or yourself, as an agent) how to build a **source adapter** for Athenaeum: a script or integration that turns an external source into raw-intake files the librarian compiles into the wiki. This skill is self-contained — it does not depend on any private Kromatic repo or context. The authoritative contract this skill operationalises is [`docs/adapter-contract.md`](https://github.com/Kromatic-Innovation/athenaeum/blob/main/docs/adapter-contract.md). The runnable reference is [`examples/adapters/minimal_adapter.py`](https://github.com/Kromatic-Innovation/athenaeum/blob/main/examples/adapters/minimal_adapter.py). This skill file ships inside the published `athenaeum` package (under `skills/`); the contract doc and example live in the repository and the source distribution (links above), so it stays self-contained however it was installed. ## The one rule A source **only appends raw files** to the intake tree. A separate compiler — the librarian — is the **only** writer to the wiki. Your adapter's entire job is to write well-shaped raw-intake files; everything downstream (clustering, merge, contradiction detection, retirement) is the librarian's job, not yours. Safety comes from this structure, not from trusting the source. ## Which lane? - **Lane A (default)** — `raw/<source>/<timestamp>-<uuid8>.md`. Use for almost every external source. This skill walks Lane A. - **Lane B (auto-memory)** — `raw/auto-memory/<scope>/…`. Only for bridging