writing-tech-post

What problem does it solve?

This Skill helps you draft end-to-end engineering blog posts that match the right archetype, maintain narrative clarity, and hold every major claim to evidence and disclosure standards.

Core Features & Use Cases

• Archetype-first structure: selects and enforces the correct post contract (launch, postmortem, migration, performance, tutorial, research-to-product translation, AI/agent, security/reliability), including hybrid handling rules.
• Evidence cadence and validation: routes you to the required evidence forms (diagrams, timelines, distribution charts, named benchmarks, ablations, guardrails, code snippets) and enforces a claim → artifact → reading pattern.
• Voice and disclosure ethics: applies genre-specific registers such as blameless postmortem wording, coordinated disclosure timing for security, and paper-link-first attribution for AI/agent posts.
• Pre-publish gating: runs lint-like checks for slop signatures (hedged ledes, triumphal language, evidence-free percent claims, unelided long code blocks) and applies an archetype-conditional publishability rubric.

Quick Start

Use the writing-tech-post workflow to draft a new engineering post from your outline while ensuring you include the correct archetype frontmatter, read the required reference contract files, and finish with the pre-publish gate before submission.