InkOS — скилл

Система для книг и сценариев: CLI, Studio и скилл для агентов ведут роман по главам, пишут рассказы и сценарии, переводят длинные тексты

  • 10 468 ★ репозитория
  • Последний коммит
  • AGPL-3.0
Скилл

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

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

  • Ключи API провайдеров модели хранятся в `.inkos/secrets.json` и `~/.inkos/.env` на диске
  • Команда `inkos up` пишет главы по расписанию без участия человека и отправляет уведомления в Telegram, Feishu, WeCom и на webhook
  • Система пишет и переписывает файлы проекта, а текст рукописи уходит провайдеру модели по сети
Все причины и проверки

narcooo/inkos

Установка

Работает в

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

npx skillfoxx add skills/inkos

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

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

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

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

Широкий доступИнструмент может менять данные, выполнять команды или работать с секретами.

  • Ключи API провайдеров модели хранятся в `.inkos/secrets.json` и `~/.inkos/.env` на диске
  • Команда `inkos up` пишет главы по расписанию без участия человека и отправляет уведомления в Telegram, Feishu, WeCom и на webhook
  • Система пишет и переписывает файлы проекта, а текст рукописи уходит провайдеру модели по сети

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

Что делает

InkOS — система для работы с художественным текстом, которую ставят из npm командой `npm i -g @actalk/inkos`. Внутри лежат интерфейс Studio в браузере, терминальный `inkos tui`, команды CLI и скилл `skills/SKILL.md` для внешних агентов, таких как Claude Code и OpenClaw. Для OpenClaw скилл можно поставить командой `clawhub install inkos`. Все способы ведут к одному исполнителю. Он понимает просьбу, подбирает один из профилей работы и вызывает действия: создать книгу, спланировать и написать главы, проверить, исправить, собрать обложку, экспортировать. Профилей несколько: роман, короткая проза, сценарий, раскадровка, интерактивное кино, открытый мир, фанфик, продолжение, подражание стилю и перевод длинного документа. Внешнему агенту автор советует начинать с `inkos interact --json --message "..."`. Каждая работа хранится в файлах проекта: главы, замысел автора в `story/author_intent.md`, текущий фокус, снимки состояния и правила книги. Рецензия возвращает замечания с доказательствами и текст не оценивает и не переписывает, правка идет отдельным действием. Встроено 19 профессиональных скиллов, их можно переопределить своим `SKILL.md`.

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

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

  • Вы пишете роман главами и хотите, чтобы агент помнил канон, героев и открытые сюжетные линии
  • Нужен законченный рассказ с планом, рецензией, пакетом для продажи и обложкой одной командой `inkos short run`
  • Есть готовый текст романа, и его надо импортировать, чтобы продолжить с места обрыва
  • Надо написать фанфик по исходному тексту в одном из режимов: канон, альтернативная вселенная, другой характер или пара
  • Требуется перевести длинный документ с терминологией и возможностью возобновить прерванную работу

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

  • Нужна одна короткая правка стиля: для этого хватит обычного запроса агенту, а система создает целый проект с файлами состояния
  • У вас нет ни ключа API провайдера модели, ни локальной модели: без модели система не напишет ни слова
  • Вы хотите разместить проект в закрытом продукте: лицензия AGPL-3.0 требует открыть исходный код изменений при сетевом использовании
  • Нужны оценки прозы по баллам: рецензия возвращает только качественные замечания и никого не оценивает

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

Продолжи текущую книгу, но сделай темп плотнее, и покажи рецензию на восьмую главу

Ограничения

Нужен Node.js 22.16 и новее и ключ API какого-нибудь провайдера модели или адрес локальной модели. Ключ вводят в Studio, он сохраняется в `.inkos/secrets.json`, либо задают в `~/.inkos/.env`. Обложки требуют отдельной настройки сервиса изображений.

Основной текст описания автор пишет по-китайски, есть английская и японская версии. Для английской прозы встроены метаданные десяти жанров, например LitRPG, Romantasy и Cozy Fantasy, и пяти китайских: сюаньхуань, сянься, городской и ужасы, плюс жанр other для всего остального.

Версия 2.0.0 объединила чат и производственные цепочки в одном исполнителе. Проекты версии 1.x переносят командами `inkos work migrate --json` и `inkos work migrate --apply`, исходные папки при этом сохраняются.

Чужие скиллы дают агенту только инструкции и справочные материалы, а их скрипты InkOS не запускает.

Лицензия AGPL-3.0.

Как отключить. Удалите пакет командой `npm uninstall -g @actalk/inkos`. Скилл, поставленный через ClawHub, уберите из каталога скиллов OpenClaw, например из `~/.openclaw/skills/`. Проекты с книгами, глобальный `~/.inkos/.env` и файл `.inkos/secrets.json` с ключами остаются на диске, поэтому удалите их сами, если они больше не нужны. Остановить фоновую запись глав можно, завершив процесс, запущенный командой `inkos up`.

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

Чем InkOS отличается от обычной просьбы написать главу?

Он хранит состояние книги: канон, героев, нити сюжета, снимок после каждой главы. Текст, индекс и структурное состояние записываются одним набором файлов, поэтому при сбое запись прозы не уходит вперед состояния.

Что делает команда `inkos short run`?

Запускает конвейер законченного рассказа с параметрами `--direction`, `--chapters` и `--chars`. Результат появляется в `shorts/<название>/final/`: `full.md`, `sales-package.md`, `cover-prompt.md` и `cover.png`, если настроен сервис обложек.

Как работает режим фанфика?

Команда `inkos fanfic init --from source.txt --mode canon` создает книгу по исходному тексту. Режимов четыре: canon, au, ooc и cp. Импортер канона сохраняет факты источника и границы информации героев.

Можно ли назначить разным ролям разные модели?

Да. Командой `inkos config set-model` модель задают каждому агенту отдельно, например писателю одну, а аудитору другую. Агенты без своих настроек берут глобальную модель.

Что такое режим daemon?

Команда `inkos up` запускает фоновый цикл, который пишет главы по расписанию. При необходимости решения человека цикл останавливается с результатом на проверку. Уведомления идут в Telegram, Feishu, WeCom и по webhook с подписью HMAC-SHA256.

Как продолжить роман, который уже написан?

Команда `inkos import chapters` импортирует главы, разбирая их по заголовкам вроде `Chapter N` или по вашему шаблону, и заново строит состояние, краткие содержания, сюжетные крючки и связи героев. После импорта `inkos write next` пишет следующую главу.

Обсуждение

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

Скиллы

24 скилла для прозы в Markdown, от замысла до печати, и команда story, которая находит противоречия в сюжете раньше читателей

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

Плагин для романов и сериальной прозы: агент muse ведет от идеи до черновика, а писатель, критик, редактор и проверка канона работают отдельными агентами

ПлагинРасширенный доступ530Звезды репозитория

Набор из 13 скиллов для написания сетевой прозы в кодинг-агенте: разбор рейтингов и хитов, план и текст, чистка ИИ-стиля, обложка

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

Скилл для написания романа с девятью агентами: сеттинг, план томов и глав, проза, проверка на машинный стиль и архив с памятью героев

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

Скилл Эдди Османи для ясного письма: интервью и черновик из ваших слов, правка готового текста, разбор без изменения файла

СкиллМинимальный доступ281Звезды репозитория

Скилл для очистки текста от примет ИИ: чинит структуру художественной прозы и правит рабочие документы по правилам их жанра

СкиллМинимальный доступ3,4 тыс.Звезды репозитория

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

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

ЗаписьОфициальныйЗвезды репозиторияГлавное отличие
InkOS (эта запись)нет10 468
chinese-novelistнет4 124один скилл для романа на китайском по главам с опросом автора и памятью предпочтений
Shanyin, мастер сценариевнет1 377скилл-сценарист для форматов от ролика до сериала, без конвейера глав и хранимого состояния книги

Коротко о README

Описание на китайском, английском и японском языках начинается с обзора версии 2.0.0 и перечня режимов творчества. Дальше идут установка, подключение к OpenClaw, формат скиллов, три способа настроить модель, примеры для первой книги, рассказа, обложки и открытого мира. Отдельные разделы объясняют память, управляющие документы, правила длины, справочник команд и план развития. В репозитории есть пакеты cli и core с 19 встроенными скиллами и справочными файлами к ним, а также история изменений и руководство для участников.

Бейдж для README

Исходный SKILL.md

---
name: inkos
description: Use InkOS as a Pi-agent creative harness for novels, short fiction, scripts, storyboards, interactive films, open worlds, derivative works, and long-document translation.
---

# InkOS Creative Harness

InkOS is a text-creation harness. The main Pi agent understands the request, activates professional Skills, invokes typed capability actions, and reports only persisted results.

## Core contract

- Discussion stays discussion. Creation and mutation happen only through capability actions.
- A successful action is proven by its `ActionResult` and artifact revision, never by assistant prose.
- User intent, current Work constraints, established facts, and explicit prohibitions outrank model defaults.
- Skills provide professional methods but never grant write permission.
- Review returns evidence-backed observations. It does not score prose, reject a chapter, or authorize an automatic rewrite.
- Revision is an explicit action. Preserve source revisions and report the new artifact revision.
- Context is assembled per task: LLM semantic selection chooses relevant source sections after deterministic candidate discovery. Protected intent and selected current facts are never compressed; lower-priority context is semantically compiled only on budget overflow.

## Creation profiles

- `longform-novel`: foundation, chapter planning, writing, review, revision, state projection, forecast, cover.
- `short-fiction`: complete short story, plan, review notes, sales package, cover.
- `script`: screenplay, vertical short drama, audio drama, interactive script.
- `storyboard`: editable storyboard, typed image-prompt assets, image generation.
- `interactive-film`: story tree, flags, script, storyboard, image assets, playable graph, export.
- `play-world`: open-world or guided interaction with persistent entities, relationships, time, evidence, inventory, scenes, and images.
- `fanfic`, `spinoff`, `imitation`, `continuation`: derivative creation with explicit lineage and source canon.
- `translation`: multilingual long-document translation with terminology and resumable artifacts.

## Natural-language use

Use normal conversation to discuss or request work. The agent chooses the relevant profile and Skill. A creation proposal may require confirmation; recoverable edits inside the current Work can run directly.

Force a Skill when needed:

```text
@inkos-story-review review chapter 8 against the current reader promise
@inkos-imitation-writing keep the reference cadence but create a new story
```

Inspect available Skills and Works through the agent tools rather than guessing storage paths.

## Explicit CLI actions

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

Foxx AIInkOS
Foxx AI

Я Foxx AI и уже разобрал этот инструмент. Спросите про установку, настройку или что угодно еще, отвечу простыми словами.