vBook Extensions — скилл
Скилл создает, чинит, тестирует и собирает расширения для читалки vBook через CLI и сервер разработчика на телефоне.
- 113 ★ репозитория
- Последний коммит
Расширенный доступ
Почему такой уровень
- Скилл запускает Node-скрипты, которые тестируют, собирают и ставят расширения на телефон по локальной сети.
- Расширения обращаются к сторонним сайтам.
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add skills/vbook-extensionsОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Скилл запускает Node-скрипты, которые тестируют, собирают и ставят расширения на телефон по локальной сети.
- Расширения обращаются к сторонним сайтам.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
vBook Extensions — скилл в формате Agent Skills для разработки расширений читалки vBook. Он закрывает создание нового расширения, починку, тест, аудит, рефакторинг, сборку и установку по актуальному API движка и среде ScriptExecutor. Работа идет по режимам: `create` для нового расширения или исходного адреса, `fix` для смены домена, селекторов или версии API, `test` для проверки одного скрипта, `audit` для проверки всего репозитория или выбранных расширений и `refactor` для выравнивания по шаблону без смены поведения. Для сборки и установки без режима хватает справочника по CLI. Тестирование, сборка и установка идут только через `scripts/vbook.js`: команды `connect`, `test`, `testall`, `build` и `install` связываются с сервером разработчика в приложении vBook на телефоне по локальной сети. Codex, Gemini CLI, Cursor и GitHub Copilot подхватывают скилл сами, а Claude Code использует совместимый вход.
Для кого. Разработчикам расширений для vBook, которые хотят делегировать агенту создание парсеров сайтов и их проверку на телефоне.
Подходит, если
- Нужно написать расширение для нового сайта с книгами по его адресу.
- Сайт сменил домен или верстку, и скрипт перестал отдавать главы.
- Требуется быстро прогнать все расширения репозитория и найти поломки.
- Готовое расширение надо собрать в `plugin.zip` и установить на телефон.
Не подходит, если
- Нужно разрабатывать плагины не для vBook.
- Телефон и компьютер в разных сетях, и сервер разработчика недоступен.
- Цель — обход платного доступа или защиты чужого сайта.
Пример запроса к агенту
Используй скилл vbook-extensions, чтобы починить расширение mangadex: прогони тесты на телефоне и поправь селекторы.Ограничения
Для тестов нужны телефон с приложением vBook в режиме разработчика и компьютер в той же локальной сети, а также Node.js для `scripts/vbook.js`. Режим включается семью нажатиями на номер версии в приложении. Скилл ничего не собирает, не ставит и не публикует без явного разрешения. Расширения парсят чужие сайты, поэтому условия этих сайтов и авторские права остаются на пользователе. Лицензия репозитория не указана, документация расширений написана по-вьетнамски.
Как отключить. Удалите папку `.agents/skills/vbook-extensions` и совместимый вход `.claude/skills/vbook-extensions` из репозитория. Установленные на телефон расширения удаляются в самом vBook.
Частые вопросы
Как включить сервер разработчика?
В приложении vBook нажмите семь раз на название версии, включите режим разработчика и запишите показанные адрес и порт, например http://192.168.1.10:8080.
Какие команды есть у CLI?
`connect`, `test <расширение> <скрипт> [аргументы]`, `testall [расширения]`, `build <расширение> [файл.zip]` и `install <расширение>`; запуск через `node .agents/skills/vbook-extensions/scripts/vbook.js`.
Можно ли отлаживать скрипты без агента?
Да, в репозитории лежит расширение VS Code vBook Tester (`vbook-vscode-tester-0.0.5.vsix`): оно запускает скрипт на телефоне и показывает ответ и журнал.
Как вызвать скилл по имени?
Назовите его в запросе, например «Используй скилл vbook-extensions для расширения mangadex». Codex, Gemini CLI, Cursor и Copilot находят его в `.agents/skills`.
Где описан контракт API расширений?
В файле `extension-api.md` в корне репозитория и в его копии в `reference` скилла; обе версии должны совпадать.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
СкиллыСкилл со скриптами для сборки iOS-приложений и управления симулятором через дерево доступности, с экономным выводом для агента
mobilecli управляет iOS- и Android-устройствами, эмуляторами и приложениями из терминала, а скилл учит этому Claude Code
21 скилл для Android и KMP в Claude Code, Codex и Copilot CLI: Compose, корутины, Flow, сеть, хранение, тесты и Gradle
Скилл учит агента управлять iOS-симуляторами, Android-эмуляторами и телефонами по USB через консольную утилиту simvyn
Скиллы и CLI, чтобы Claude Code, Codex и OpenCode управляли Android-телефоном: открывали приложения, нажимали, вводили текст и тестировали сценарии
Скилл для Claude Code создает мобильные приложения на Expo: онбординг, платная подписка, реклама AdMob, аналитика и локализация.
Коротко о README
Репозиторий содержит сами расширения в `src`, скилл в `.agents/skills`, документацию сервера разработчика и руководство по отладке в VS Code. Скилл считается основным источником указаний для работы с расширениями.
Бейдж для README
Исходный SKILL.md
--- name: vbook-extensions description: Create, fix, test, audit, refactor, build, or install vBook extensions against the current engine API and ScriptExecutor runtime. Use for extension source, plugin.json, vBook REST testing, packaging, or installation. --- # vBook extensions Canonical, vendor-neutral skill for this repository. Resolve every linked path relative to this file. `.claude/skills/vbook-extensions/SKILL.md` is only a compatibility pointer; never duplicate this skill there. ## Route the task Read exactly one matching mode when source work or testing is requested: - New extension or bare source URL → [CREATE](modes/create.md). - Repair, domain/selector change, API migration, or feature change → [FIX](modes/fix.md). - Read-only test of one extension/script → [TEST](modes/test.md). - Repo-wide or named-subset health scan → [AUDIT](modes/audit.md). - Behavior-preserving template alignment → [REFACTOR](modes/refactor.md). Build/install-only requests need no mode: read [CLI](reference/cli.md), inspect the target manifest, then perform only the requested operation. If the request is ambiguous and the choice would change behavior, ask. ## Load only what the task needs - Before creating or editing JavaScript/`plugin.json`, read [Runtime rules](reference/runtime.md) and the relevant portions of [extension-api.md](reference/extension-api.md). - For type-specific fields/chains, read [Type contracts](reference/type-contracts.md). - Before any test/build/install, read [CLI](reference/cli.md). - When judging script output, use [Verify checklist](reference/verify-checklist.md). - Templates live under `templates/<type>/`; use only the selected type. Replace all placeholders and remove teaching comments before shipping. The repo-root `extension-api.md` and `reference/extension-api.md` are the same current contract. Keep them identical; when the contract changes, update both, then the affected guidance and templates. ## Non-negotiable invariants - Test, build, and install only through `scripts/vbook.js`; do not use MCP endpoints or hand-built REST payloads. - Never infer permission to build, install, commit, push, delete, or publish from a