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.