| name | session-to-post |
| description | Turn a completed coding session, git diff, notes, or transcript into a development diary draft or end-of-session writeup without rewriting the story by hand. Use near the end of meaningful work when the user wants a durable wrap-up. |
Session to Post
Metadata
- Trigger when: the session is winding down and there is real evidence such as a repo diff, saved patch, notes, or transcript.
- Do not use when: the work is still changing rapidly, the user only wants a mid-session checkpoint, or there is no real session evidence.
Skill Purpose
Convert real session artifacts into a grounded wrap-up or post draft so the work, lessons, and pivots survive the session in a reusable form.
Instructions
- Decide whether the user wants a full post draft or only a short wrap-up note. Do not overuse the full draft path when a compact internal summary would do.
- Choose the best source inputs and run the
session-to-post CLI with explicit paths. Read /Users/nick/.codex/skills/session-to-post/README.md for the current flag set and source-selection rules if needed, especially when deciding between repo diff, saved patch, notes, and transcript inputs.
- Review the generated result for groundedness, privacy, and signal. Keep the story anchored to decisions, failures, and pivots from the real session; if it is not public-safe, keep the output private-safe by default.
Non-Negotiable Acceptance Criteria
- The draft stays anchored to real session evidence.
- Public-safe framing is the default unless the user explicitly asks for private internal notes.
- The output does not become a file-by-file tour when the real story is about decisions or lessons.
- The skill does not auto-run just because a session ended; the user still has to want a write-up.
Output
- The draft text or saved draft path.
- The source artifacts used to build it.
- A note on whether the result is a public draft, a private note, or a short internal wrap-up.
Next skill options (only if needed): $public-artifact-lane — turn the session draft into a public-facing artifact; $ai-writing-detox — remove synthetic tone before sharing; $visual-explainer — add a supporting HTML explainer if the story needs diagrams or structure.
