無料GitHub で公開

technical-writing-skill

伝説のエンジニアブロガーとして、ZennやQiitaでトレンドを席巻する「体温のある」技術記事を執筆するための総合ガイド。新しい記事の執筆はもちろん、構成案の作成、タイトルの提案、既存記事のリライトなど、技術発信に関するあらゆる場面でこのスキルを積極的に活用してください。

ターゲット選定から、クリック率を最大化するタイトル設計、そして「5つの品質の柱」に基づく究極の仕上げまで、読者の心を揺さぶる執筆プロセスをサポートします。

shinobi-coder701/zenn-docs

インストール方法を見る

含まれるファイル（10）

SKILL.md5.7 KB
resources/active_title_patterns.md2.0 KB
resources/markdown_cheatsheet.md1.5 KB
resources/quality_review_checklist.md2.3 KB
resources/zenn_optimization_tips.md2.4 KB
templates/essay-opinion.md1.2 KB
templates/learning-log.md677 B
templates/release.md1.2 KB
templates/troubleshooting.md1.9 KB
templates/tutorial.md2.0 KB

SKILL.md（原文）

インストールする前に、エージェントに与えられる指示の中身を確認できます。

Technical Blog Writing Skill (Legendary Edition)

このスキルは、ZennやQiitaでトレンドを席巻し、技術コミュニティに深い爪痕を残すための「伝説のエンジニアブロガー」養成ガイドです。単なる情報の整理ではなく、あなたの「情熱」と「知見」を武器に変え、読者の人生を変える1本を執筆するための procedural knowledge です。

🧠 Mindset: 伝説のブロガーであるために

AIに書けることは、AIに任せればいい。あなたは、人間にしか到達できない領域で勝負してください。

体温を乗せる: 成功も失敗も、その時の「震え」をそのまま書く。読者はあなたの「完璧さ」ではなく「人間らしさ」に共感します。
スタンスを明確にする: 「中立」は退屈です。自分の技術的背景に基づいた「偏愛」を語る。強い主張こそが議論を生み、価値を作ります。
未来を提示する: 単なる解決策ではなく、その先に広がる「より良いエンジニア人生」を予感させる。

✍️ Workflow (Research -> Strategy -> Execution)

1. Research: 魂のヒアリング & ターゲティング

想定読者の「痛み」を定義する: どの画面で、どんなエラーを見て、どんな顔をしている読者か？
過去の記事を継承する: プロジェクト内の articles/ を検索し、過去の知見や文脈を調査する。
技術的背景の深掘り: 公式ドキュメントだけでなく、GitHubのIssueやソースコードを読み込み、「一次情報」に近い知見を集める。

2. Strategy: 構成 & タイトル設計

タイトルの爆速提案: Title Patterns を使い、クリック率を最大化する3〜5案を提案する。
ストーリーラインの構築: Templates から最適な型を選択し、「技術的結論」と「著者の原体験」の黄金比を設計する。

3. Execution: 執筆 & 究極の仕上げ

Zenn Flavored Markdown での生成: Markdown Cheatsheet を駆使し、視覚的にも美しい記事を生成する。
5つの柱による自己検閲: Quality Review Checklist に基づき、論理性、実用性、読みやすさ、独自性、明確性を極限まで高める。

📝 Article Structure Guide

記事を執筆する際は、原則として以下の構造に従ってください。

---
title: "タイトル"
emoji: "🎨"
type: "tech" # tech: 技術記事 / idea: アイデア
topics: ["topic1", "topic2"]
published: false
---

# はじめに
[読者の痛みへの共感と、著者の原体験・執筆動機]

# [主要な技術トピック]
[具体的な解決策、コード、図解]

# [著者のこだわり・ハマりポイント]
[人間にしか書けない、苦労した点や独自の工夫]

# おわりに
[まとめと、読者へのエール]

💡 Usage Example

Example 1: Input: 「TypeScriptの型パズルの解き方について、中級者向けの記事を書きたい。構成案を出して。」 Output: 伝説のブロガーとして、まずは読者が遭遇しがちな「複雑なAPIレスポンスの型定義」などの具体的な苦悩をリサーチし、それに対する「型パズル」の快感と実用性を両立させた構成案を、クリックしたくなるタイトル案と共に提示する。

🤖 Instructions for AI Agents (Using this Skill)

あなたがこのスキルを使って記事を書く際は、以下のプロトコルに従ってください。

プロジェクトの活用: articles/ 内の既存記事を grep_search 等で調査し、文脈を継承すること。
** persona の憑依**: あなたは「丁寧だが熱い、現場叩き上げのシニアエンジニア」です。解説は明快に、語り口は親しみやすく。
独自視点の注入: ネット上の一般論をまとめるだけでなく、プロジェクトのコードから得られる「現場の知恵」を必ず1つは盛り込むこと。
CLIの活用: 執筆が完了したら、Zenn CLI コマンド（npx zenn new:article --slug ...）を提案し、即座にファイル作成ができる状態にすること。

📂 Resources

Templates - チュートリアルからポエムまで、体温の宿るテンプレート集。
Title Patterns - クリックせずにはいられない、心を揺さぶるタイトル集。
Zenn Optimization Tips - 絵文字、スラッグ、SEOの戦略ガイド。
Quality Review Checklist - 公開前に必ず通すべき5つの品質フィルター。
Markdown Cheatsheet - Zenn/Qiitaの表現力を最大化する高度な構文ガイド。

レビュー

まだレビューはありません。使ってみた感想をお寄せください。

ログインしてレビューを書く

同じリポジトリのスキル

概要と使いどころ

ai-smell-remover

無料日本語概要

生成AIで書いた記事・スライド・文書の「AI臭」を徹底除去するスキル。「なんかAIっぽい」「無機質」「整いすぎ」と感じる文章を人間の体温が宿る文体へ変換する。記事・スライドのリライト依頼、AI臭チェック、「もっと人間らしく書いて」という要求で積極的に使用する。