best-practices · fradser — скилл для Claude Code: что делает и как установить
Скилл best-practices задаёт правила качества кода и шаблоны под TypeScript, Python, Go, Swift и React.
MIT 115 установок ★ 597 обновлён 2026-10-09
npx skills add FradSer/dotclaude --skill best-practices -a claude-codeЧто делает 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-code2Вручную: положить файлы
~/.claude/skills/best-practices/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/best-practices/
1Через Skills CLI (Vercel)
npx skills add FradSer/dotclaude --skill best-practices -a codex2Вручную: положить файлы
.agents/skills/best-practices/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add FradSer/dotclaude --skill best-practices -a cursor2Вручную: положить файлы
.cursor/skills/best-practices/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install FradSer/dotclaude refactor/skills/best-practices2Вручную: положить файлы
.github/skills/best-practices/SKILL.md1Через Skills CLI (Vercel)
npx skills add FradSer/dotclaude --skill best-practices -a gemini-cli2Командой платформы
gemini skills install https://github.com/FradSer/dotclaude --path refactor/skills/best-practicesВручную: положить файлы
.devin/skills/best-practices/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add FradSer/dotclaude --skill best-practices -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в 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 от других авторов.