К основному содержанию
скилл CX Codex

quality-auditor · oakoss — скилл для Claude Code: что проверяет и как ставить

Скилл quality-auditor проводит аудит кода по 12 взвешенным измерениям, ставит оценки с опорой на доказательства и собирает план улучшений.

MIT 120 установок ★ 29 обновлён 2026-08-17

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add oakoss/agent-skills --skill quality-auditor -a claude-code
Открыть на GitHub

Что делает quality-auditor

Скилл прогоняет проект по 12 измерениям с весами: качество кода, архитектура, документация, удобство, производительность, безопасность, тесты, поддерживаемость, опыт разработчика, доступность, CI/CD и инновации. Каждое измерение получает оценку от 1 до 10. Оценку без ссылки на файл, метрику или пример кода скилл не ставит.

Работа идёт в четыре фазы: сверка реестра с файловой системой, сбор материала, оценка и сборка отчёта. Разведку и прогон проверок он передаёт субагентам Explore, Task и Plan. Рядом лежит папка references с рубрикой, критериями по каждому измерению, шаблоном отчёта и разбором анти-паттернов.

Если фаза 0 не прошла, итоговая оценка упирается в 6/10 — такой порог зашит в самом скилле. Для стилевых правок и быстрых ревью без оценок он лишний, там справится линтер. Код от ИИ проверяется отдельно, по протоколу verification gap.

Какие задачи решает

  • оценить кодовую базу по 12 измерениям с весами
  • поймать непроверенные места в коде, который написал ИИ
  • подкрепить каждую оценку файлом или метрикой
  • собрать дорожную карту правок по приоритетам
  • сравнить два фреймворка по одной шкале

Примеры запросов агенту

  • Проведи аудит репозитория api/ по всем 12 измерениям и приложи доказательства к каждой оценке.
  • Прогони код, который сгенерировал агент в src/handlers/, по протоколу verification gap.
  • Собери отчёт по шаблону references/audit-report-template.md и расставь рекомендации по приоритетам.

Как установить quality-auditor

1Через Skills CLI (Vercel)

npx skills add oakoss/agent-skills --skill quality-auditor -a claude-code

2Вручную: положить файлы

~/.claude/skills/quality-auditor/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/quality-auditor/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о quality-auditor

Как установить quality-auditor в Claude Code?

Выполните npx skills add oakoss/agent-skills --skill quality-auditor -a claude-code. Скилл окажется в ~/.claude/skills/quality-auditor/SKILL.md.

Что делает quality-auditor?

Оценивает кодовую базу по 12 взвешенным измерениям и отдаёт отчёт с приоритетами улучшений. Каждая оценка подкреплена доказательством.

Почему аудит вернул не больше 6/10?

Не прошла фаза 0: реестр не совпал с файловой системой. В этом случае скилл ограничивает общий балл.

Исходный текст

SKILL.md · MIT
---
name: quality-auditor
description: 'Code quality gatekeeper and auditor. Enforces strict quality gates, resolves the AI verification gap, and evaluates codebases across 12 critical dimensions with evidence-based scoring. Use when auditing code quality, reviewing AI-generated code, scoring codebases against industry standards, or enforcing pre-commit quality gates. Use for quality audit, code review, codebase evaluation, security assessment, technical debt analysis.'
license: MIT
metadata:
  author: oakoss
  version: '1.1'
---

# Quality Auditor

## Overview

Evaluates tools, frameworks, systems, and codebases against the highest industry standards across 12 weighted dimensions. Produces evidence-based scores, identifies anti-patterns, and generates prioritized improvement roadmaps. Applies extra scrutiny to AI-generated code through the verification gap protocol, ensuring velocity does not compromise integrity.

**When to use:** Auditing code quality, reviewing AI-generated code, scoring codebases against industry benchmarks, enforcing pre-commit quality gates, comparing tools or frameworks, assessing technical debt.

**When NOT to use:** Quick code reviews without scoring, style-only linting (use a linter), feature implementation, routine PR reviews that do not require a full audit.

## Quick Reference

| Dimension            | Weight | What to Evaluate                                                    |
| -------------------- | ------ | ------------------------------------------------------------------- |
| Code Quality         | 10%    | Structure, patterns, SOLID, duplication, complexity, error handling |
| Architecture         | 10%    | Design, modularity, scalability, coupling/cohesion, API design      |
| Documentation        | 10%    | Completeness, clarity, accuracy, examples, troubleshooting          |
| Usability            | 10%    | Learning curve, installation ease, error messages, ergonomics       |
| Performance          | 8%     | Speed, resource usage, caching, bundle size, Core Web Vitals        |
| Security             | 10%    | OWASP Top 10, input validation, auth, secrets, dependencies         |
| Testing              | 8%     | Coverage (unit/integration/e2e), quality, automation, organization  |
| Maintainability      | 8%     | Technical debt, readability, refactorability, versioning            |
| Developer Experience | 10%    | Setup ease, debugging, tooling, hot reload, IDE integration         |
| Accessibility        | 8%     | WCAG compliance, keyboard nav, screen readers, cognitive load       |
| CI/CD                | 5%     | Automation, pipelines, deployment, rollback, monitoring             |
| Innovation           | 3%     | Novel approaches, forward-thinking design, unique value             |

## Audit Phases

| Phase | Name                  | Purpose                                                           |
| ----- | --------------------- | ----------------------------------------------------------------- |
| 0     | Resource Completeness | Verify registry/filesystem parity; audit fails if this fails      |
| 1     | Discovery             | Read docs, examine code, test system, review supporting materials |
| 2     | Evaluation            | Score each dimension with evidence, strengths, and weaknesses     |
| 3     | Synthesis             | Executive summary, detailed scores, recommendations, risk matrix  |

## Scoring Scale

| Score | Rating      | Meaning                                     |
| ----- | ----------- | ------------------------------------------- |
| 10    | Exceptional | Industry-leading, sets new standards        |
| 8-9   | Excellent   | Exceeds expectations significantly          |
| 6-7   | Good        | Meets expectations with improvements needed |
| 5     | Acceptable  | Below average, significant improvements     |
| 3-4   | Poor        | Major gaps and fundamental problems         |
| 1-2   | Critical    | Barely functional or non-functional         |

## Common Mistakes

| Mistake                                           | Correct Pattern                                                                                           |
| ------------------------------------------------- | --------------------------------------------------------------------------------------------------------- |
| Giving inflated scores without evidence           | Every score must cite specific files, metrics, or code examples as evidence                               |
| Skipping Phase 0 resource completeness check      | Always verify registry completeness first; missing resources cap the overall score at 6/10                |
| Evaluating only code quality, ignoring dimensions | Score all 12 dimensions with appropriate weights; architecture, security, and DX matter equally           |
| Accepting superficial "LGTM" reviews              | Perform deep semantic audits checking contract integrity, security sanitization, and performance hygiene  |
| Trusting AI-generated code without verification   | Apply the verification gap protocol: critic agents, verifiable goals, human oversight for critical paths  |
| Proceeding after audit failure without re-audit   | Stop, analyze the deviation, remediate, then restart the checklist from step 1                            |
| Using 10/10 scores without exceptional evidence   | Reserve 10/10 for truly industry-leading work; most quality tools score 6-7                               |
| Surface-level static analysis only                | Combine linting with architectural fit checks, risk-based PR categorization, and context-aware validation |

## Delegation

- **Discover codebase structure and gather audit evidence**: Use `Explore` agent to survey file organization, dependencies, test coverage, and documentation
- **Execute targeted quality checks across dimensions**: Use `Task` agent to run linters, security scanners, performance profilers, and accessibility audits
- **Design quality improvement roadmap**: Use `Plan` agent to prioritize quick wins, short-term, and long-term recommendations from audit findings

> For stylistic cleanup of AI-generated prose and code (emdash overuse, slop vocabulary, over-commenting, verbose naming), use the `de-slopify` skill.
>
> If the `usability-tester` skill is available, delegate usability dimension evaluation and user flow validation to it.
> Otherwise, recommend: `pnpm dlx skills add oakoss/agent-skills -s usability-tester -a claude-code -y`

## References

- [Audit Rubric](references/audit-rubric.md) -- pass/warn/fail thresholds, weighted scoring methodology, automated vs manual checklists, score caps, report format
- [Dimension Rubrics](references/dimension-rubrics.md) -- detailed scoring criteria, evidence requirements, and rubric tables for all 12 dimensions
- [Audit Report Template](references/audit-report-template.md) -- structured report format, executive summary, recommendations, risk assessment
- [Anti-Patterns Guide](references/anti-patterns-guide.md) -- code, architecture, security, testing, and process anti-patterns to identify during audits
- [Verification Gap Protocol](references/verification-gap-protocol.md) -- AI code verification methodology, critic agents, rejection protocol, risk-based review strategies

© oakoss · MIT · oakoss/agent-skills

Похожие скиллы

Все скиллы по теме «Код-ревью и рефакторинг» →

Сначала — quality-auditor от других авторов.

quality-auditor daffy0208 Скилл quality-auditor проводит аудит репозитория, кода и документации по 12 критериям с оценкой от 1 до 10. CX Codex +1 201установок quality-gates OrchestKit Скилл quality-gates оценивает сложность задач от 1 до 5 и останавливает агента при тупиках или оверинжиниринге. Включается перед запуском фич и после неудачных попыток решения. CX Codex +1 259установок social-quality-auditor aaron-he-zhu Скилл social-quality-auditor проверяет пакет публикаций перед выпуском или оценивает зрелость программы ведения каналов. Разделяет аудит отдельных материалов и аудит портфеля каналов. CX Codex +1 1 100установок audit-prep-assistant trailofbits Скилл audit-prep-assistant готовит репозиторий к внешнему аудиту безопасности по чеклисту Trail of Bits. Помогает сформулировать цели проверки, прогнать статический анализ и собрать документацию. CX Codex +1 6 300установок qe-quality-assessment proffesor-for-testing Скилл qe-quality-assessment для Claude Code оценивает качество кода по сложности, линту, запахам и здоровью тестов. Проверяет quality gates, формирует отчёты и оценивает готовность релиза. CX Codex +1 129установок dfyx-code-security-auditor reason-machines Скилл dfyx-code-security-auditor для Claude Code проверяет исходный код на уязвимости методом многоэтапного белого анализа. Проверяет проект перед релизом и оценивает OWASP-риски. CX Codex +1 338установок content-quality-auditor aaron-he-zhu Скилл content-quality-auditor проверяет качество контента, E-E-A-T и готовность к публикации по профилю CORE-EEAT. Для аудита URL или текста. CX Codex +1 1 700установок

Из того же набора106

Весь набор →
react-email Скилл react-email для Claude Code собирает адаптивные HTML-письма из React-компонентов и выводит их в HTML или обычный текст. Создаёт транзакционные письма и маркетинговые шаблоны. CX Codex +1 122установок rag-implementer Скилл rag-implementer ведёт агента по шагам RAG-пайплайна: от чанкинга и эмбеддингов до гибридного поиска и замеров качества. CX Codex +1 121установок service-worker Скилл service-worker для Claude Code собирает правила настройки сервис-воркеров, Workbox v7.4, офлайн-кеширования, фоновой синхронизации и push-уведомлений. CX Codex +1 121установок cli-power-tools Скилл cli-power-tools учит ИИ-агента современным утилитам на Rust и структурированным конвейерам вместо связок grep, sed и awk. CX Codex +1 121установок package-publishing Скилл package-publishing помогает настроить package.json, сборку ESM и CJS и публикацию TypeScript-библиотеки в npm. Пригодится при настройке точек входа и проверок перед релизом. CX Codex +1 119установок svelte Справочник по Svelte 5 и SvelteKit для ИИ-агента: руны, сниппеты, роутинг, form actions и таблица перевода кода с Svelte 4. CX Codex +1 117установок react-native Помогает проектировать мобильные приложения на React Native и Expo с файловой маршрутизацией, EAS Build и нативными API под iOS и Android. CX Codex +1 117установок tiptap Скилл помогает собирать React-редакторы на Tiptap: настраивать расширения, SSR, загрузку изображений и совместное редактирование. Пригодится при добавлении редактора в приложение. CX Codex +1 117установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой