PersonaNexus Agent Religion

Extend AI agent personalities with religion, faith, and spiritual frameworks. Define principles, sacred texts, moral frameworks, traditions, and more.

Security Scan

The skill is internally consistent with its stated purpose (local tooling to add religion/spiritual frameworks to agent identities); nothing in the files or instructions demands unrelated credentials, network calls, or elevated persistence.

Purpose & Capability

Name/description match the code and templates: parser, validator, compiler, personality mappings, and example YAMLs all implement religion/spiritual configuration for agent identities. Required binaries (python3 and pip) are reasonable for a Python package. One minor inconsistency: the declared alternative binary 'uv' is unexplained and not referenced in the code or docs.

Instruction Scope

SKILL.md and README instruct only local operations: parsing/validating YAML, compiling prompts, and exporting local files. The provided code excerpts show schema validation, trait mapping, and prompt compilation; no instructions request reading unrelated system files, accessing credentials, or transmitting data externally. The documentation explicitly states 'No data leaves your machine.'

Install Mechanism

There is no automated install spec in the registry (instruction-only), which reduces installer risk. Dependencies are standard PyPI packages listed in requirements.txt and SKILL.md (pydantic, pyyaml, typer, rich). No download-from-URL or extract-based installers were found in the provided manifest. Note: because code files are included, running the skill will execute local Python code; installing dependencies via pip is needed to use it.

Credentials

No environment variables, credentials, or config paths are requested. The skill's functionality (local YAML processing and prompt compilation) does not require secrets or external credentials — the declared requirements are proportionate. The only oddity is the anyBins entry 'uv' which does not map to any declared dependency or usage.

Persistence & Privilege

The skill is not flagged 'always: true' and uses normal model invocation. It does not request persistent system-wide configuration or other skills' credentials. It contains CLI entry points (python -m religion_skill) and local code — that is normal for a Python-based skill and does not imply elevated platform privileges.

Assessment

This package appears to do what it claims: local parsing, validation, and compilation of agent identity YAML files with an added religion section. Still, before installing or running it: 1) Review the remaining truncated files (the omitted 7 files) for any network calls or subprocess execution you might be uncomfortable with; 2) Run it in an isolated environment (virtualenv) and inspect runtime behavior; 3) Be aware that executing the included Python modules will run code from the skill bundle locally — if you don't trust the source, avoid executing them; 4) Note the minor metadata oddities: the registry listing had no homepage but SKILL.md points to a GitHub URL, and the 'anyBins' value 'uv' is unexplained — these look like small packaging mistakes rather than malicious intent. If you want higher assurance, ask the publisher for the full upstream repository link and verify the code there (or request a signed release).

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

Command	Description
validate FILE	Parse and validate a YAML identity file
compile FILE --target TARGET	Compile identity to a system prompt
init NAME --type TYPE	Scaffold a new agent identity YAML
religion show FILE	Display the religion config from a YAML file
personality ocean-to-traits	Map OCEAN scores to personality traits
personality disc-to-traits	Map DISC scores to personality traits
personality jungian-to-traits	Map Jungian scores to personality traits
personality list-disc-presets	Show available DISC presets
personality list-jungian-presets	Show available Jungian 16-type presets

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

religion:
  enabled: true                          # Enable religion (default: false)
  tradition_name: "Christianity"         # Faith tradition
  denomination: "Benedictine"            # Specific denomination or sect
  influence: "strong"                    # subtle | moderate | strong | central

  principles:                            # Core guiding principles
    - "Love your neighbor"
    - "Seek justice, love mercy"

  sacred_texts:
    - name: "The Bible"
      description: "Primary scripture"
      authority_level: "canonical"        # canonical | authoritative | inspirational

  moral_framework:
    name: "Virtue ethics"
    description: "Rooted in classical virtues"
    principles:
      - "Humility as foundation"
      - "Moderation in all things"
    decision_weight: 0.8                  # 0-1, how heavily to weigh in decisions

  traditions:
    - name: "Lectio Divina"
      description: "Contemplative reading"
      behavioral_impact: "Encourages slow, reflective analysis"

  dietary_rules:
    - rule: "Simple, moderate meals"
      strictness: "moderate"              # strict | moderate | flexible
      exceptions: ["health needs"]

  holy_days:
    - name: "Easter"
      description: "Celebration of the Resurrection"
      observance: "prayer and celebration"
      period: "annual"                    # annual | weekly | monthly

  prayer_schedule:
    enabled: true
    frequency: "3x daily"
    description: "Morning, midday, and evening prayer"

  notes: "Additional context about the agent's faith"

Compile Targets

Target	Output Format
text	Plain text system prompt with religion section
anthropic	Claude-optimized with XML sections
openai	GPT-optimized plain text
openclaw	personality.json dict with religion key
soul	SOUL.md + STYLE.md with faith section
json	Full identity + metadata
markdown	Formatted Markdown document

External Endpoints

This skill does not make any network requests. All processing is local.

Security & Privacy

No data leaves your machine. PersonaNexus operates entirely on local YAML files. Identity files should not contain secrets or API keys.

Learn More

Full documentation and the main PersonaNexus framework:

https://github.com/PersonaNexus/personanexus