Skip to content
cccskills
FreePublished on GitHub

technical-writing-skill

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

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

The English summary is being prepared. Showing the original description.

Works withQiitaZenn
See how to install

Files included (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 (original)

Review the instructions the agent will receive before you install.

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)

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

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

📂 Resources

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

Reviews

No reviews yet. Tell others what you thought.

Comments

No login needed. Share how it worked for you, ask a question, or note where it did not run.

No comments yet. Be the first to write one.

Comments are published right away. Do not include personal information such as email addresses or phone numbers. Up to 2 URLs.

0 / 1,000 characters

This form is protected by reCAPTCHA, and the Google Privacy Policy and Terms of Service apply.

More skills from this repository

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

The English summary is being prepared. Showing the original description.

shinobi-coder701/zenn-docs6Updated Sep 17, 2026

Optimize and convert Zenn Flavored Markdown (ZFM) articles to Dev.to (Forem) compatible Markdown. Use this skill whenever the user wants to post a Zenn article to Dev.to, needs to convert markdown for cross-posting, or asks to "optimize for dev.to". It handles front matter conversion, Liquid tag embeds, KaTeX math blocks, callout transformations, and general formatting adjustments required by Dev.to.

The English summary is being prepared. Showing the original description.

shinobi-coder701/zenn-docs6Updated Sep 17, 2026

AI生成UIの没個性的パターン(AIスロップ美学)を検出・回避し、文脈に根ざした意図あるデザインを生成するためのガード。フロントエンドのUI実装、デザイン生成、コンポーネント設計、CSSスタイリング、カラーパレット選定、フォント選択、レイアウト構築を行う際に自動的に適用する。「UIを作って」「画面を実装して」「デザインして」「スタイルを当てて」「ランディングページを作って」「Webサイトを作成して」「ダッシュボードを構築して」「コンポーネントを実装して」等のUI生成タスク全般で使用する。Claude Code、Codex、GitHub Copilot、Cursor、その他AIエージェント共通で適用可能。

The English summary is being prepared. Showing the original description.

shinobi-coder701/zenn-docs6Updated Sep 17, 2026

Marp形式プレゼンテーションの専門レビュー・評価・改善スキル。 10軸スコアリング(100点満点)で品質を定量評価し、具体的な改善コード付きで提案する。 Use when the user asks to: - Review, evaluate, or critique a Marp presentation / プレゼンをレビュー / 評価 / 添削 - Improve, polish, or upgrade existing slides / スライドを改善 / ブラッシュアップ - Check slide quality, score slides, or audit a deck / スライドの品質チェック / 採点 - "このプレゼンどう?" "スライドを見てほしい" "プレゼン資料のフィードバック" Reads .md files with Marp frontmatter, scores across 10 dimensions, and outputs a detailed review report with concrete before/after code improvements. Works as a companion to the marp-slides skill (generation → review → improvement cycle).

The English summary is being prepared. Showing the original description.

shinobi-coder701/zenn-docs6Updated Sep 17, 2026

Create professional, visually excellent presentation slides in Marp Markdown format. Use this skill when the user asks to: - Create a presentation, slides, deck, slideshow, or プレゼン / スライド - Write or generate slides about a specific topic - Make a Marp .md file for presenting Produces complete, ready-to-render .md files with embedded custom CSS theme, narrative structure, and polished visual design. Supports Japanese and English content.

The English summary is being prepared. Showing the original description.

shinobi-coder701/zenn-docs6Updated Sep 17, 2026

リポジトリの構造・技術スタック・機能一覧・セットアップ手順を動的に解析し、 包括的なドキュメントを自動生成するスキル。言語・フレームワーク問わず汎用的に動作する。 Use this skill whenever the user asks to: - Explain a repository / リポジトリの説明 / リポジトリの概要 - Generate a README / README生成 / README作成 - Understand project structure / プロジェクト構成を教えて / 構造を説明して - Learn how to run a project / 使い方を教えて / 動かし方 / セットアップ方法 - Get a repo overview / repo overview / explain this repo / what does this repo do - List features / 機能一覧 / このプロジェクトは何ができる? - Onboard to a new codebase / コードベースのキャッチアップ / 新しいリポジトリに入った - "このリポジトリ何?" "プロジェクトの全体像" "how to run this project" - "コードの全体を把握したい" "ドキュメントを整備して" "技術スタックを知りたい" This skill is especially useful when joining a new project, onboarding team members, or when a repository lacks proper documentation. It works with ANY repository regardless of programming language, framework, or project type.

The English summary is being prepared. Showing the original description.

shinobi-coder701/zenn-docs6Updated Sep 17, 2026

See all skills by shinobi-coder701

Report a problem with this skill