TypeScript Style Guide
Скилл для агентов с конвенциями TypeScript: типы, дискриминированные объединения, функции, именование, структура, React и тесты, подгружается по темам
Низкий риск
Низкий уровень ставим, когда запись в основном дает агенту инструкции и справочные материалы.
Почему такой уровень
- Скилл состоит только из конвенций и справочного текста, код не запускает
Установка
В терминале, через SkillFoxx CLI
npx skillfoxx add skills/typescript-style-guideОпределит агенты на машине, проверит риск и зафиксирует версию.
Другие способы установки
Выполните в терминале в папке проекта
npx skills add mkosir/typescript-style-guide --skill typescript-style-guide -a claude-code -yУтилита skills ставит текущую версию из репозитория. Чтобы скилл работал во всех проектах, добавьте флаг -g.
Без сторонних утилит, из коммита 170074a
tmp=$(mktemp -d)
git clone --filter=blob:none --no-checkout https://github.com/mkosir/typescript-style-guide.git "$tmp"
git -C "$tmp" sparse-checkout set --no-cone /skills/typescript-style-guide/
git -C "$tmp" checkout 170074a0df9b07f4a4a78e3596ec1edf06a14da7
mkdir -p .claude/skills
cp -R "$tmp/skills/typescript-style-guide" .claude/skills/typescript-style-guideКоманды для macOS и Linux, на Windows выполните их в Git Bash.
Выполните в терминале в папке проекта
npx skills add mkosir/typescript-style-guide --skill typescript-style-guide -a cursor -yУтилита skills ставит текущую версию из репозитория. Чтобы скилл работал во всех проектах, добавьте флаг -g.
Без сторонних утилит, из коммита 170074a
tmp=$(mktemp -d)
git clone --filter=blob:none --no-checkout https://github.com/mkosir/typescript-style-guide.git "$tmp"
git -C "$tmp" sparse-checkout set --no-cone /skills/typescript-style-guide/
git -C "$tmp" checkout 170074a0df9b07f4a4a78e3596ec1edf06a14da7
mkdir -p .agents/skills
cp -R "$tmp/skills/typescript-style-guide" .agents/skills/typescript-style-guideКоманды для macOS и Linux, на Windows выполните их в Git Bash.
Выполните в терминале в папке проекта
npx skills add mkosir/typescript-style-guide --skill typescript-style-guide -a github-copilot -yУтилита skills ставит текущую версию из репозитория. Чтобы скилл работал во всех проектах, добавьте флаг -g.
Без сторонних утилит, из коммита 170074a
tmp=$(mktemp -d)
git clone --filter=blob:none --no-checkout https://github.com/mkosir/typescript-style-guide.git "$tmp"
git -C "$tmp" sparse-checkout set --no-cone /skills/typescript-style-guide/
git -C "$tmp" checkout 170074a0df9b07f4a4a78e3596ec1edf06a14da7
mkdir -p .github/skills
cp -R "$tmp/skills/typescript-style-guide" .github/skills/typescript-style-guideКоманды для macOS и Linux, на Windows выполните их в Git Bash.
Выполните в терминале в папке проекта
npx skills add mkosir/typescript-style-guide --skill typescript-style-guide -a codex -yУтилита skills ставит текущую версию из репозитория. Чтобы скилл работал во всех проектах, добавьте флаг -g.
Без сторонних утилит, из коммита 170074a
tmp=$(mktemp -d)
git clone --filter=blob:none --no-checkout https://github.com/mkosir/typescript-style-guide.git "$tmp"
git -C "$tmp" sparse-checkout set --no-cone /skills/typescript-style-guide/
git -C "$tmp" checkout 170074a0df9b07f4a4a78e3596ec1edf06a14da7
mkdir -p .agents/skills
cp -R "$tmp/skills/typescript-style-guide" .agents/skills/typescript-style-guideКоманды для macOS и Linux, на Windows выполните их в Git Bash.
Выполните в терминале в папке проекта
npx skills add mkosir/typescript-style-guide --skill typescript-style-guide -a gemini-cli -yУтилита skills ставит текущую версию из репозитория. Чтобы скилл работал во всех проектах, добавьте флаг -g.
Без сторонних утилит, из коммита 170074a
tmp=$(mktemp -d)
git clone --filter=blob:none --no-checkout https://github.com/mkosir/typescript-style-guide.git "$tmp"
git -C "$tmp" sparse-checkout set --no-cone /skills/typescript-style-guide/
git -C "$tmp" checkout 170074a0df9b07f4a4a78e3596ec1edf06a14da7
mkdir -p .agents/skills
cp -R "$tmp/skills/typescript-style-guide" .agents/skills/typescript-style-guideКоманды для macOS и Linux, на Windows выполните их в Git Bash.
Выполните в терминале в папке проекта
tmp=$(mktemp -d)
git clone --filter=blob:none --no-checkout https://github.com/mkosir/typescript-style-guide.git "$tmp"
git -C "$tmp" sparse-checkout set --no-cone /skills/typescript-style-guide/
git -C "$tmp" checkout 170074a0df9b07f4a4a78e3596ec1edf06a14da7
mkdir -p .devin/skills
cp -R "$tmp/skills/typescript-style-guide" .devin/skills/typescript-style-guideКоманды для macOS и Linux, на Windows выполните их в Git Bash.
Бывший Windsurf.
Выполните в терминале в папке проекта
npx skills add mkosir/typescript-style-guide --skill typescript-style-guide -a cline -yУтилита skills ставит текущую версию из репозитория. Чтобы скилл работал во всех проектах, добавьте флаг -g.
Без сторонних утилит, из коммита 170074a
tmp=$(mktemp -d)
git clone --filter=blob:none --no-checkout https://github.com/mkosir/typescript-style-guide.git "$tmp"
git -C "$tmp" sparse-checkout set --no-cone /skills/typescript-style-guide/
git -C "$tmp" checkout 170074a0df9b07f4a4a78e3596ec1edf06a14da7
mkdir -p .cline/skills
cp -R "$tmp/skills/typescript-style-guide" .cline/skills/typescript-style-guideКоманды для macOS и Linux, на Windows выполните их в Git Bash.
Выполните в терминале в папке проекта
npx skills add mkosir/typescript-style-guide --skill typescript-style-guide -a roo -yУтилита skills ставит текущую версию из репозитория. Чтобы скилл работал во всех проектах, добавьте флаг -g.
Без сторонних утилит, из коммита 170074a
tmp=$(mktemp -d)
git clone --filter=blob:none --no-checkout https://github.com/mkosir/typescript-style-guide.git "$tmp"
git -C "$tmp" sparse-checkout set --no-cone /skills/typescript-style-guide/
git -C "$tmp" checkout 170074a0df9b07f4a4a78e3596ec1edf06a14da7
mkdir -p .roo/skills
cp -R "$tmp/skills/typescript-style-guide" .roo/skills/typescript-style-guideКоманды для macOS и Linux, на Windows выполните их в Git Bash.
Форк Roo Code, папки .roo те же.
Выполните в терминале в папке проекта
npx skills add mkosir/typescript-style-guide --skill typescript-style-guide -a opencode -yУтилита skills ставит текущую версию из репозитория. Чтобы скилл работал во всех проектах, добавьте флаг -g.
Без сторонних утилит, из коммита 170074a
tmp=$(mktemp -d)
git clone --filter=blob:none --no-checkout https://github.com/mkosir/typescript-style-guide.git "$tmp"
git -C "$tmp" sparse-checkout set --no-cone /skills/typescript-style-guide/
git -C "$tmp" checkout 170074a0df9b07f4a4a78e3596ec1edf06a14da7
mkdir -p .agents/skills
cp -R "$tmp/skills/typescript-style-guide" .agents/skills/typescript-style-guideКоманды для macOS и Linux, на Windows выполните их в Git Bash.
Выполните в терминале в папке проекта
tmp=$(mktemp -d)
git clone --filter=blob:none --no-checkout https://github.com/mkosir/typescript-style-guide.git "$tmp"
git -C "$tmp" sparse-checkout set --no-cone /skills/typescript-style-guide/
git -C "$tmp" checkout 170074a0df9b07f4a4a78e3596ec1edf06a14da7
mkdir -p .agents/skills
cp -R "$tmp/skills/typescript-style-guide" .agents/skills/typescript-style-guideКоманды для macOS и Linux, на Windows выполните их в Git Bash.
Выполните в терминале в папке проекта
tmp=$(mktemp -d)
git clone --filter=blob:none --no-checkout https://github.com/mkosir/typescript-style-guide.git "$tmp"
git -C "$tmp" sparse-checkout set --no-cone /skills/typescript-style-guide/
git -C "$tmp" checkout 170074a0df9b07f4a4a78e3596ec1edf06a14da7
mkdir -p .agents/skills
cp -R "$tmp/skills/typescript-style-guide" .agents/skills/typescript-style-guideКоманды для macOS и Linux, на Windows выполните их в Git Bash.
Установи скилл: npx skills add mkosir/typescript-style-guide и выбери нужный из списка. Для конкретной темы добавь флаг, например npx skills add mkosir/typescript-style-guide --skill typescript-types.
Другие способы из описания автора
npx skills add mkosir/typescript-style-guideВыбор скилла интерактивный. Для конкретной темы добавьте флаг, например --skill typescript-types или --skill typescript-react.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Скилл переносит опинионированный гайд по TypeScript в формат для кодового агента, чтобы тот применял единый стиль при написании и ревью кода. Полный скилл маршрутизирует по темам и читает только тот справочник, который нужен под задачу, чтобы не занимать лишний контекст. Отдельно доступны узкие скиллы по одной теме: типы, дискриминированные объединения, функции, переменные, именование, организация исходников, React и тесты. Скилл не дублирует правила, которые уже проверяют TypeScript, линтеры и форматтеры, а конвенции репозитория ставит выше собственных рекомендаций. Ставится через npx skills add с выбором нужного скилла.
Для кого. Для разработчиков на TypeScript и React, которым нужен единый стиль кода без споров на ревью.
Подходит, если
- Нужно, чтобы агент применял единый стиль TypeScript при написании и ревью кода
- Нужны рекомендации по одной теме: типы, функции, именование, React или тесты
- Хочется убрать споры о стиле кода на ревью
Не подходит, если
- Нужен только линтер или форматтер, их правила скилл сознательно не дублирует
- Проект не на TypeScript
Пример запроса к агенту
Проверь этот модуль на соответствие нашему гайду по TypeScriptОграничения
Гайд опинионированный, собственные конвенции репозитория имеют приоритет. Скилл применяется только к задачам по TypeScript, а не к верстке и стилям. Установка идет через npx, поэтому нужен Node.
Как отключить. Удалите установленную папку скилла из каталога скиллов вашего агента.
Проверка безопасности
- Скилл состоит только из конвенций и справочного текста, код не запускает
Коротко о README
README представляет проект как гайд по стилю TypeScript и одновременно набор скиллов для кодового агента. Скиллы ставятся командой npx skills add с интерактивным выбором или флагом под конкретную тему. Полный скилл подгружает только те разделы, которые относятся к задаче, а узкие скиллы дают отдельные темы независимо. В разделе с обоснованием сказано, что единый подход к коду ускоряет разработку и снимает споры о стиле на ревью. Полный текст гайда доступен на сайте проекта, лицензия MIT.
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.
Частые вопросы
Заменяет ли скилл ESLint и Prettier?
Нет. Скилл сознательно не дублирует то, что проверяют линтер и форматтер, и отвечает за конвенции, которые нельзя выразить правилом инструмента.
Можно поставить только одну тему?
Да, у каждой темы есть отдельный скилл, он ставится флагом --skill, например typescript-react или typescript-tests.
Похожие
Набор скиллов, который задает агенту процесс разработки: уточнение задачи, план, TDD, субагенты и ревью кода
Скиллы Мэтта Покока для инженеров
Skills For Real Engineers
Небольшие компонуемые скиллы для инженерной работы с агентом: интервью по плану, TDD, диагностика багов, ревью и архитектура
Набор GitHub для разработки от спецификации: CLI specify ставит в проект команды и скиллы для агента, от принципов до реализации
Референсные MCP-серверы
Model Context Protocol servers
Официальные референсные MCP-серверы: Filesystem, Fetch, Git, Memory, Sequential Thinking, Time и Everything