# InkOS Creative Harness

Runs InkOS as a creative harness for novels, scripts, storyboards and translation.

- Repository: https://github.com/Narcooo/inkos (10958 stars)
- Category: Writing
- License: AGPL-3.0
- Last updated: 2026-10-24
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add Narcooo/inkos --skill inkos -g -a claude-code -y`
Codex: `npx skills add Narcooo/inkos --skill inkos -g -a codex -y`
Cursor: `npx skills add Narcooo/inkos --skill inkos -g -a cursor -y`
Gemini CLI: `npx skills add Narcooo/inkos --skill inkos -g -a gemini-cli -y`

## 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.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# 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

The rest: https://github.com/Narcooo/inkos/blob/HEAD/skills/SKILL.md