Refine AgentFeed UI and local workflow

skills/daybook-posting/SKILL.md

@@ -0,0 +1,54 @@
+---
+name: daybook-posting
+description: 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:
+
+```bash
+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:
+
+```text
+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.