AIが吸わないコードを書くように教える。

このリポジトリには、Robert C. MartinのClean Codeの原則を強制するエージェントスキルが含まれています。 Google Antigravity、AnthropicのClaudeコード、およびAgent Skills標準をサポートするエージェントと連携します。

なぜ?

AI はコードを高速に生成しますが、研究では、技術的な負債を高速化します。

• GitClear:AIの採用とのコード重複の増加4x -Carnegie Mellon:+30%静的解析警告、Cursor導入後の+41%コード複雑性
• Google DORA: AIの採用とソフトウェアの配信安定性のネガティブな関係

これらのスキルは、AIワークフローに間接的に、戦闘テストされたソリューションを正確にエンコードします。

含まれているもの

| トラック | スキル | 説明 | ルール | ルール | |----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | パイソン | [boy-scout | オンラインショップ** — 常にコードクリーナーを離れる | すべてのスキルの座標 | | パイソン | [[T1] | マスタースキル** 全 66 ルール | C1-C5、E1-E2、F1-F4、G1-G36、N1-N7、P1-P3、T1-T9 | | パイソン | [[T2] | 最小限・正確なコメント | C1-C5 | | パイソン | [[[T3] | 小さく、焦点を絞った、明らかな機能 | F1-F4 |

Clean Code Skills for AI Agents

Teach your AI to write code that doesn’t suck.

This repository contains Agent Skills that enforce Robert C. Martin’s Clean Code principles. They work with Google Antigravity, Anthropic’s Claude Code, and any agent that supports the Agent Skills standard.

Why?

AI generates code fast, but research shows it also generates technical debt fast:

• GitClear: 4x increase in code duplication with AI adoption
• Carnegie Mellon: +30% static analysis warnings, +41% code complexity after Cursor adoption
• Google DORA: Negative relationship between AI adoption and software delivery stability

These skills encode battle-tested solutions to exactly these problems—directly into your AI workflow.

What’s Included

Use the master skill for comprehensive coverage, or individual skills for targeted enforcement.

Choose Your Language

Pick one track and copy only that track’s skills:

[!WARNING] Install only one language track per skills directory. Python and TypeScript tracks reuse the same skill names (boy-scout, clean-functions, etc.). Installing both together can make the agent load conflicting instructions and behave inconsistently.

# Python track
cp -r skills/python/* /

# TypeScript track
cp -r skills/typescript/* /

The Boy Scout Rule