code-analysis
コードが専門家以外にも理解しやすいか、変数名やコメントが明確か、専門用語が使われていないかなどをチェックし、誰でも読めるコードにするSkill。
📜 元の英語説明(参考)
Check if code is readable by non-developers - clear names, plain English comments, no jargon
🇯🇵 日本人クリエイター向け解説
コードが専門家以外にも理解しやすいか、変数名やコメントが明確か、専門用語が使われていないかなどをチェックし、誰でも読めるコードにするSkill。
※ jpskill.com 編集部が日本のビジネス現場向けに補足した解説です。Skill本体の挙動とは独立した参考情報です。
下記のコマンドをコピーしてターミナル(Mac/Linux)または PowerShell(Windows)に貼り付けてください。 ダウンロード → 解凍 → 配置まで全自動。
mkdir -p ~/.claude/skills && cd ~/.claude/skills && curl -L -o code-analysis.zip https://jpskill.com/download/16957.zip && unzip -o code-analysis.zip && rm code-analysis.zip$d = "$env:USERPROFILE\.claude\skills"; ni -Force -ItemType Directory $d | Out-Null; iwr https://jpskill.com/download/16957.zip -OutFile "$d\code-analysis.zip"; Expand-Archive "$d\code-analysis.zip" -DestinationPath $d -Force; ri "$d\code-analysis.zip"完了後、Claude Code を再起動 → 普通に「動画プロンプト作って」のように話しかけるだけで自動発動します。
💾 手動でダウンロードしたい(コマンドが難しい人向け)
- 1. 下の青いボタンを押して
code-analysis.zipをダウンロード - 2. ZIPファイルをダブルクリックで解凍 →
code-analysisフォルダができる - 3. そのフォルダを
C:\Users\あなたの名前\.claude\skills\(Win)または~/.claude/skills/(Mac)へ移動 - 4. Claude Code を再起動
⚠️ ダウンロード・利用は自己責任でお願いします。当サイトは内容・動作・安全性について責任を負いません。
🎯 このSkillでできること
下記の説明文を読むと、このSkillがあなたに何をしてくれるかが分かります。Claudeにこの分野の依頼をすると、自動で発動します。
📦 インストール方法 (3ステップ)
- 1. 上の「ダウンロード」ボタンを押して .skill ファイルを取得
- 2. ファイル名の拡張子を .skill から .zip に変えて展開(macは自動展開可)
- 3. 展開してできたフォルダを、ホームフォルダの
.claude/skills/に置く- · macOS / Linux:
~/.claude/skills/ - · Windows:
%USERPROFILE%\.claude\skills\
- · macOS / Linux:
Claude Code を再起動すれば完了。「このSkillを使って…」と話しかけなくても、関連する依頼で自動的に呼び出されます。
詳しい使い方ガイドを見る →- 最終更新
- 2026-05-18
- 取得日時
- 2026-05-18
- 同梱ファイル
- 1
📖 Skill本文(日本語訳)
※ 原文(英語/中国語)を Gemini で日本語化したものです。Claude 自身は原文を読みます。誤訳がある場合は原文をご確認ください。
コード可読性チェッカー
コードを分析し、非開発者（マネージャー、ステークホルダー、新しいチームメンバー）が理解できるようにします。
チェック内容
- 明確な命名: 意味不明な省略形は使用しない (usr_tkn → userToken)
- 平易なコメント: 日常的な言葉を使用し、専門用語は避ける
- ドキュメント: 主要なセクションについて、何/なぜ/どのように を記述する
- コメント率: 行の少なくとも 20% はコメントであること
使い方
python3 analyze.py --path your-file.py --strictness lenient例
悪いコード (スコア: 71/100):
def proc(usr, tkn):
tmp = usr + tkn
return tmp * 2問題点: 意味不明な名前、コメントなし、目的が不明確。
良いコード (スコア: 95/100):
def process_user_authentication(username, auth_token):
"""Validate user credentials and return auth score"""
combined_credential = username + auth_token
return combined_credential * 2既知の問題点
- ドキュメントファイルで誤検出が発生する可能性がある
- 実際のプロダクションコードで最も効果を発揮する
- ノイズを減らすには
--strictness lenientを使用する
📜 原文 SKILL.md(Claudeが読む英語/中国語)を展開
Code Readability Checker
Analyzes code to ensure non-developers (managers, stakeholders, new team members) can understand it.
What It Checks
- Clear naming: No cryptic abbreviations (usr_tkn → userToken)
- Plain comments: Everyday language, not technical jargon
- Documentation: What/Why/How for major sections
- Comment ratio: At least 20% of lines should be comments
Usage
python3 analyze.py --path your-file.py --strictness lenientExample
Bad Code (score: 71/100):
def proc(usr, tkn):
tmp = usr + tkn
return tmp * 2Issues: Cryptic names, no comments, unclear purpose.
Good Code (score: 95/100):
def process_user_authentication(username, auth_token):
"""Validate user credentials and return auth score"""
combined_credential = username + auth_token
return combined_credential * 2Known Issues
- May flag false positives in documentation files
- Works best on actual production code
- Use
--strictness lenientto reduce noise