Adaptation
danjdewhurst/story-skills
This skill should be used when the user asks to "make an audiobook", "narration script", "narrator", "ACX", "Findaway", "pronunciation guide", "how long is the audiobook", "adapt to a screenplay"…
Drives long-form fiction, scripts, storyboards, interactive films and long-document translation through InkOS, with every change made by a typed action.
Install InkOS Creative Harness
$ npx skills add Narcooo/inkos --skill inkos -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install Narcooo/inkos inkos --agent claude-codeProject scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).
$ git clone --depth 1 https://github.com/Narcooo/inkos.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills .claude/skills/inkos && rm -rf skills-srcUse ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.
Claude Code skills documentation · loads skills from .claude/skills/
Install the "inkos" agent skill from https://github.com/Narcooo/inkos/tree/master/skills into .claude/skills/inkos/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "inkos", then confirm the skill loads.Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$skill-installer install https://github.com/Narcooo/inkos/tree/master/skillsType this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.
$ npx skills add Narcooo/inkos --skill inkos -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install Narcooo/inkos inkos --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/Narcooo/inkos.git skills-src && mkdir -p .agents/skills && cp -r skills-src/skills .agents/skills/inkos && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "inkos" agent skill from https://github.com/Narcooo/inkos/tree/master/skills into .agents/skills/inkos/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "inkos", then confirm the skill loads.Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add Narcooo/inkos --skill inkos -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install Narcooo/inkos inkos --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/Narcooo/inkos.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/skills .cursor/skills/inkos && rm -rf skills-srcUse ~/.cursor/skills/ instead of .cursor/skills for a personal install.
Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/
Install the "inkos" agent skill from https://github.com/Narcooo/inkos/tree/master/skills into .cursor/skills/inkos/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "inkos", then confirm the skill loads.Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gemini skills install https://github.com/Narcooo/inkos.git --path skills--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.
$ npx skills add Narcooo/inkos --skill inkos -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install Narcooo/inkos inkos --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/Narcooo/inkos.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/skills .gemini/skills/inkos && rm -rf skills-srcUse ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.
Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/
Install the "inkos" agent skill from https://github.com/Narcooo/inkos/tree/master/skills into .gemini/skills/inkos/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "inkos", then confirm the skill loads.Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gh skill install Narcooo/inkos inkosInstalls for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).
$ npx skills add Narcooo/inkos --skill inkos -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/Narcooo/inkos.git skills-src && mkdir -p .github/skills && cp -r skills-src/skills .github/skills/inkos && rm -rf skills-srcUse ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.
GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/
Install the "inkos" agent skill from https://github.com/Narcooo/inkos/tree/master/skills into .github/skills/inkos/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "inkos", then confirm the skill loads.GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add Narcooo/inkos --skill inkos -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install Narcooo/inkos inkos --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/Narcooo/inkos.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/skills .opencode/skills/inkos && rm -rf skills-srcUse ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.
OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/
Install the "inkos" agent skill from https://github.com/Narcooo/inkos/tree/master/skills into .opencode/skills/inkos/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "inkos", then confirm the skill loads.OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
Facts
- Skill name
inkos- GitHub stars
- 10k
- Used in
- 1 other repo
- Token cost
- ~1.1k tokens
- SKILL.md length
- 475 words
- Files
- 1
- Skills in repo
- 21
- Repo updated
- First seen
- Licence
- AGPL-3.0
At a glance
Drives long-form fiction, scripts, storyboards, interactive films and long-document translation through InkOS, with every change made by a typed action.
- Planning and drafting a novel chapter by chapter, with review and revision passes
- SKILL.md covers Core contract, Creation profiles, Natural-language use and Explicit CLI actions, plus 3 more sections
- Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md
- Writing a short story or a screenplay with a plan you can edit
What it does
InkOS is a text-creation harness: the agent talks with you, picks a creation profile, calls typed capability actions and reports only what those actions actually saved. Discussion stays discussion, so nothing is written to a work until an action succeeds and returns a new artifact revision. Writing methods come from named sub-skills, which can advise but never authorize a write.
The profiles cover long novels (foundation, chapter plans, drafting, review, revision and cover), short fiction, scripts including vertical short drama and audio drama, storyboards with image prompts, interactive films with story trees and playable graphs, open-world play, derivative work such as fanfic and continuations, and long-document translation with terminology. Reviews return evidence-backed notes rather than scores, and revisions keep the earlier version. The `inkos studio` and `inkos tui` commands are available for explicit actions.
When your agent uses it
- Planning and drafting a novel chapter by chapter, with review and revision passes
- Writing a short story or a screenplay with a plan you can edit
- Translating a long document while keeping terminology consistent and resumable
- Building a storyboard or an interactive film from a story idea
Example prompts
- “Set up a longform novel about a lighthouse keeper and plan the first ten chapters.”
- “Review chapter 8 against the promise the story has made to its readers.”
- “Translate the full manuscript in ./drafts/novel-en.md into Japanese and keep a glossary of character names.”
- “Turn this short story into an editable storyboard with image prompts for each scene.”
Requirements
- InkOS with its `inkos` command-line tool
What it can do on your machine
Read from SKILL.md and the folder at commit 8fc2ae5. It shows what the files ask for, not the result of running them.
Tool permissions
Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.
From allowed-tools in the SKILL.md frontmatter.
Runs code
No scripts in the folder and no shell commands in SKILL.md (its code samples are bash).
From the folder's file list and the shell code blocks in SKILL.md.
Network
No URLs in SKILL.md.
From URLs in SKILL.md, links to its own repository left out.
Credentials
Names no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.
Context cost
InkOS Creative Harness loads about 1.1k tokens when it runs. Until then it costs about 44 tokens; SKILL.md has 475 words of instructions outside code blocks.
Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.
Safety
Auto-check passed
The automated check found no risky patterns in SKILL.md.
Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.
SKILL.md
The full file from Narcooo/inkos at commit 8fc2ae5, republished under its AGPL-3.0 licence (© Narcooo). 475 words, ~1,142 tokens.
Download SKILL.mdSave it as
.claude/skills/inkos/SKILL.md (or your agent's skills folder).- 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
ActionResultand 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:
@inkos-story-review review chapter 8 against the current reader promise
@inkos-imitation-writing keep the reference cadence but create a new storyInspect available Skills and Works through the agent tools rather than guessing storage paths.
Show full SKILL.md (194 more words)Show less
Explicit CLI actions
inkos studio
inkos tui
inkos book create --title "My Story" --genre other --lang en
inkos write next <book-id> --count 3
inkos revise <book-id> <chapter> --mode rewrite
inkos review <book-id>
inkos short run --title "A Short Story"
inkos fanfic init --title "Derived Story" --from source.txt --mode canon
inkos export <book-id> --format epubInternal planning, semantic context selection, writing, state projection, and review are one Harness trajectory. review displays persisted qualitative observations.
Revision modes
spot-fix: exact local text patches applied by the host.polish: prose-surface changes only.rewrite: rewrite the affected passage or chapter while preserving authority.rework: restructure scenes when the user explicitly requests structural change.anti-detect: explicit prose cleanup using the activated de-slop Skill.
Context and persistence
- Human-readable story assets remain Markdown.
- Host-consumed state and action results use typed JSON/tool schemas.
- Planner, writer, reviewer, reviser, settler, Play, translation, and production-document compilers submit typed results through Pi tools.
- Conversation compaction and story-context compaction are separate. Both preserve protected current intent and use semantic compilation only after budget overflow.
- Work manifests, artifact revisions, episode events, and model-call traces provide observable lineage.
Failure handling
- Model/provider failures remain operational errors; they are never converted into fictional world outcomes or content verdicts.
- A failed optional asset is reported as an observation without invalidating a successfully persisted manuscript.
- Interrupted actions preserve the last committed artifact and can be retried from persisted state.
- Never claim a file was created or changed without an artifact reference from the action result.
© Narcooo, AGPL-3.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file
Files
Just SKILL.md in skills of Narcooo/inkos.
Open the folder on GitHubat commit 8fc2ae5
Used in 1 other repository
We found 1 copy of this SKILL.md (exact, near-identical or edited) in other folders, from 1 other GitHub owner. This page covers the copy in Narcooo/inkos, which our catalogue first saw on October 7, 2026.
Compare with similar skills
InkOS Creative Harness next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.
| Skill | Stars | Used in | Tokens | Auto-check | Licence | Repo updated |
|---|---|---|---|---|---|---|
| InkOS Creative Harness this skillNarcooo/inkos | 10k | 1 repos | ~1.1k | Automated safety check: Pass | AGPL-3.0 | |
| Adaptationdanjdewhurst/story-skills | 279 | 2 repos | ~3.5k | Automated safety check: Notes | MIT | |
| Storyboard Managerailabs-393/ai-labs-claude-skills | 454 | 1 repos | ~4.6k | Automated safety check: Pass | MIT | |
| Worldbuildingdanjdewhurst/story-skills | 279 | 1 repos | ~3.3k | Automated safety check: Notes | MIT | |
| Novel Character Designuu201/character-arc | 579 | 1 repos | ~635 | Automated safety check: Pass | MIT | |
| Bio Ribo Seq Orf DetectionGPTomics/bioSkills | 1.2k | 1 repos | ~3.1k | Automated safety check: Pass | MIT |
Similar skills
Storyboard Manager
ailabs-393/ai-labs-claude-skills
Assist writers with story planning, character development, plot structuring, chapter writing, timeline tracking, and consistency checking.
Worldbuilding
danjdewhurst/story-skills
This skill should be used when the user asks to "create a location", "add a location", "magic system", "political system", "build the world", "add culture", "world history", "technology system"…
Novel Character Design
uu201/character-arc
网文人设与群像工程。当用户需要设计主角性格、塑造配角功能、构建反派魅力、设计人物关系、规划人物弧光时触发。覆盖60+主角性格标签、30+配角功能模型、20+反派塑造模板，以及人物关系范式与弧光设计方法。
Bio Ribo Seq Orf Detection
GPTomics/bioSkills
Detect and quantify translated ORFs from Ribo-seq using 3-nucleotide periodicity, including uORFs, internal ORFs, dORFs, and novel ORFs.
Bio Ribo Seq Orf Detection
majiayu000/claude-skill-registry
Detect and quantify translated ORFs from Ribo-seq data including uORFs and novel ORFs using RiboCode and ORFquant.
More from Narcooo/inkos
All 21 skills in this repoInkOS Story Review
Narcooo/inkos
Reviews chapters or manuscripts against the standard that fits their genre, audience and your own criteria, showing concrete issues and revising only when asked.
Long-Form Fiction Market Research
Narcooo/inkos
Researches the long-form fiction market with sourced evidence: platform differences, comparable works and audience expectations, to inform topic choices for a novel.
Long Story Analysis
Narcooo/inkos
Breaks down a full novel or long sample into story mechanisms and style traits the agent can reuse as craft, without copying names or wording.
InkOS Story Cover Design
Narcooo/inkos
根据作品、平台与用户视觉要求设计或生成封面。Use for story-cover direction and confirmed cover generation.
Semantic Prose Cleanup
Narcooo/inkos
Diagnoses generic, mechanical or AI-sounding fiction prose by its function and effect, then revises it while keeping plot facts and the author's voice.
InkOS Story Import
Narcooo/inkos
Imports an existing novel manuscript into an InkOS project, rebuilds its story state, and keeps your own chapters apart from reference material and fan-fiction canon.
Related
Categories
Questions about InkOS Creative Harness
What does InkOS Creative Harness do?
Drives long-form fiction, scripts, storyboards, interactive films and long-document translation through InkOS, with every change made by a typed action. InkOS is a text-creation harness: the agent talks with you, picks a creation profile, calls typed capability actions and reports only what those actions actually saved. Discussion stays discussion, so nothing is written to a work until an action succeeds and returns a new artifact revision.
When should I use InkOS Creative Harness?
InkOS Creative Harness fits situations like: planning and drafting a novel chapter by chapter, with review and revision passes; writing a short story or a screenplay with a plan you can edit; translating a long document while keeping terminology consistent and resumable; building a storyboard or an interactive film from a story idea.
How do I install InkOS Creative Harness in Claude Code?
Run `npx skills add Narcooo/inkos --skill inkos -a claude-code`. Or copy the skill folder (skills in Narcooo/inkos) into .claude/skills/inkos in your project. Claude Code loads it when a task matches its description.
How do I install InkOS Creative Harness in Codex?
Run `npx skills add Narcooo/inkos --skill inkos -a codex`. Or copy the skill folder (skills in Narcooo/inkos) into .agents/skills/inkos in your project. Codex loads it when a task matches its description.
Can I use InkOS Creative Harness in Cursor, Gemini CLI or GitHub Copilot?
Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add Narcooo/inkos --skill inkos -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/inkos, .gemini/skills/inkos, .github/skills/inkos and .opencode/skills/inkos in your project.
What does InkOS Creative Harness need to run?
SKILL.md names no scripts, command-line tools or credentials: InkOS Creative Harness is instructions for the agent only. Our summary lists: InkOS with its `inkos` command-line tool.
Does InkOS Creative Harness access the network?
SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.
Is InkOS Creative Harness safe to install?
Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.
What licence does InkOS Creative Harness use?
InkOS Creative Harness is published under the AGPL-3.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.
How many tokens does InkOS Creative Harness use?
About 1.1k tokens (SKILL.md is roughly 4.6k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.
What are the alternatives to InkOS Creative Harness?
Skills that share tags, products or a category with InkOS Creative Harness: Adaptation (danjdewhurst/story-skills, 279 stars), Storyboard Manager (ailabs-393/ai-labs-claude-skills, 454 stars), Worldbuilding (danjdewhurst/story-skills, 279 stars) and Novel Character Design (uu201/character-arc, 579 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
Who maintains InkOS Creative Harness?
Narcooo (a GitHub user) maintains it in Narcooo/inkos, which has 10,163 GitHub stars. The repository holds 21 skills in this directory. The repository was last updated on September 27, 2026.
Source: Narcooo/inkos on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.