writing-tech-post

Generate archetype-compliant engineering blog posts with evidence validation and pre-publish linting.

182|8|Updated Apr 4, 2026
One-click install
npx skills add https://github.com/compozy/agh --skill writing-tech-post
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: writing-tech-post
Source: https://github.com/compozy/agh/tree/main/.agents/skills/writing-tech-post
Command: npx skills add https://github.com/compozy/agh --skill writing-tech-post

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) and assets (resource) and scripts (resource) components.

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.

Frequently Asked Questions about writing-tech-post

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I write an engineering blog post that requires rigorous evidence and disclosure?

To write an engineering blog post with rigorous evidence, you enforce a structured writing contract that maps claims to artifacts like diagrams, benchmarks, and code snippets, validating against genre-specific disclosure rules before publishing.

What is the best way to structure an incident postmortem for a technical audience?

The best way to structure an incident postmortem is using a blameless archetype that enforces a claim-to-artifact reading cadence, requiring timelines and distribution charts to validate operational claims for technical readers.

How do I prevent triumphal language and evidence-free claims when drafting architecture migration posts?

To prevent triumphal language and evidence-free claims in architecture migration posts, you apply pre-publish linting checks that flag slop signatures like hedged ledes and unvalidated percent claims, passing them through a publishability gate.

Can I use a single workflow to draft both performance deep-dives and AI/agent capability posts?

Yes, you can draft performance deep-dives and AI/agent capability posts within a single workflow by routing to mandatory reference contracts, applying hybrid handling rules and specific registers like paper-link-first attribution for AI content.

What evidence artifacts do I need to include when writing a security or reliability disclosure?

When writing a security or reliability disclosure, you need evidence artifacts such as named benchmarks, timelines, and guardrails, while strictly applying coordinated disclosure timing and genre-specific registers to pass pre-publish gating.

When should I avoid using a standard tutorial archetype for engineering content?

You should avoid using a standard tutorial archetype when your content involves research-to-product translations or security disclosures, as these require distinct evidence cadences and coordinated timing instead of standard instructional formatting.