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

best-practices · fradser — скилл для Claude Code: что делает и как установить

Скилл best-practices задаёт правила качества кода и шаблоны под TypeScript, Python, Go, Swift и React.

MIT 115 установок ★ 597 обновлён 2026-10-09

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

Что делает best-practices

Скилл подключает набор правил по расширениям файлов. Для .ts и .js подтягивается references/typescript.md, для .py — база по Python, а для .go и .swift — собственные руководства. Универсальные нормы вынесены в references/universal.md. Если в проекте обнаружен Next.js, агент подключает отдельный каталог с правилами оптимизации гидратации, бандла и сетевых водопадов.

Инструкции требуют удалять мёртвый код вместо комментирования и запрещают тип any. Комментарии разрешены только для сложной бизнес-логики. Рефакторинг обязан сохранять поведение и публичные интерфейсы.

Поскольку параметр user-invocable равен false, вызвать скилл напрямую как слэш-команду нельзя: агент подтягивает его сам в задачах рефакторинга и проверки кода.

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

  • настроить правила типизации без any для TypeScript
  • устранить каскадные сетевые запросы и проблемы гидратации в Next.js
  • очистить проект от неиспользуемых импортов и мёртвого кода
  • разделить перегруженные файлы по принципу единой ответственности

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

  • Проверь проект на соответствие стандартам качества кода
  • Сделай рефакторинг этого сервиса с сохранением публичных интерфейсов
  • Найди в коде неиспользуемые импорты и удали мёртвые функции

Как установить best-practices

1Через Skills CLI (Vercel)

npx skills add FradSer/dotclaude --skill best-practices -a claude-code

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

~/.claude/skills/best-practices/SKILL.md

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

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

Вопросы о best-practices

Как установить best-practices в Claude Code?

Выполните команду npx skills add FradSer/dotclaude --skill best-practices -a claude-code. Файл разместится в ~/.claude/skills/best-practices/SKILL.md.

Что делает скилл best-practices?

Он направляет модель при рефакторинге и анализе кода, проверяя стандарты чистоты, типизацию и шаблоны для TypeScript, Python, Go, Swift и Next.js.

Можно ли запустить best-practices вручную?

Нет, у скилла выставлен флаг user-invocable: false. Ассистент активирует эти инструкции самостоятельно, когда вы просите отрефакторить или проверить код.

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

SKILL.md · MIT
---
name: best-practices
description: Language-specific best practices, code quality standards, and framework detection rules. Use when executing refactoring workflows, applying code quality rules, detecting frameworks, or checking language-specific patterns for TypeScript, Python, Go, Swift, or React.
user-invocable: false
version: 1.3.0
---

# Best Practices

## Language References

Each file extension maps to a specific reference:

- `.ts`, `.js` — `references/typescript.md`
- `.tsx`, `.jsx` — `references/typescript.md` + `references/react/react.md`
- `.py` — `references/python.md` + `references/python/INDEX.md`
- `.go` — `references/go.md`
- `.swift` — `references/swift.md`

Universal principles are in `references/universal.md`.

## Next.js/React References

For Next.js projects, the `references/react/` directory provides:

1. `references/react/rules/INDEX.md` — pattern index by impact level
2. `references/react/rules/_sections.md` — priorities and categories
3. Specific rule files matching observed patterns

## Rule Application

- Framework-specific rules (e.g., Next.js) apply only when that framework is detected
- **CRITICAL** rules have highest priority: waterfalls, bundle size, hydration
- All refactoring MUST preserve behavior and public interfaces

## Code Quality Standards

- **Comments**: Only for complex business logic; code-restating comments are unnecessary
- **Error Handling**: Try-catch only where recoverable; no defensive checks in trusted paths
- **Type Safety**: No `any`; proper types or `unknown` with guards are required
- **Style**: Existing code style and CLAUDE.md conventions take precedence
- **Cleanup**: Unused imports, variables, functions, and types are removed
- **No compat hacks**: Unused `_vars` and re-exports of deleted code are deleted
- **Renaming**: Descriptive names are preferred over marking as unused
- **Dead code**: Dead code is deleted, never commented out
- **File Organization**: Single Responsibility applies at file level; files with multiple concerns are candidates for splitting (see `references/universal.md`)

© FradSer · MIT · FradSer/dotclaude

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

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

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

best-practices MoizIbnYousaf Скилл best-practices для Claude Code превращает сырые запросы к кодинг-агенту в структурированные промпты. Добавляет критерии проверки, ограничения и пути к файлам. CX Codex +1 533установок best-practices mobbin Скилл best-practices для Claude Code объясняет возможности и ограничения Mobbin и связь его скиллов. Читай его первым перед скиллами Mobbin, спрашивая о возможностях или начиная дизайн-задачу. CX Codex +1 1 800установок best-practices alexander-cedergren Скилл best-practices по Oracle Cloud: подсказывает, какой CIDR брать для VCN, почему субнеты должны быть региональными и где Cloud Guard ломает прод. CX Codex +1 121установок best-practices web-quality-skills Скилл best-practices для Claude Code проверяет веб-код на проблемы безопасности, совместимости с браузерами и качества. Запускается по запросу на аудит или модернизацию кода. CX Codex +1 ★ 7 191звёзд репо voltagent-lang VoltAgent Community Плагин voltagent-lang для Claude Code с набором субагентов по языкам и фреймворкам: Python, TypeScript, Go, Rust, Java и другим. Каждый субагент специализирован на своей экосистеме и даёт советы по идиомам языка и разбору фреймворков. ★ 26 718звёзд репо dodo-best-practices dodopayments Скилл dodo-best-practices помогает подключить Dodo Payments: настроить SDK для Node.js, Python, Go или Java, переключить тестовый контур и подготовить вебхуки. CX Codex +1 1 000установок error-handling affaan-m Скилл error-handling задаёт единые правила обработки ошибок в TypeScript, Python и Go: типизированные исключения, ретраи, circuit breaker, тексты для пользователя. CX Codex +1 6 600установок code-craft jssblck Скилл code-craft для Claude Code задаёт правила работы с типами, состоянием, эффектами и ошибками. Помогает проектировать изменения в Rust, TypeScript, Go и Python. CX Codex +1 1 700установок rewriting-code-strictly b-mendoza Скилл rewriting-code-strictly для Claude Code переписывает Python, TypeScript/JavaScript или Go с более строгой типизацией и проверкой данных на границах. Запускается по просьбе укрепить код или согласовать его с проверяющими инструментами. CX Codex +1 122установок rust-anything Erkam Yaman Скилл rust-anything для Claude Code переносит код с TypeScript, Python, C, Go, Ruby или Java на Rust. Подключается при запросах на миграцию проектов или ускорение медленных функций. CX Codex +1 ★ 7 482звёзд репо

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

Весь набор →
plugin-best-practices Скилл plugin-best-practices для проверки структуры, манифестов и архитектуры Claude Code плагинов по стандартам фреймворка. Помогает убедиться, что плагин соответствует требованиям до отправки в маркетплейс. CX Codex +1 121установок commit Скилл commit для Claude Code создаёт атомарные conventional-коммиты через git-agent. Оформляет изменения по краткому намерению. CX Codex +1 121установок optimize-plugin Скилл optimize-plugin проверяет структуру плагинов Claude, запускает Python-валидатор и исправляет найденные ошибки через агента. Пригодится при подготовке и рефакторинге расширений. CX Codex +1 117установок create-prd Скилл create-prd помогает собрать идею продукта в PRD: задаёт вопросы, выбирает формат и сохраняет готовый документ в Markdown или Feishu. CX Codex +1 117установок create-issues Скилл create-issues автоматизирует создание GitHub issues с соблюдением принципов TDD, правильной разметкой и auto-closing ключевыми словами. Помогает документировать баги, требования и PR-scoped задачи по единым стандартам. CX Codex +1 116установок refactor Скилл refactor запускает автоматический рефакторинг выбранных файлов, папок или недавних правок через агента упрощения кода. CX Codex +1 113установок resolve-issues Скилл resolve-issues для Claude Code решает GitHub issues через изолированный worktree и TDD. Затем передаёт создание PR в workflow проверки и ревью. CX Codex +1 112установок create-pr Скилл create-pr создаёт GitHub pull request после проверок качества и безопасности, а затем передаёт его на мониторинг CI и разбор комментариев. CX Codex +1 109установок

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

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