SkillFoxx
Telegram

Makisuo Skills

Пять скиллов для TypeScript: ревью кода на Effect 3 и 4, правила сервисов и слоев, чистка техдолга и цикл от плана до слияния PR

  • 79 ★ репозитория
  • Последний коммит
Скилл

Расширенный доступ

Почему такой уровень

  • Скилл `david-workflow` открывает PR, ждет CI и проверяет деплой, то есть работает с вашим репозиторием и сервисами через `gh`
  • Скрипты `effect-review-v4` читают проект и запускают проверки примеров
Все причины и проверки

makisuo/skillsАвтор:Makisuo

Установка

Работает в

В терминале, через SkillFoxx CLI

npx skillfoxx add skills/makisuo-skills

Определит агенты на машине, покажет уровень доступа и зафиксирует версию.

Другие способы установки

Доступ и проверки

Как мы проверяем

Расширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.

  • Скилл `david-workflow` открывает PR, ждет CI и проверяет деплой, то есть работает с вашим репозиторием и сервисами через `gh`
  • Скрипты `effect-review-v4` читают проект и запускают проверки примеров

Это чужой код. Посмотрите файлы в репозитории перед установкой.

Что делает

Makisuo Skills — репозиторий из пяти скиллов. Первые три касаются Effect-TS: `effect-best-practices` задает правила для сервисов, ошибок, слоев и атомов, `effect-review` ведет многоагентный разбор изменений в ветке по этим правилам, а `effect-review-v4` проверяет код на Effect 4 на распространение ошибок, владение ресурсами, отмену, конкурентность, схемы и тесты и принимает файлы, рабочие изменения, дифф ветки или весь репозиторий. `zero-tech-debt` переписывает изменение так, будто нужный дизайн был с первого дня, и удаляет вспомогательные режимы без вызовов. `david-workflow` ведет работу сквозным циклом: план с проверкой, реализация, ревью субагентами, PR с доказательствами, зеленый CI, проверка на превью и подтверждение после слияния.

Для кого. Разработчикам на TypeScript с Effect-TS и командам, которые хотят вести фичу от плана до слияния по одному регламенту.

Подходит, если

  • Вы пишете сервис на Effect и просите агента следить за слоями, тегированными ошибками и атомами
  • Перед слиянием нужен разбор ветки по лучшим практикам Effect с несколькими проверяющими
  • Проект перешел на Effect 4, и надо проверить отмену, ресурсы и конкурентность
  • Патч оброс режимами совместимости, и его хочется переписать под итоговый дизайн
  • Большая фича режется на фазы с проверкой и стопкой PR через `gh stack`

Не подходит, если

  • Проект не на Effect-TS: три скилла из пяти привязаны к его соглашениям
  • У вас Effect 3: для него предназначен `effect-review`, а `effect-review-v4` берет только четвертую версию
  • Вы не пользуетесь `gh` и Maple: сквозной цикл `david-workflow` опирается на эти инструменты
  • Нужен готовый линтер вместо правил для агента: скиллы только направляют ревью

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

Сделай effect review v4 по моим изменениям в ветке: ошибки, ресурсы, отмена, конкурентность и тесты

Ограничения

В репозитории нет README, поэтому описание строится по файлам SKILL.md. Скилл `effect-best-practices` считает обязательным Effect Language Server и просит поставить `@effect/language-service` и добавить его в `tsconfig.json`. Для `effect-review-v4` примеры проверены на `effect` и `@effect/vitest` 4.0.0-rc.111, API сверяют с установленной версией. `david-workflow` предполагает `gh` и стопку PR через `gh stack`, превью-деплой и просмотр трассировок в Maple, без этих инструментов часть этапов пропускается. Версия `effect-review` ориентирована на ветку `main`.

Как отключить. Удалите нужные папки скиллов из каталога скиллов агента, например `~/.claude/skills/effect-review-v4`. Других следов скиллы не оставляют.

Частые вопросы

Как поставить скиллы Makisuo?

У репозитория нет README с командой установки. Скопируйте нужные папки, например `effect-review-v4`, в каталог скиллов агента, скажем `~/.claude/skills/`, и перезапустите клиента.

Чем `effect-review` отличается от `effect-review-v4`?

`effect-review` предназначен для Effect 3 и ведет многоагентный разбор ветки. `effect-review-v4` для Effect 4 по умолчанию работает одним агентом, а делегирование ограничено общим пределом.

Что проверяет `effect-review-v4`?

Распространение ошибок, владение ресурсами, отмену, конкурентность, выбор примитивов, сервисы и слои, схемы, атомы, наблюдаемость и тесты. Принимает файлы, рабочие изменения, дифф ветки или аудит репозитория.

Что делает `zero-tech-debt`?

Переписывает изменение от нужного итогового состояния, ищет реальных вызывающих и удаляет режимы, обертки и запасные пути без вызовов, а не сохраняет их ради совместимости.

Для чего `david-workflow`?

Для сквозной работы над фичей или правкой: план по фазам, реализация, ревью субагентами, PR с доказательствами, проверка CI и превью и подтверждение после слияния.

Обсуждение

Вопросов и отзывов пока нет.

Скиллы

Скилл по Effect v4 для TypeScript: схемы, сервисы и слои, конфигурация, повторы, кэши, потоки, HTTP-клиент и тесты с виртуальным временем

СкиллМинимальный доступ355
Официальный

Официальные скиллы Effect: подключают руководство из node_modules к агенту и ведут миграцию проекта с версии 3 на 4.

СкиллРасширенный доступ115

Личный набор скиллов Диллона Малроя: строгий TypeScript, архитектура для Cloudflare Workers, сервисы на Effect и технические спецификации

СкиллМинимальный доступ433

Двадцать скиллов для чтения чужого кода, ревью документов и коммитов, перевода Markdown и спецификаций на OpenSpec

СкиллРасширенный доступ92

Девять скиллов JS Mastery ведут изменение по фазам: от идеи и спецификации до проверки, тестов, текстов для релиза и сверки документов

СкиллРасширенный доступ1,6 тыс.

Больше 200 скиллов по стекам и практикам: React, Next.js, Rails, Rust, Python, отладка, TDD и ревью интерфейсов

СкиллМинимальный доступ225

Сравнение с похожими

Карточки с тем же главным запросом: чем они отличаются.

ИнструментОфициальныйЗвезды репозиторияГлавное отличие
Makisuo Skills (эта карточка)нет79
Effect-TS Skillsда115другой набор скиллов по Effect-TS; здесь отдельный разбор Effect 4 и сквозной цикл фичи david-workflow
Effect skillнет355один скилл по Effect; здесь пять скиллов с ревью двух поколений и чисткой техдолга

Коротко о README

README в репозитории нет. Структура показывает пять папок скиллов, у `effect-review-v4` есть примеры, скрипты `inspect-project.mjs` и `check-examples.mjs` и набор проверок. Описания взяты из frontmatter SKILL.md.

Бейдж для README

Исходный SKILL.md

---
name: effect-review-v4
description: >-
  Review Effect v4 code, including beta, RC, and release versions, for correct
  error propagation, resource ownership, cancellation, concurrency, primitive
  selection, services/layers, schemas, atoms, observability, and tests. Use for
  requests such as "effect v4 review", "review my Effect 4 changes", "check
  Effect patterns", or "audit the Effect codebase" when the project uses v4.
  Supports files, working changes, PR/branch diffs, and repository audits.
  Reviews with one agent by default; delegation has an explicit total limit.
  Verify APIs against the installed version. For Effect v3 use effect-review.
metadata:
  version: "4.0.1"
  examples-verified-with: "effect and @effect/vitest 4.0.0-rc.111"
---

# Effect v4 review

Review program behavior and the contracts it exposes. Prefer Effect primitives
when they remove custom cancellation, scheduling, resource, or coordination
logic. Explain the semantic benefit; counting Effect APIs is not a measure of
code quality.

Use this skill read-only unless the user also requests fixes. When asked to
review or improve this skill itself, inspect its instructions and examples;
do not launch a product-code audit.

Default to **one reviewer: the current agent, with zero subagents**, including
whole-repository audits. Follow the delegation and context limits in section 3.

## 1. Establish scope and ground truth

Read [version-grounding.md](references/version-grounding.md) and the applicable
repository instructions before making findings.

- Respect explicit files/directories, PRs, branches, and prior conversation.
  "My changes" normally means working changes when present; otherwise inspect
  the current branch's actual base. State inferred scope. Ask only if unresolved
  ambiguity would materially change the review.
- PR/branch: determine the actual base, inspect its merge-base diff and relevant
  callers. Working changes: include staged, unstaged, and relevant untracked
  files. An empty diff is not a command failure. Never silently review `HEAD~1`.
- Repo: discover first-party source, excluding generated/dependency/reference
  trees. `.context` is API evidence, not product code under review.
- Classify by contents and ownership, not extension alone. `index.ts`, config,

Сообщить о проблеме