Technical Writing

このSEOスキルは、テクニカルSEO、オンページ最適化、構造化データ、Core Web Vitals、キーワードマッピングの監査・計画・実装を支援します。クロール可能性、インデックス可能性、メタデータ、schema、内部リンク、sitemapやrobotsの変更、またはKeyword Research向けのSEOに使えます。ページ単位でそのまま実装できる具体的な指針を提供します。

java-coding-standardsスキルは、Spring Bootサービスで読みやすく保守しやすいJava 17+を書くための実践的な指針を提供します。命名、イミュータビリティ、Optional、streams、例外、generics、package構成をカバーし、コーディング、リファクタリング、Code Reviewでのjava-coding-standardsに役立ちます。

cpp-coding-standards は、C++ Core Guidelines をベースにした C++ コーディング規約ガイドです。安全性、明確さ、保守性、RAII、型安全性、適切な設計を重視しながら、モダン C++ の作成、レビュー、リファクタリングに使えます。Code Review や実務的なチーム判断で cpp-coding-standards を活用したい場合に適しています。

code-tour は、実際のファイルと行番号アンカーを持つ再利用可能な CodeTour `.tour` ファイルを作成します。オンボーディングツアー、アーキテクチャの walkthrough、PR ツアー、RCA の導線、そして Technical Writing 向けの code-tour が必要で、単なる要約ではなくガイド付きの順序立った説明を求めるときに使ってください。

article-writingスキルは、構成力・文体の一貫性・根拠の明確さを備えた長文コンテンツの下書き作成を支援します。記事、ガイド、チュートリアル、ニュースレター、そして完成度の高い公開向け原稿が求められるCopywritingワークフローでのarticle-writing用途に適しています。

architecture-decision-records は、Claude Code のセッション中に生まれるアーキテクチャ上の判断を、構造化された ADR として記録できるスキルです。意思決定のタイミングを捉え、背景、選択肢、判断理由を整理して残し、将来の保守担当者のために ADR の履歴を維持します。長く参照できる意思決定の記録が必要な Technical Writing やエンジニアリングチームに向いています。

api-design は、エンドポイント設計やリソース命名、ステータスコード、ページネーション、フィルタリング、バージョニング、エラーレスポンスの計画・レビューに役立つ REST API 設計スキルです。

brainstorming は、実装前に文脈整理と設計検討を進めるための skill です。確認質問を一度に一つずつ行い、コードに入る前に設計承認を必須とします。任意で使える visual companion を備え、Requirements Planning の支援も充実しています。

writing-plansは、仕様書や要件定義書を、ファイル単位の実装方針、作業順序、テスト手順、さらにコーディング開始前のレビュー用プロンプトを含む詳細な実装計画へ落とし込むためのスキルです。

doc-coauthoring は、AI と技術文書を共著するための構造化ワークフローです。情報収集、反復的な構成設計、章ごとの執筆、読者テストを通じて、レビュー可能な仕様書、RFC、提案書の作成を支援します。

technical-writer は、README、API docs、setup guides、tutorials、onboarding docs、release notes をより分かりやすく作るための軽量な documentation skill です。Technical Writing を、ユーザーの目的、quick starts、examples、troubleshooting を軸に整理できるのが特長です。提供形態は単一の SKILL.md ファイルで、追加の scripts や templates は必要ありません。

document-release は、リリース後のドキュメント更新に使う skill です。プロジェクト文書を読み、出荷済みの diff を突き合わせて、README、ARCHITECTURE、CONTRIBUTING、CLAUDE.md、CHANGELOG、VERSION を実際のリリース内容に合わせて更新します。コードのマージ後に、信頼できる document-release ガイドが必要な技術文書作成で活用してください。

caveman は、技術的な返答、要約、デバッグ支援を極力短く伝えるための超圧縮コミュニケーション skill です。技術的な意味は保ったまま、冗長な表現を削り、トリガー後は「stop caveman」または normal mode と指示するまでそのまま有効です。Technical Writing、コードレビューのメモ、障害対応の更新、すでに話題を理解している相手との素早い往復に向いています。

edit-article skill は、既存の下書きを組み直し、明確さを高め、文章を引き締めるのに役立ちます。記事を見直すための信頼できる edit-article ガイドが必要なとき、特にセクションの順序や依存関係が重要な技術文書のワークフローで使うのに向いています。

writing-shape は、Markdown の下書き素材を公開可能な記事へ整えるための対話型ドラフト作成スキルです。冒頭の選定、段落ごとの展開、構成の判断を支援し、Technical Writing、インタビューのメモ、文字起こしの整理、ラフな下書きの整形に役立ちます。1回きりのプロンプトではなく、ガイド付きの編集プロセスが必要なときに writing-shape ガイドを使ってください。

grill-with-docs は、計画とドキュメント化に特化したスキルです。既存のリポジトリのドメインモデルに対して提案を突き合わせ、用語を磨き込み、判断が固まるたびに `CONTEXT.md` と ADR を更新します。Technical Writing、プロダクト志向のエンジニアリング、そしてプロンプトだけの発想会議よりも、リポジトリに根ざした言葉選びが重要なワークフローで有効です。

ubiquitous-language は、会話から共有用語集を抽出し、曖昧な用語や同義語を検出し、UBIQUITOUS_LANGUAGE.md を作成する DDD スタイルのスキルです。ドメイン用語を定義してチームの認識を揃え、Technical Writing における ubiquitous-language を改善したいときに使えます。

python-code-styleは、Pythonのフォーマット、lint、命名、型ヒント、docstringの運用を整理したいときに役立つスキルです。pull requestのレビュー、チーム内のコーディング規約の統一、`pyproject.toml`での`ruff`、`mypy`、`pyright`の方針整備に活用できます。

architecture-decision-records は、背景、決定内容、代替案、影響を明確に整理しながら、チームが ADR を作成・更新できるようにし、長く参照できる技術的意思決定の記録を残しやすくします。

changelog-automationは、Keep a Changelog、SemVer、release notes、Conventional Commitsを軸に、チームのchangelog運用を設計するためのスキルです。導入時の前提整理、利用時に必要な入力の定義、そしてTechnical Writingや開発者向けドキュメントにおけるrelease notesの一貫性向上に役立ちます。

add-educational-comments は、指定したコードファイルの構造や挙動を保ったまま、学習向けのコメントを追加するスキルです。対象ファイルが未指定なら確認を促し、読み手のレベルに合わせて説明の粒度を調整しながら、教育目的のコード編集として明確な行数増加の上限ルールに従って処理できます。

gws-docs は、作成・取得・一括更新をメソッド単位で制御しながら、gws CLI 経由で Google Docs を読み書きできるようにします。技術文書作成やドキュメント自動化に向けて、gws-docs ガイドのインストール、スキーマ、使用方法の流れに沿って進めてください。

adr-skill は、エージェントが実行可能な Architecture Decision Records をチームで作成・運用するためのスキルです。ADR のドラフト作成、ADR フォルダの初期セットアップ、テンプレート選定、ステータス更新、チェックリスト・スクリプト・実例を使った意思決定の検証を支援します。

Clarifyは、わかりにくいUXコピー、エラーメッセージ、ラベル、オンボーディングの手順、各種案内文を改善し、ユーザーが迷わず行動できるようにするスキルです。Technical Writing、サポート向けコンテンツ、UIテキストをより明確にしたいプロダクトチームに適しています。書き換えに入る前に、文脈、対象ユーザー、ユーザーの状態を確認するため、より直接的で具体的かつ使いやすい表現に整えやすいのが特長です。