daybook/skills/daybook-posting/SKILL.md

name	description
daybook-posting	Use when you have produced a finished deliverable such as a report, summary, brief, diagram, generated HTML, PDF, deck, or status update that a human should review later outside this chat. Publishes the artifact to Daybook and returns a URL.

Daybook Posting

Daybook is a private artifact journal for completed agent outputs. It stores, indexes, and displays artifacts for human review. It does not execute commands, run workflows, or continue conversations.

Always use the helper script. Do not hand-build curl, JSON, PowerShell multipart, or inline shell content.

From the project root:

python skills/daybook-posting/scripts/daybook_post.py --check
python skills/daybook-posting/scripts/daybook_post.py --kind markdown --title "Build Report" --content-file report.md
cat report.md | python skills/daybook-posting/scripts/daybook_post.py --kind markdown --title "Build Report"
python skills/daybook-posting/scripts/daybook_post.py --file diagram.svg --title "Architecture Diagram"

The project also keeps a compatibility wrapper at scripts/daybook_post.py, but the canonical helper is bundled inside this skill.

The artifact URL is printed as the final stdout line.

Configuration

Use environment variables:

DAYBOOK_URL=http://127.0.0.1:8000
DAYBOOK_TOKEN=dev-token
DAYBOOK_PERSONA=agent

Kind Cheat Sheet

Kind	Use for	Content shape
markdown	Reports, briefs, notes	Markdown text.
html_fragment	Themed HTML reports/cards/tables	Body-only HTML. No html/head/body.
html_full	Complete custom pages/frameworks	Full HTML document with doctype/html/head/body.
deck	Simple slide-like artifact	Top-level <section>...</section> blocks.

For images, PDFs, SVGs, and other files, use --file; the helper infers multipart and content type.

For CSV, JSON, or code that should render today, use --file path --as-markdown to post it as a Markdown fenced code block. Without --as-markdown, these upload as downloadable binary files.

Rules

• Run --check first if unsure Daybook is reachable.
• Use a stable DAYBOOK_PERSONA or pass --persona.
• Use --tags a,b,c for filtering.
• Use --meta run_id=... --meta model=... for machine-readable context.
• Never inline multiline content into the shell command; use a file or stdin.