tech-writer
Installation
SKILL.md
Technical Writer Skill (万能型テクニカルライター)
あらゆる技術を「言語化・構造化」するプロフェッショナルとして振る舞います。 特定の技術に固執せず、未経験の領域でも「公式ドキュメント」や「ソースコード」から即座に本質を理解し、読者が最短で理解できる形に再構築します。
使用タイミング (When to Use)
- 技術的なトピック(ライブラリ、ツール、概念、実装手法など)について解説記事を書きたいとき。
- 散らばった情報や難解なドキュメントを、分かりやすく構造化された記事にまとめたいとき。
- 「なぜ(Why)」と「どのように(How)」をセットで語り、深い理解を促す記事が必要なとき。
必要な素材 (Input Requirements)
高品質な記事を作成するために、以下のいずれかの情報をコンテキストとして提供してください。
- 作業ログ / 変更履歴:
git log -p,git diff, またはtech-storytellerの出力。実際の実装詳細がないと、精神論だけの記事になってしまいます。 - 設計ドキュメント:
SPEC.md,ARCHITECTURE.mdなど、意図や背景が書かれているもの。 - 箇条書きメモ: 執筆したいトピックに関する開発者のラフなメモ書き。
Related skills
More from keiji-miyake/agent-skills
architect
要件定義とシステム設計の専門家。抽象的な要求を具体的な仕様書(SPEC.md)と設計書(DESIGN.md)に変換し、Mermaid図を用いてシステム構造を可視化します。
36developer
実装とコーディングの専門家。設計書に基づき、プロジェクトの規約と構造を遵守しながら高品質なコードを実装します。使用言語に合わせてその言語のスペシャリストとして振る舞います。
30qa
品質保証とテストの専門家。バグの発見、エッジケースの検証、テスト計画の策定、自動テストの作成を行い、ソフトウェアの信頼性を担保します。
29devops
インフラ構築とCI/CDの専門家。アプリケーションを安全かつ確実にデプロイするための環境設定、パイプライン構築、セキュリティ管理を担当します。プラットフォーム非依存(AWS/GCP/Cloudflare等対応)。
25dev-support
短時間で中断可能な開発セッションに最適化されたプロジェクト管理スキル。機能設計、ドキュメント作成(要件、アーキテクチャ、テスト計画、ロードマップ)、中断時のコンテキスト管理、作業再開時に使用します。あらゆる技術スタックに対応し、断片化された作業セッションでも生産性を維持するのに役立ちます。
20scaffold
AI駆動開発のためのプロジェクト初期構築スキル。AGENTS.mdの作成、基本指示の設定、およびコアスキルのインストールを自動化します。
17