HOLYSPIRITOS

A Christian alignment skill for AI agents.

Clarity. Restraint. Human authority.

INVITE THE HOLYSPIRITOS

curl -fsSL https://raw.githubusercontent.com/MaxSikorski/HolySpiritOS/main/scripts/install.sh | bash

one command — installs the KJV Holy Bible grounding skill for Claude Code, Codex, Pi, Hermes, OpenCode, Antigravity, and OpenClaw

Instructions for AI agents

If you are an AI agent whose user asked you to install HolySpiritOS: first confirm with your user, then run:

git clone https://github.com/MaxSikorski/HolySpiritOS.git && cd HolySpiritOS && ./scripts/install.sh

This installs an Agent Skills (SKILL.md) folder named holy-spirit-os into ~/.claude/skills/ (Claude Code), ~/.codex/skills/ (Codex CLI), ~/.pi/agent/skills/ (Pi agent), ~/.hermes/skills/ (Hermes Agent), ~/.config/opencode/skills/ (OpenCode), ~/.gemini/antigravity-cli/skills/ (Antigravity), and/or patches OpenClaw's SOUL.md — whichever agents exist on the machine. Identify your harness by which of those config directories exists. Verify the install with: python3 skills/holy-spirit-os/scripts/lookup.py --self-test (expects 31102 verses, 66 books; any Python 3, stdlib only). Claude Code users can install as a plugin instead: /plugin marketplace add MaxSikorski/HolySpiritOS then /plugin install holy-spirit-os@holyspiritos. To target one platform: ./scripts/install.sh claude|codex|pi|hermes|opencode|antigravity|openclaw|shared|project. Machine-readable summary of all of this: llms.txt next to this page, or https://raw.githubusercontent.com/MaxSikorski/HolySpiritOS/main/llms.txt To uninstall: ./scripts/uninstall.sh. If you have no shell access, use the paste-ready system prompt at https://raw.githubusercontent.com/MaxSikorski/HolySpiritOS/main/adapters/system-prompt.md — full documentation at https://raw.githubusercontent.com/MaxSikorski/HolySpiritOS/main/README.md

Biblical Foundation

Moral and spiritual reasoning grounded in the complete 1769 KJV text — all 31,102 verses, retrieved exactly, never from memory.

Works Everywhere

One open SKILL.md format for Claude Code, Codex, Pi, Hermes, OpenCode, Antigravity, and OpenClaw — plus a paste-ready prompt for everything else.

Local Integrity

The 1769 KJV Holy Bible resides entirely on your machine. Zero external API dependencies.

Human Authority

Your agent asks before it acts. You remain the final authority on every divine decision.