/tech-blog¶
Authoring class
Writes exactly one artifact into the repo, then proposes the commit — never runs git itself. Shared rules: CONVENTIONS-authoring.md.
Runs a multi-agent pipeline (writer → fact-checker → reviewer → editor → optional poster), grounds every claim in the actual repo (the fact-checker BLOCKS on anything it can't verify), embeds architecture diagrams if present, writes the post to docs/blog/, and produces publish-ready Markdown + HTML. Posts via an MCP only if one is connected and you opt in.
At a glance¶
| Run it | /tech-blog |
| Class | authoring |
| Version | 0.2.0 |
| Author | navjyotnishant |
| Cost | a 6-agent pipeline (writer → fact-checker → reviewer → editor → final-polish → platform-lint), plus one extra writer+fact-checker round per fact-check retry (capped at 2, §C) |
| Needs | rsvg-convert · DEVTO_API_KEY or a publishing MCP |
| Source | skills/tech-blog/SKILL.md |
What it needs, and what happens without it¶
Every tool is detected at runtime — none is installed for you.
| Tool | Without it |
|---|---|
rsvg-convert |
embeds the SVG directly |
DEVTO_API_KEY or a publishing MCP |
hands you the publish-ready files |
The pipeline¶
Agents it spawns¶
blog-editor— Produce the final, polished version of a technical blog post — applying the fact-checker's required…blog-fact-checker— Verify every technical claim in a draft blog post against the actual repository — APIs, features, file paths…blog-final-polish— Use this agent as the last checklist gate on a finished blog post — before publishing — to catch mechanical…blog-platform-lint— Use this agent right before publishing a finished blog post to an external platform (Dev.to first; extensible…blog-poster— Use this agent when the user has opted in to publishing a finished blog post to an external platform.…blog-reviewer— Critique a fact-checked technical blog draft for structure, clarity, technical depth, narrative flow, and…blog-writer— Write the first draft of an expert-level technical blog post about a project, grounded in a repo model. It…diagram-architect— Turn a project's docs and code structure into an architecture diagram — it reads the repo model, builds a…social-post— Draft promotional social copy (LinkedIn / X) for a PUBLISHED thing — a blog post, repo, or demo — grounded in…
The procedure¶
The executable steps live in the skill file itself and are deliberately not reproduced here: they are instructions to the model at runtime, not documentation.