vBook Extensions — скилл

Скилл создает, чинит, тестирует и собирает расширения для читалки vBook через CLI и сервер разработчика на телефоне.

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

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

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

  • Скилл запускает Node-скрипты, которые тестируют, собирают и ставят расширения на телефон по локальной сети.
  • Расширения обращаются к сторонним сайтам.
Все причины и проверки

darkrai9x/vbook-extensions

Установка

В терминале, через 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-приложений и управления симулятором через дерево доступности, с экономным выводом для агента

СкиллРасширенный доступ1,3 тыс.Звезды репозитория

mobilecli управляет iOS- и Android-устройствами, эмуляторами и приложениями из терминала, а скилл учит этому Claude Code

CLIШирокий доступ317Звезды репозитория

21 скилл для Android и KMP в Claude Code, Codex и Copilot CLI: Compose, корутины, Flow, сеть, хранение, тесты и Gradle

ПлагинМинимальный доступ173Звезды репозитория

Скиллы и CLI, чтобы Claude Code, Codex и OpenCode управляли Android-телефоном: открывали приложения, нажимали, вводили текст и тестировали сценарии

СкиллШирокий доступ1,8 тыс.Звезды репозитория

Скилл для Claude Code создает мобильные приложения на Expo: онбординг, платная подписка, реклама AdMob, аналитика и локализация.

СкиллРасширенный доступ114Звезды репозитория

Коротко о 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

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