TypeScript Style Guide — скилл
Скилл для агентов с конвенциями TypeScript: типы, дискриминированные объединения, функции, именование, структура, React и тесты, подгружается по темам
- 786 ★ репозитория
- Последний коммит
- MIT
Минимальный доступ
Почему такой уровень
- Скилл состоит только из конвенций и справочного текста, код не запускает
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add skills/typescript-style-guideОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемМинимальный доступИнструмент ничего не запускает и не ходит в сеть.
- Скилл состоит только из конвенций и справочного текста, код не запускает
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Скилл переносит опинионированный гайд по TypeScript в формат для кодового агента, чтобы тот применял единый стиль при написании и ревью кода. Полный скилл маршрутизирует по темам и читает только тот справочник, который нужен под задачу, чтобы не занимать лишний контекст. Отдельно доступны узкие скиллы по одной теме: типы, дискриминированные объединения, функции, переменные, именование, организация исходников, React и тесты. Скилл не дублирует правила, которые уже проверяют TypeScript, линтеры и форматтеры, а конвенции репозитория ставит выше собственных рекомендаций. Ставится через npx skills add с выбором нужного скилла.
Для кого. Для разработчиков на TypeScript и React, которым нужен единый стиль кода без споров на ревью.
Подходит, если
- Нужно, чтобы агент применял единый стиль TypeScript при написании и ревью кода
- Нужны рекомендации по одной теме: типы, функции, именование, React или тесты
- Хочется убрать споры о стиле кода на ревью
Не подходит, если
- Нужен только линтер или форматтер, их правила скилл сознательно не дублирует
- Проект не на TypeScript
Пример запроса к агенту
Проверь этот модуль на соответствие нашему гайду по TypeScriptОграничения
Гайд опинионированный, собственные конвенции репозитория имеют приоритет. Скилл применяется только к задачам по TypeScript, а не к верстке и стилям. Установка идет через npx, поэтому нужен Node.
Как отключить. Удалите установленную папку скилла из каталога скиллов вашего агента.
Частые вопросы
Заменяет ли скилл ESLint и Prettier?
Нет. Скилл сознательно не дублирует то, что проверяют линтер и форматтер, и отвечает за конвенции, которые нельзя выразить правилом инструмента.
Можно поставить только одну тему?
Да, у каждой темы есть отдельный скилл, он ставится флагом --skill, например typescript-react или typescript-tests.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
СкиллыСкилл для ревью кода по многим языкам и фреймворкам: архитектура, производительность, безопасность, антипаттерны и типичные ошибки
Скилл по Effect v4 для TypeScript: схемы, сервисы и слои, конфигурация, повторы, кэши, потоки, HTTP-клиент и тесты с виртуальным временем
Скилл ставит набор правил Oxlint, которые ловят низкокачественные шаблоны в TypeScript и JavaScript, часто оставляемые генерацией кода
Пять скиллов для TypeScript: ревью кода на Effect 3 и 4, правила сервисов и слоев, чистка техдолга и цикл от плана до слияния PR
Два скилла для сборщика tsdown: настройка сборки TypeScript-библиотек и перенос проекта с tsup
Agent Skills (AsyrafHussin)
Agent Skills
24 скилла для Laravel, PHP, React и TypeScript: правила кода, тесты, безопасность, технический долг и документация.
Из блога
Коротко о README
README представляет проект как гайд по стилю TypeScript и одновременно набор скиллов для кодового агента. Скиллы ставятся командой npx skills add с интерактивным выбором или флагом под конкретную тему. Полный скилл подгружает только те разделы, которые относятся к задаче, а узкие скиллы дают отдельные темы независимо. В разделе с обоснованием сказано, что единый подход к коду ускоряет разработку и снимает споры о стиле на ревью. Полный текст гайда доступен на сайте проекта, лицензия MIT.
Бейдж для README
Исходный SKILL.md
--- name: typescript-style-guide description: Apply, review, and explain the opinionated conventions in the TypeScript Style Guide. Use automatically only when TypeScript conventions are part of the requested task, including type modelling, discriminated unions, function APIs, variables and state, naming, source organization, React props, component APIs, state management, data flow, or tests. Do not use for styling or layout alone. --- # TypeScript Style Guide Apply only the conventions relevant to the current task. Keep TypeScript, linters, and formatters responsible for rules they can enforce automatically. ## Workflow 1. Inspect the consuming repository's conventions and configuration. 2. Let explicit repository conventions take precedence over this opinionated guide. 3. Identify which guide topic applies. 4. Read only the reference for the task's primary guide topic. Read multiple references only when the task substantively spans multiple topics. 5. Apply, review, or explain the conventions in the context of the current task. 6. State important tradeoffs when a convention depends on context or judgment.