engineering-writer

Converts engineering experience into structured technical articles using a five-section template.

Updated Apr 5, 2026
One-click install
npx skills add https://github.com/joleques/northstar-ai --skill engineering-writer
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: engineering-writer
Source: https://github.com/joleques/northstar-ai/tree/main/.codex/skills/engineering-writer
Command: npx skills add https://github.com/joleques/northstar-ai --skill engineering-writer

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Converts fragmented engineering experience and tacit knowledge into structured, practical technical articles that teach engineers how to reason about architecture, trade-offs, and evolution without resorting to hype or empty buzzwords.

Core Features & Use Cases

  • Structured five-section template: Provocation → Context → Experience → Analysis → Conclusion to ensure clarity and practical value.
  • Experience-grounded writing: Emphasizes real-world examples, common pitfalls, and learned trade-offs rather than abstract proclamations.
  • Format flexibility: Produces short LinkedIn posts, medium blog articles, or in-depth long-form pieces with adjustable lengths and tone.
  • Editorial guardrails: Enforces citation footnotes, a checklist for quality, and a consistent, mildly ironic yet humble author voice.
  • Use case: Transform a team's postmortem and design notes into a 1,200-word article that explains the architectural decision, what went wrong, and actionable recommendations.

Quick Start

Draft a medium-length (600–1000 word) article that opens with a real production problem about microservices, explains the technical context, shares practical experience, analyzes trade-offs, and finishes with a concise, actionable conclusion.

Frequently Asked Questions about engineering-writer

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

FAQPage Schema
How do I write a technical article about software architecture based on engineering experience?

To write a technical article about software architecture, use a five-section template: provocation, context, experience, analysis, and conclusion. This structure converts tacit engineering knowledge into practice-focused guidance with clear trade-offs and real-world examples.

What is the best way to structure a blog post about system design trade-offs and evolution?

The best way to structure a system design blog post is using a five-section template that moves from provocation to context, experience, analysis, and conclusion. This format enforces experience-grounded writing and citation footnotes to explain architectural decisions without hype.

Can I generate different article lengths for LinkedIn posts and long-form technical blogs?

You can generate adaptable article lengths for LinkedIn posts, medium blog articles, or in-depth long-form pieces. The format flexibility adjusts the length and tone while maintaining the structured five-section template and editorial guardrails for technical writing.

How do I convert postmortem and design notes into actionable engineering articles?

Convert postmortem and design notes into engineering articles by applying an experience-driven template that extracts the architectural decision, what went wrong, and actionable recommendations. This process emphasizes learned trade-offs and common pitfalls rather than abstract proclamations.

Does technical writing for engineering leads require citation footnotes and editorial checklists?

Technical writing for engineering leads requires citation footnotes and an editorial checklist to maintain quality and credibility. These editorial guardrails ensure the author voice remains consistent, mildly ironic yet humble, while grounding claims in real-world examples.