adapter-authoringlisted
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