Technical Writing

Generate technical writing templates and workflows for English and Japanese articles.

4|Updated Oct 20, 2025
One-click install
npx skills add https://github.com/motoki317/dotfiles --skill technical-writing-motoki317
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: Technical Writing
Source: https://github.com/motoki317/dotfiles/tree/main/.claude/skills/technical-writing
Command: npx skills add https://github.com/motoki317/dotfiles --skill technical-writing-motoki317

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill provides a structured framework and practical guidelines for producing clear, high-quality technical writing, including patterns, workflows, and best practices to help writers create effective blogs, tutorials, and articles for external audiences.

Core Features & Use Cases

  • Provides article-type patterns (Tutorial, Concept, Comparison, Case Study, Opinion) with audience-focused guidance.
  • Outlines a step-by-step writing workflow (Ideation → Outline → Draft → Edit → Polish) and detailed best practices to improve clarity, conciseness, and credibility.
  • Offers language guidelines for English and Japanese, plus title patterns and structure templates to accelerate content creation.

Quick Start

Write a concise, audience-tailored technical article by first defining the core message, target readers, and chosen article type, then draft with code-ready examples and integrate a clear hook.

Frequently Asked Questions about Technical Writing

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

FAQPage Schema
What is the best way to structure a technical blog post for external audiences?▼

To structure a technical blog post, define the core message, target readers, and article type, then draft using section templates and frontmatter guidance to maintain consistency and credibility for external audiences.

How do I write a technical tutorial with clear code examples?▼

Write a technical tutorial by following the step-by-step writing workflow from ideation to polish, using code-ready example structures and audience-focused guidance to ensure clarity and conciseness.

What are the common patterns for writing technical articles?▼

Common patterns for writing technical articles include Tutorial, Concept, Comparison, Case Study, and Opinion, each providing audience-focused guidance and example structures to accelerate content creation.

Can I use technical writing guidelines for both English and Japanese content?▼

Yes, you can use these technical writing guidelines for both English and Japanese content, as they offer language-specific title patterns, structure templates, and best practices to accelerate content creation.

How do I ensure clarity and credibility when drafting technical documents?▼

Ensure clarity and credibility when drafting technical documents by applying detailed best practices and quality checklists during the edit and polish phases of the structured writing workflow.