PersonaNexus Religion Skill

Extend AI agent identities with structured religion and spiritual framework configuration. Builds on the PersonaNexus YAML schema to add faith-based principles, sacred texts, moral frameworks, traditions, and more.

What This Skill Does

• Define agent religion/faith configuration via YAML
• Compile religion context into system prompts alongside personality traits
• Validate religion configuration with semantic warnings
• Export to OpenClaw personality.json, SOUL.md, Anthropic XML, and more

Setup

Install dependencies:

pip install pydantic pyyaml typer rich

Usage

1. Create an Agent with Religion

Start from a template:

• templates/religion-minimal.yaml -- Simple: enabled + influence + principles
• templates/religion-full.yaml -- All fields: tradition, denomination, sacred texts, moral framework, traditions, dietary rules, holy days, prayer schedule

2. Validate

from religion_skill import IdentityValidator

validator = IdentityValidator()
result = validator.validate_file("my-agent.yaml")
print(result.valid, result.errors, result.warnings)

3. Compile to a System Prompt

from religion_skill import parse_identity_file, compile_identity

identity = parse_identity_file("my-agent.yaml")
prompt = compile_identity(identity, target="text")
print(prompt)

4. Quick build_persona Helper

from religion_skill.religion import build_persona

prompt = build_persona("my-agent.yaml")
# Includes religion principles in the prompt when enabled

CLI

python -m religion_skill --help

CLI Commands

CLI Examples

# Validate an identity with religion
python -m religion_skill validate templates/religion-full.yaml --verbose

# Compile to text prompt (religion section visible)
python -m religion_skill compile templates/religion-full.yaml --target text

# Compile to OpenClaw personality.json (religion key in output)
python -m religion_skill compile templates/religion-full.yaml --target openclaw --output personality.json

# Show religion configuration
python -m religion_skill religion show templates/religion-full.yaml

# Scaffold a new agent
python -m religion_skill init "My Agent"

Religion YAML Schema