sessions-to-blog
Scannednpx machina-cli add skill jmerta/codex-skills/sessions-to-blog --openclawSessions To Blog
Overview
Create publishable MDX blog posts from sessions/articles session logs with consistent voice, structure, and internal links, aligned to project standards.
Workflow
-
Resolve project standards and output location
- Find the project's MDX article standards and output location (check repo docs, AGENTS, README, or content guidelines).
- If standards or location are not found, ask the user before drafting.
-
Clarify scope and output
- Ask for date range, audience, and desired length if not provided.
- Use the language of the user's prompts in the logs; confirm if mixed or unclear.
-
Gather source entries
- Read the relevant
sessions/articles/YYYY-MM-DD.mdblocks for the selected dates. - Extract: intent, actions, artifacts, decisions, progress, open questions, and any file paths.
- Read the relevant
-
Plan the post
- Build a short outline using the template in
references/examples.md. - Select 3 to 7 key highlights; prioritize user intent and outcomes.
- Build a short outline using the template in
-
Draft in the defined style
- Follow
references/style-and-structure.md. - Keep facts grounded in the logs; mark uncertainty explicitly.
- Follow
-
Apply internal linking rules
- Follow
references/linking-rules.mdfor links to source logs, files, and related posts.
- Follow
-
QA pass
- Check for missing sources, broken links, and inconsistent tense.
- Ensure the post is readable without the raw logs.
References
references/style-and-structure.mdfor voice, tone, structure, and language rules.references/linking-rules.mdfor internal links and citation conventions.references/examples.mdfor input and output examples and a lightweight template.
Source
git clone https://github.com/jmerta/codex-skills/blob/main/sessions-to-blog/SKILL.mdView on GitHub Overview
Sessions To Blog creates publishable MDX blog posts from sessions/articles logs, ensuring a consistent voice, structure, and internal links that align with project standards. It streamlines turning daily notes into blog-ready content and enforces defined writing style and linking practices.
How This Skill Works
It reads session logs from sessions/articles/YYYY-MM-DD.md, resolves project standards and output locations, and clarifies the desired scope. It then extracts key elements (intent, actions, artifacts, decisions, progress, open questions, and file paths), drafts an outline from the references/examples.md template, writes in the project’s style, applies internal linking rules from references/linking-rules.md, and performs a QA pass before delivery.
When to Use It
- Turning daily session notes into publishable MDX blog posts.
- Defining or updating writing style and internal linking rules for posts.
- Producing MDX drafts that follow project standards and file location requirements.
- Generating weekly or date-range recap posts from session logs.
- Preparing posts tailored to a specific audience or length constraint.
Quick Start
- Step 1: Resolve project standards and output location; confirm scope.
- Step 2: Gather source entries from sessions/articles/YYYY-MM-DD.md and plan outline.
- Step 3: Draft MDX in the defined style, apply internal links, and run QA.
Best Practices
- Clarify the project’s MDX standards and output location before drafting.
- Read and extract intent, actions, artifacts, decisions, progress, questions, and file paths from logs.
- Plan a short outline using the template in references/examples.md and prioritize 3-7 key highlights.
- Follow the style-and-structure guidelines and mark uncertainties clearly.
- Apply linking rules and perform QA for sources, links, and tense consistency.
Example Use Cases
- Publish a daily MDX recap from 2024-11-01 logs with internal links to artifacts.
- Draft a project-wide blog post summarizing a week’s session notes with consistent voice.
- Create an MDX post that links to related logs and code files using the project's linking rules.
- Generate a concise recap with 5 key highlights and decisions.
- Produce an MDX draft that adheres to file location sessions/articles and standards.
