その他のClaude Codeスキルはこちら：Claude Code 自作スキル集まとめ
はじめに
Qiitaに記事を投稿するとき、タグ選びに悩んだことはありませんか？ タグは読者のフィードへの表示を左右する大切な要素です。でもタグ選定の際、「そもそもどんなタグがあったっけ」と分からなくなります。参考に タグ一覧ページ をも見に行くのですが、そのページへ行くのも面倒。。
そこで、記事の内容から最適なタグをAIが推薦するスキル /suggest-tags を、Claude Codeで作りました。
できること
/suggest-tags <ファイルパス> で実行します。
| 機能 | 説明 |
|---|---|
| 記事の分析 | タイトル・本文・コードブロックの記載を読み取り、主題と技術キーワードを把握 |
| タグ候補の提示 | 人気タグ上位100の中から、8〜10個の候補を、タグ名・記事数・選定理由の表形式で提示 |
| ユーザーによる選択 | 候補から5つのタグをユーザーが選ぶ。選外のタグも追加・変更OK |
| frontmatter自動更新 | 確定後、記事ファイルの tags: を自動で書き換え |
| タグリスト更新 |
--update オプションでQiitaから最新の人気タグを取得し、更新 |
実行例
対象記事：「WSL2版 Claude Code にスクショをサクッと渡す操作を 3→2キーに減らした」
## タグ候補: 20260326-wsl2-claude-code-screenshot-shortcut.md
| # | タグ | 記事数 | 選定理由 |
|---|------------|---------|------------------------------------------------------|
| 1 | Windows | 14,643 | Windows環境が前提。フォロワー数で大幅な露出増が見込める |
| 2 | PowerShell | 5,387 | 記事の主要言語。Win32 APIのコードが中心 |
| 3 | ShellScript | 5,353 | スクリプト自動化のカテゴリとしてリーチ拡大 |
| 4 | ClaudeCode | 3,381 | Claude Codeへのスクショ連携が記事の目的そのもの |
| 5 | WSL | 3,020 | WSL環境でのファイル連携が主題 |
| 6 | 自動化 | 2,646 | 常駐スクリプトによるホットキー自動化がテーマ |
| 7 | AI | 16,991 | AI活用事例として広いフォロワー層にリーチ |
| 8 | Linux | 23,844 | WSL経由のLinux操作に触れており関連性あり |
現在のタグ: PowerShell, 自動化, WSL, 開発効率化, ClaudeCode
**この中から5つ選んでください。候補外のタグを自由に追加・差し替えもOKです。**
元々付けていた開発効率化（人気タグリスト外）の代わりに、Windows（14,643件）や Linux（23,844件）といった高フォロワータグが候補に入っています。
ユーザーが「1,2,5,7で」のように番号を伝えると、frontmatterの tags: が自動更新されます。「1,3,5とDockerとWSL2で」のように候補外のタグを混ぜることもできます。
タグ選定のしくみ
基本方針: 閲覧数の最大化
スキルの選定方針は 「閲覧数が増えるタグの組み合わせを選ぶ」 です。記事数の多いタグはフォロワーが多く、より多くの人のフィードに記事が表示されます。関連性がある限り記事数の多いタグを優先することで、記事の露出を最大化します。
ただし、記事内容と無関係なタグは推薦しないよう明文化しています。閲覧数よりも信頼性が大事です。
最終的にはユーザー自身がタグを選択するため、自分なりのテイストを加えられます。
選定の優先順位
4段階の優先順位でタグを選びます。
| 優先度 | 種類 | 例 | 役割 |
|---|---|---|---|
| 1 | 主題に直結するタグ |
Python, Docker
|
記事の核。必須 |
| 2 | フレームワーク/ツール名 |
Django, React
|
検索流入を狙う |
| 3 | カテゴリタグ |
初心者, 備忘録, 個人開発
|
対象読者層へのリーチ拡大 |
| 4 | 関連技術タグ | 副次的に触れている技術 | タグフォロワー経由の追加露出 |
人気タグ上位100をハードコード
タグの候補元は、Qiitaタグ一覧の記事数上位100タグです。このリストをSKILL.md内にハードコードしています。
毎回Webから取得する方式も検討しましたが、レスポンスが遅くなるため、ハードコード方式を採用しました。人気タグの順位はそう頻繁には変動しないので、実用上は問題ありません。
リストからは重複タグ（Python3 → Python、Windows10 → Windows 等）や特定コミュニティ向けタグを除外し、汎用的に使えるようにしています。同義タグは記事数が多い方を優先するルールです。
タグリストの更新（--update）
タグリストが古くなったと感じたら、--update オプションで最新データに更新できます。
/suggest-tags --update
更新時の動作は以下のとおりです。
- Qiitaのタグ一覧ページから最新の人気タグを取得
- 記事数上位100タグに絞り、重複タグを除外
- SKILL.md内のタグリストと日付（「2026年4月時点」など）を自動で書き換え
SKILL.mdの導入方法
以下のGistからSKILL.mdを取得し、<プロジェクト>/.claude/skills/suggest-tags/SKILL.md に保存すれば使えます。
このスキルは、Qiita CLI以外のプロジェクトでも、frontmatterにタグを持つMarkdownファイルであれば応用できます。タグリストを自分の投稿先プラットフォームに合わせて差し替えれば、例えば、Zenn等でも同じ仕組みで使えます。
まとめ
-
/suggest-tagsは、Qiita人気タグ上位100から閲覧数を最大化するタグを推薦する - 8〜10個の候補からユーザーが5つを選ぶため、AIに丸投げせず自分で最終判断できる
- タグ確定後はfrontmatterを自動更新
-
--updateで候補タグの鮮度も維持できる