tech-article-writing

Guide technical-article writing through six phases using the Pyramid Principle and SCQA framework.

Updated Oct 4, 2021
One-click install
npx skills add https://github.com/gn-t-k/zenn-content --skill tech-article-writing
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: tech-article-writing
Source: https://github.com/gn-t-k/zenn-content/tree/main/tech-article-writing-skill
Command: npx skills add https://github.com/gn-t-k/zenn-content --skill tech-article-writing

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

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."

Frequently Asked Questions about tech-article-writing

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

FAQPage Schema
How do I structure a tech article using the Pyramid Principle and SCQA framework?

The Pyramid Principle and SCQA framework structure a tech article by framing the introduction with a Situation-Complication-Question-Answer flow and building a conclusion-first pyramid outline. This ensures a logical, BLUF-based argument progression that readers can easily follow.

What is the best way to write a Zenn article from scratch?

The best way to write a Zenn article is through a six-phase writing workflow: defining goals, designing structure, drafting, revising, polishing, and setting publication metadata. This dialog-driven process ensures a structured, repeatable path from initial concept to publish-ready tech blog.

Can I draft technical blogs interactively to shape each section as I write?

Yes, you can draft technical blogs interactively. The workflow uses collaborative drafting with interactive prompts, checkpoints, and guided questions to help shape each section, ensuring minimal friction and clear content progression throughout the writing process.

Does this writing workflow support formatting and metadata preparation for publication?

Yes, the writing workflow supports publication-ready outputs by facilitating preparation for Zenn articles and other tech-blog formats. It includes specific phases for polishing content and setting publication metadata to ensure the final article is ready for release.

How do I define the goals and target audience for a technical blog post?

To define goals and target audiences for a technical blog post, you initiate the first phase of the workflow. This phase guides you through specifying your article's objective, identifying the intended readers, and establishing any constraints before designing the structure.