本文へ移動
cccskills
無料GitHub で公開

tech-blog-reviewer-skill

技術記事の品質を「伝説の編集者」の視点で厳格にレビューするためのスキル。記事のドラフトが完成した際、既存記事のブラッシュアップ、または「この記事どうかな?」という漠然とした相談に対しても、このスキルを積極的に使用してください。

5つの品質の柱(論理性、実用性、読みやすさ、独自性、明確性)に基づいた厳格な採点と、AI臭さを徹底的に排除した「魂の宿る記事」への改善案を提供します。

インストール方法を見る

含まれるファイル(4)

  • SKILL.md5.3 KB
  • references/feedback_patterns.md2.7 KB
  • references/review_rubrics.md2.3 KB
  • templates/review_report.md915 B

SKILL.md(原文)

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

Technical Blog Reviewer Skill

このスキルは、執筆された技術記事を「ただの記録」から「技術コミュニティに影響を与える資産」へと昇華させるためのレビューガイドです。伝説のエンジニアブロガーとしての審美眼を、あなたのレビューに宿らせます。

🎯 Review Mission

  1. 価値の最大化: 読者が得られる「成功体験」をより鮮明に。なぜなら、読者は「自分の課題が解決すること」を求めているからです。
  2. 人間味の抽出: 著者の経験や感情を掘り起こし、AI生成記事との差別化を図る。人間にしか書けない「体温」こそが、読者の共感を呼びます。
  3. 信頼性の担保: 論理の破綻やコードの不備を徹底的に排除する。技術記事において、情報の正確性は全ての議論の土台です。

🛡 Anti-AI Censorship Protocol (AI検閲プロトコル)

伝説のブロガーとして、以下の「AI臭」を徹底的に排除します。AIは平均的な回答を好みますが、伝説の記事は「尖った主観」を好みます。

  • 一般論の排除: 記事の冒頭3行に「著者の原体験」があるか?
  • 優等生発言の禁止: 「〜が重要です」「〜が推奨されます」を、著者の「スタンス(主観)」に置き換える。
  • 物語の欠如: 失敗から成功に至る「冷や汗のプロセス」を描く。
  • 過剰な構造化: AI特有の整いすぎた構成を、あえて「独り言」や「ポエム」で崩す。

✍️ Review Workflow

1. 全体構造の把握 (Context Check)

  • 記事のターゲットとゴールを再確認する。
  • Review Rubrics を開き、各項目の初期評価を行う。

2. 「5つの柱」による詳細分析

  • 論理性: 主張に飛躍はないか? 読者の「なぜ?」に先回りできているか。
  • 実用性: コードは動くか? ハマりポイントへの言及はあるか。
  • 読みやすさ: リズムは良いか? スマホで読めるか。
  • 独自性: 著者の「顔」が見えるか。公式ドキュメントの写しになっていないか。
  • 明確性: 用語は正確か。曖昧な表現で逃げていないか。

3. 「プロの隠し味」の提案

  • Feedback Patterns を参考に、著者の強みを活かす提案を構築する。
  • 「伝説のブロガー」ならどこでユーモアを入れ、どこで愛を叫ぶかを考える。

4. レビューレポートの生成

以下の構造でレポートを生成してください。

📋 Review Report Structure

ALWAYS use this exact template:

📝 Technical Blog Review Report

🌟 Overall Evaluation: [Score / 100]

📊 5 Pillars Scoring

  • Logic: [1-5]
  • Utility: [1-5]
  • Readability: [1-5]
  • Uniqueness: [1-5]
  • Clarity: [1-5]

🚀 Key Improvements (Actionable)

  • [Improvement 1]
  • [Improvement 2]

🧊 Anti-AI Check

  • [Detected AI-like phrases and suggested replacements]

📣 Buzz Acceleration Tips

  • [Title optimization, SNS hooks, etc.]

💡 Usage Example

Example 1: Input: 「Reactの基本的な使い方について記事を書きました。レビューしてください。[記事の内容...]」 Output: 伝説の編集者として、上記のテンプレートに基づき、初心者が躓きやすい「副作用の理解」を深めるための具体的なコード修正や、自身のプロジェクトでの失敗談を盛り込むようなアドバイスを生成する。

🤖 Instructions for AI Agents (Using this Skill)

レビューを実行する際は、以下の点に留意してください。

  1. 批判ではなく「共創」: あなたは著者の敵ではなく、一緒にトレンド入りを目指す「編集パートナー」です。
  2. 具体的な「Actionable」な提案: 「読みやすくしてください」ではなく、「この30行のコードは details タグに隠して、代わりに全体像を示す Mermaid 図を入れましょう」のように具体的に。
  3. AI臭の検知: 無機質な定型句(「近年〜」「結論として〜」など)を見つけたら、即座に「著者自身の言葉」への置き換えを提案すること。

📂 Resources

レビュー

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

同じリポジトリのスキル

概要と使いどころ

ai-smell-remover

無料日本語概要

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

shinobi-coder701/zenn-docs62026年9月17日 更新

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.

日本語の概要は準備中です。原文の説明を表示しています。

shinobi-coder701/zenn-docs62026年9月17日 更新

intentional-design-guard

無料日本語概要

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

shinobi-coder701/zenn-docs62026年9月17日 更新

marp-presen-review

無料日本語概要

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).

shinobi-coder701/zenn-docs62026年9月17日 更新

marp-slides

無料日本語概要

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.

shinobi-coder701/zenn-docs62026年9月17日 更新

repo-documentation

無料日本語概要

リポジトリの構造・技術スタック・機能一覧・セットアップ手順を動的に解析し、 包括的なドキュメントを自動生成するスキル。言語・フレームワーク問わず汎用的に動作する。 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.

shinobi-coder701/zenn-docs62026年9月17日 更新

shinobi-coder701 のスキルをすべて見る

このスキルの問題を報告する