SkillFoxx
Telegram

Hikkaku — скилл

Библиотека и скилл для проектов Scratch на TypeScript: агент пишет блоки кодом, а сборка выдает JSON для редактора Scratch

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

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

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

  • Скилл содержит инструкции и правила, а команды установки скачивают пакеты из npm
Все причины и проверки

pnsk-lab/hikkakuАвтор:pnsk-lab

Установка

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

npx skillfoxx add skills/hikkaku

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

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

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

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

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

  • Скилл содержит инструкции и правила, а команды установки скачивают пакеты из npm

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

Что делает

Hikkaku описывает проект Scratch на TypeScript. Спрайты, костюмы и блоки создаются вызовами `Project`, `createSprite`, `whenFlagClicked`, `gotoXY`, `forever`, а `project.toScratch()` отдает JSON, который открывается в редакторе Scratch. Плагин `hikkaku/vite` добавляет горячую перезагрузку: после `bun vite` проект виден на `localhost:5173`. Для агентов у проекта есть скилл в `packages/skill`, который ставится командой `npx skills add pnsk-lab/hikkaku/packages/skill` (есть варианты для Bun, Deno, pnpm и Yarn). Внутри папка `rules/` с правилами по категориям блоков: движение, внешность, звук, музыка, события, управление, датчики, операторы, переменные, процедуры и перо. Отдельные заметки посвящены клонам, физике, пользовательским блокам, расчетам и инициализации. Новый проект собирает `npx create-hikkaku@latest my-hikkaku-app`. Опции `--agents` и `--link-claude` добавляют `AGENTS.md` и ссылку `CLAUDE.md`, а `--skills` сразу ставит скилл. Так Codex, Claude Code или OpenCode получают проект с готовыми инструкциями.

Для кого. Разработчикам и преподавателям, которые делают проекты Scratch кодом и хотят поручать блоки ИИ-агенту.

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

  • Игра на Scratch собирается из десятков спрайтов, и ее удобнее вести в Git и редакторе кода
  • Агенту надо сгенерировать цепочки блоков для событий, циклов и процедур по описанию
  • Нужна горячая перезагрузка проекта Scratch через Vite
  • Новый проект стартует с `AGENTS.md`, ссылкой `CLAUDE.md` и установленным скиллом

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

  • Проект целиком рисуется мышью в редакторе Scratch и код не нужен
  • Нужны другие визуальные языки программирования: библиотека работает только со Scratch
  • В среде нет поддержки Node, Bun и Deno

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

Создай на Hikkaku спрайт-ловца, который следует за мышью по оси X, и собери проект командой `bun vite`

Ограничения

Результат работы библиотеки остается JSON-проектом Scratch, который открывают в редакторе вручную, а возможности ограничены набором блоков, описанным в правилах скилла. Горячая перезагрузка работает через Vite Environment API и требует настроенного `vite.config.ts` с плагином `hikkaku/vite`. Скилл лежит в подпапке монорепозитория `packages/skill`, поэтому при установке указывают полный путь. Документация и правила написаны на английском. `create-hikkaku` принимает менеджер пакетов (`bun`, `deno`, `npm`, `pnpm`, `yarn`) флагом `--pm` и берет шаблон по тегу Git.

Как отключить. Удалите папки `.agents/skills/hikkaku/` и `.agent/skills/hikkaku/` из проекта и пакет `hikkaku` из зависимостей.

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

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

Выполните `npx skills add pnsk-lab/hikkaku/packages/skill`. Для Bun, Deno, pnpm и Yarn в README есть свои варианты команды. Скилл подходит для Codex, Claude Code и OpenCode.

Как создать проект с нуля?

Выполните `npx create-hikkaku@latest my-hikkaku-app`, затем `bun install` и `bun dev`. Флаг `-y` пропускает вопросы, `--pm` задает менеджер пакетов.

Как открыть результат в Scratch?

Вызов `project.toScratch()` возвращает JSON проекта, который загружают в редакторе Scratch. С плагином Vite проект виден на `localhost:5173`.

Куда ставить события вроде whenFlagClicked?

События (шапки блоков) вызывают прямо внутри `sprite.run()`. Вложенные блоки управления вроде `forever` принимают другие блоки внутри своей функции.

Какие агенты работают с проектом?

Скилл рассчитан на Codex, Claude Code и OpenCode. Флаг `--link-claude` создает `CLAUDE.md`, ссылающийся на `AGENTS.md`, чтобы инструкции были общими.

Обсуждение

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

Скиллы

Набор скиллов из реальной работы: аудит цепочки поставок npm, сборка CLI, релиз плагина Obsidian и иерархия AGENTS.md

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

skill-kit собирает скиллы агентов как типизированные конечные автоматы на TypeScript с проверкой ответов схемами

CLIМинимальный доступ70

17 готовых скиллов для тестов, Git, README и многоагентной работы плюс ядро проверки выполнения скиллов в Claude Code и Codex.

СкиллШирокий доступ50

Набор из 116 скиллов, 44 агентов и хуков безопасности для Claude Code, Cursor, Codex, Gemini CLI и еще девяти редакторов

CLIШирокий доступ179

Личный набор автора: общие правила для агентов и десятки скиллов для GitHub, браузера, macOS, сообщений и релизов, плюс скрипт синхронизации

СкиллШирокий доступ7,5 тыс.

Четыре скилла ведут идею от набросков к одобренной спецификации и проверенному коду, а состояние хранится в папке .kiko проекта

ПлагинРасширенный доступ167

Коротко о README

README кратко подает Hikkaku как Scratch на TypeScript: установка пакета, шаблон `create-hikkaku`, базовый пример, плагин Vite, скилл для агентов и сборка проекта.

Бейдж для README

Исходный SKILL.md

---
name: hikkaku
description: Create Scratch project with TypeScript using Hikkaku; use when the user asks how to build or structure a Scratch project in this repo.
license: MIT
metadata:
  author: Shotaro Nakamura
---

# Hikkaku Best Practices

This document provides best practices for using Hikkaku to create Scratch projects with TypeScript. Follow these guidelines to ensure your projects are well-structured and maintainable.

## SKILL Structure

* `rules/`: Contains individual rules or guidelines for using Hikkaku effectively.
  * `initialization.md`: Guidelines for initializing Hikkaku projects.
  * `blocks/*.md`: Guidelines for using specific blocks in Hikkaku.
    * e.g., `control.md`, `data.md`, `motion.md`, etc.
  * `clone.md`: Guidelines for using clones in Hikkaku.
  * `custom-blocks.md`: Guidelines for creating and using custom blocks.
  * `pen-100.md`: Performance rules for 100% pen-rendered projects.
  * `physics.md`: Guidelines for implementing 2d physics in Scratch projects.
  * `positioning.md`: Rules for positioning systems in Scratch projects.
  * `usage.md`: General usage guidelines for Hikkaku.
  * `variable.md`: Rules for using variables and lists in Hikkaku.

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