# Export

> Export a research session into knowledge-intake compatible markdown. Use after a research session to hand findings to memory-palace.

- Skill: `athola/export` (Agent Skill)
- Install (CLI): `npx skillmds@latest add athola/export`
- Raw SKILL.md: https://api.skillmd.com/api/skills/athola/export/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Docs & Writing
- Author: athola (https://skillmd.com/u/athola)
- Updated: 2026-09-10
- Page: https://skillmd.com/skills/athola/export

---


# Export

Turn a finished research session into a file `knowledge-intake` can read
without reformatting.

## When To Use

After a research session has findings and you want them stored rather
than merely reported.

## When NOT To Use

- The session is still gathering findings: finish `Skill(tome:research)`
  first, since an export of an empty session emits only frontmatter.
- You want a human-readable report: use `Skill(tome:synthesize)`, which
  produces the narrative form with coverage and gaps.

## Workflow

Load the session and render it:

```python
from pathlib import Path

from tome.session import SessionManager
from tome.output.export import export_for_memory_palace

session = SessionManager(Path.cwd()).load_latest()
markdown = export_for_memory_palace(session)
Path(f"docs/research/export-{session.id}.md").write_text(markdown)
```

`SessionManager` resolves its store relative to the path it is given, so
run this from the repository root or the session will not be found.

To export a specific session, use `load(session_id)` instead of
`load_latest()`.

## What It Emits

YAML frontmatter carrying `topic`, `domain`, `session_id`, `date`,
`finding_count`, `channels`, and `type: research-export`, followed by
findings grouped by channel. Each finding renders its source, URL,
relevance, summary, and channel-specific metadata.

An empty session emits the frontmatter and a line stating that no
findings were recorded, which is deliberate. A silent empty file would
read as a successful export of nothing.

## Handoff

The output is an external resource, not a corpus entry. Feed it to
`Skill(memory-palace:knowledge-intake)`, which owns evaluation, routing,
and storage. This skill does no scoring.

## Exit Criteria

- [ ] `export_for_memory_palace` was called on a loaded session
- [ ] The output file exists and its frontmatter includes
      `type: research-export`
- [ ] `finding_count` in the frontmatter matches the session's findings
- [ ] The file was handed to `Skill(memory-palace:knowledge-intake)` or
      its path was reported for later intake