tech-article-writing

What problem does it solve?

This Skill guides users through six phases of technical-article writing in a dialog-driven workflow, ensuring a structured and repeatable process from goal to publication. It applies the Pyramid Principle and the SCQA framework to frame the introduction, build a pyramid-style outline, and produce a publish-ready article. It helps writers of all levels craft clear, compelling technical articles (e.g., Zenn articles, technical blogs) with minimal friction.

Core Features & Use Cases

• Six-phase workflow: Phase 1: define goals and audience; Phase 2: design structure; Phase 3: draft; Phase 4: revise; Phase 5: polish; Phase 6: publication settings.
• Pyramid Principle & SCQA integration: supports BLUF-based conclusions and structured argument flow.
• Collaborative drafting: interactive prompts, checkpoints, and guided questions to shape each section.
• Publication-ready outputs: facilitates preparation for Zenn articles and other tech-blog formats, including formatting and metadata.

Quick Start

To begin, describe your article goal, target audience, and any constraints. Then ask the agent to initiate the six-phase workflow, for example: "I want to write a Zenn article about GraphQL caching" and "start Phase 1."