Научите свой ИИ писать код, который не отстой.

Этот репозиторий содержит агентские навыки, которые обеспечивают соблюдение принципов «чистого кода» Роберта Мартина. Они работают с Google Antigravity, Claude Code от Anthropic и любым агентом, который поддерживает стандарт Agent Skills.

##Почему?

ИИ быстро генерирует код, но исследования показывают, что он также быстро генерирует технический долг.

GitClear: 4-кратное увеличение дублирования кода с внедрением ИИ Карнеги Меллон: +30% предупреждений о статическом анализе, +41% сложности кода после принятия Курсора Google DORA: Отрицательная связь между внедрением ИИ и стабильностью доставки программного обеспечения

Эти навыки кодируют проверенные в бою решения именно этих проблем — непосредственно в рабочий процесс ИИ.

Что включено

| Навыки | Описание | Правила |

| Python | boy-scout | Оркестратор — всегда оставляйте код чище, чем вы его нашли | Координирует все навыки | | Python | python-clean-code | Мастерский навык со всеми 66 правилами | C1-C5, E1-E2, F1-F4, G1-G36, N1-N7, P1-P3, T1-T9 | | Python | clean-comments | Минимальные, точные комментарии | C1-C5 | Python | clean-functions | Маленькие, сфокусированные, очевидные функции | 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