Overview

The Agent Logbook

Structured state for agent skills.

Why logbooks?

The idea is to equip skills with state that outlives the run — somewhere their work piles up across sessions, across agents, across runs.

Most skills have a natural shape for their work. Make that shape explicit, and the skill stops starting from scratch — every run builds on the last.

What structure looks like

Three patterns where rows do what prose can't.

What this enables

01

Deep research and review

Build multi-phase work from structured intermediate results.

02

Draft and staging workflows

Shape work before committing it to Jira, docs, or reports.

03

Background agent supervision

Inspect progress without reading full transcripts.

04

Cross-agent reuse

Let each pass leave behind work the next pass can use.

05

Controlled execution

Turn selected entries into tickets, reports, boards, or new agent runs.

Flexible by design

A logbook can live in a CSV, spreadsheet, JSONL file, SQLite database, or a purpose-built tool. What matters is not the backend. What matters is that the work is structured enough to query, update, and carry forward.

Skill examples

Five published skills that exercise logbook principles.

$ /plugin marketplace add agentlogbooks/logbooks
Or build your own

Make your own logbook

The meta-skill: walk through motivation, scope, schema, and storage. Get back two artifacts — the logbook instance and its sibling spec.

/plugin install logbook-creator@logbooks Design my own →