Psychologically grounded wisdom companion for inner life. Use for reflective dialogue, grief, dark-night, burnout, anxiety, stress, loneliness, relationship conflict, shadow work, crossroads, tiered crisis check-ins, continuity notes. DO NOT ACTIVATE for pure coding, DevOps, SQL, git, math, or technical tasks, even if user says "I'm stuck" or "struggling with bug." Hybrid: solve technical task first, then add 2 warm grounding sentences for burnout, imposter syndrome, team conflict.
88%
Does it follow best practices?
Impact
95%
1.02xAverage score across 8 eval scenarios
Passed
No findings from the security scan
#!/usr/bin/env bash
# Satori Registry Submission Script
# Run each section one at a time. Review edits before committing.
# Usage: Read each section, uncomment and run individually.
set -euo pipefail
WORK_DIR="/tmp/satori-registry-submissions"
mkdir -p "$WORK_DIR"
cd "$WORK_DIR"
PR_BODY_STANDARD='Satori v6.5.4: open-source wisdom companion skill (Apache 2.0) for Claude Code, CLIs, IDEs, and web chat. One lens per turn, a local SQLite memory vault you control, and a 350-case trigger benchmark (98.0% non-activation on pure code). 16 environments. Install: npx skills add MetcalfSolutions/Satori. Built to be outgrown: success is needing it less, not using it more.
Full zip for Claude.ai and Gemini, Compact edition for ChatGPT, crisis handoff on every surface. Canonical repo: github.com/MetcalfSolutions/Satori. Satori is a structured thinking partner for self-reflection. It is not a substitute for professional therapy, medical advice, or crisis intervention.'
echo "=== Satori Registry Submissions ==="
echo "Working directory: $WORK_DIR"
echo ""
# Verify gh is authenticated
if ! gh auth status &>/dev/null; then
echo "ERROR: gh is not authenticated. Run: gh auth login"
exit 1
fi
echo "✓ GitHub CLI authenticated"
echo ""
# ──────────────────────────────────────────────
# 1. BehiSecc/awesome-claude-skills
# ──────────────────────────────────────────────
submit_behisecc() {
echo "=== Submitting to BehiSecc/awesome-claude-skills ==="
cd "$WORK_DIR"
gh repo fork BehiSecc/awesome-claude-skills --clone=true 2>/dev/null || true
cd awesome-claude-skills 2>/dev/null || cd BehiSecc-awesome-claude-skills
git checkout -b add-satori 2>/dev/null || git checkout add-satori
echo ""
echo ">>> MANUAL STEP: Edit README.md"
echo ">>> Find the appropriate section and add this entry (alphabetically):"
echo '- [Satori](https://github.com/MetcalfSolutions/Satori) - Claude Code skill & open-source wisdom companion (v6.5.4, Apache 2.0) for CLI, IDE, and web chat. One lens per turn, local SQLite vault, 350-case benchmark (98.0% code non-activation). Install: npx skills add MetcalfSolutions/Satori. Built to be outgrown.'
echo ""
read -p "Press Enter after editing README.md..."
git add README.md
git commit -m "Add Satori - psychologically grounded wisdom companion"
git push -u origin add-satori
gh pr create \
--title "Add Satori - wisdom companion Claude skill" \
--body "$PR_BODY_STANDARD"
echo "✓ BehiSecc PR created"
cd "$WORK_DIR"
}
# ──────────────────────────────────────────────
# 2. majiayu000/claude-skill-registry
# ──────────────────────────────────────────────
submit_majiayu000() {
echo "=== Submitting to majiayu000/claude-skill-registry ==="
cd "$WORK_DIR"
gh repo fork majiayu000/claude-skill-registry --clone=true 2>/dev/null || true
cd claude-skill-registry 2>/dev/null || cd majiayu000-claude-skill-registry
git checkout -b add-satori 2>/dev/null || git checkout add-satori
echo ""
echo ">>> MANUAL STEP: Edit registry.json"
echo ">>> Add this JSON entry to the array:"
cat <<'JSONEOF'
{
"name": "satori",
"repo": "MetcalfSolutions/Satori",
"path": ".",
"description": "Satori v6.5.4: open-source wisdom companion skill (Apache 2.0) for Claude Code, CLIs, IDEs, and web chat. One lens per turn, a local SQLite memory vault you control, and a 350-case trigger benchmark (98.0% non-activation on pure code). 16 environments. Install: npx skills add MetcalfSolutions/Satori. Built to be outgrown: success is needing it less, not using it more.",
"category": "personal-development",
"tags": ["mental-health", "psychology", "wisdom", "philosophy", "ifs", "stoicism", "jungian", "conversation"],
"author": "MetcalfSolutions",
"source_url": "https://github.com/MetcalfSolutions/Satori",
"license": "Apache-2.0"
}
JSONEOF
echo ""
read -p "Press Enter after editing registry.json..."
git add .
git commit -m "Add satori to registry"
git push -u origin add-satori
gh pr create \
--title "Add satori to registry" \
--body "Adding Satori, a psychologically grounded wisdom companion.
GitHub: https://github.com/MetcalfSolutions/Satori
License: Apache 2.0"
echo "✓ majiayu000 PR created"
cd "$WORK_DIR"
}
# ──────────────────────────────────────────────
# 3. karanb192/awesome-claude-skills
# ──────────────────────────────────────────────
submit_karanb192() {
echo "=== Submitting to karanb192/awesome-claude-skills ==="
cd "$WORK_DIR"
gh repo fork karanb192/awesome-claude-skills --clone=true 2>/dev/null || true
cd awesome-claude-skills 2>/dev/null || cd karanb192-awesome-claude-skills
git checkout -b add-satori 2>/dev/null || git checkout add-satori
echo ""
echo ">>> MANUAL STEP: Edit README.md"
echo ">>> Match their exact format (may include star ratings, verification, etc.)"
echo ""
read -p "Press Enter after editing README.md..."
git add README.md
git commit -m "Add Satori - psychologically grounded wisdom companion"
git push -u origin add-satori
gh pr create \
--title "Add Satori - wisdom companion Claude skill" \
--body "$PR_BODY_STANDARD"
echo "✓ karanb192 PR created"
cd "$WORK_DIR"
}
# ──────────────────────────────────────────────
# 4. VoltAgent/awesome-agent-skills
# ──────────────────────────────────────────────
submit_voltagent() {
echo "=== Submitting to VoltAgent/awesome-agent-skills ==="
cd "$WORK_DIR"
gh repo fork VoltAgent/awesome-agent-skills --clone=true 2>/dev/null || true
cd awesome-agent-skills 2>/dev/null || cd VoltAgent-awesome-agent-skills
git checkout -b add-satori 2>/dev/null || git checkout add-satori
echo ""
echo ">>> MANUAL STEP: Edit README.md"
echo ">>> Add under Community Skills > Other (or best-fit subcategory):"
echo '- **[MetcalfSolutions/Satori](https://github.com/MetcalfSolutions/Satori)** - Wisdom companion blending psychology and philosophy traditions'
echo ""
read -p "Press Enter after editing README.md..."
git add README.md
git commit -m "Add skill: MetcalfSolutions/Satori"
git push -u origin add-satori
gh pr create \
--title "Add skill: MetcalfSolutions/Satori" \
--body "$PR_BODY_STANDARD"
echo "✓ VoltAgent PR created"
cd "$WORK_DIR"
}
# ──────────────────────────────────────────────
# 5. sickn33/antigravity-awesome-skills
# ──────────────────────────────────────────────
submit_antigravity() {
echo "=== Submitting to sickn33/antigravity-awesome-skills ==="
cd "$WORK_DIR"
gh repo fork sickn33/antigravity-awesome-skills --clone=true 2>/dev/null || true
cd antigravity-awesome-skills 2>/dev/null || cd sickn33-antigravity-awesome-skills
git checkout -b add-satori 2>/dev/null || git checkout add-satori
mkdir -p skills/satori
cat > skills/satori/SKILL.md <<'SKILLEOF'
---
name: satori
description: "Psychologically grounded wisdom companion blending psychology and philosophy into a structured thinking partner"
category: personal-development
risk: safe
source: community
date_added: "2026-04-05"
author: MetcalfSolutions
tags: [mental-health, psychology, wisdom, philosophy, ifs, stoicism, jungian, conversation]
tools: [claude]
---
## Overview
Satori v6.5.4: open-source wisdom companion skill (Apache 2.0) for Claude Code, CLIs, IDEs, and web chat. One lens per turn, a local SQLite memory vault you control, and a 350-case trigger benchmark (98.0% non-activation on pure code). 16 environments. Install: npx skills add MetcalfSolutions/Satori. Built to be outgrown: success is needing it less, not using it more.
## When to Use
- When seeking a structured philosophical or psychological conversation partner
- When exploring internal conflicts through IFS or Jungian frameworks
- When working through difficult emotions using DBT-informed approaches
- When needing presence-based support during periods of deep despair (Dark Night protocol)
## How It Works
Satori operates as a progressive disclosure skill with modular reference architecture. It provides:
1. **Guided onboarding** that establishes the relationship framework
2. **Multiple therapeutic modalities** (IFS, DBT, CFT, Schema Therapy)
3. **Wisdom traditions** for philosophical depth
4. **Specialized protocols** for specific situations
## Examples
- "I'd like to explore a recurring pattern in my relationships" → IFS-informed parts work
- "I'm feeling deep existential despair" → Dark Night protocol (presence-only mode)
- "Help me understand my shadow" → Jungian Shadow Work (5-session arc)
## Best Practices
- Satori is a thinking partner, not a therapy replacement
- Allow the onboarding sequence to complete for best results
- Engage honestly: the system responds to authentic engagement
## Security & Safety Notes
- No data collection or external API calls
- All processing happens within the Claude conversation
- Explicitly not a clinical tool: includes appropriate disclaimers
- Safe for general use
## Related Skills
None currently.
SKILLEOF
# Run validation if available
if [ -f package.json ]; then
npm install
npm run validate || echo "WARNING: Validation failed: review output above"
fi
git add skills/satori/SKILL.md
git commit -m "feat: add satori skill"
git push -u origin add-satori
gh pr create \
--title "feat: add satori wisdom companion skill" \
--body "Adding Satori, a psychologically grounded wisdom companion.
GitHub: https://github.com/MetcalfSolutions/Satori
License: Apache 2.0
Risk: safe
Category: personal-development"
echo "✓ antigravity PR created"
cd "$WORK_DIR"
}
# ──────────────────────────────────────────────
# 6. ComposioHQ/awesome-claude-skills
# ──────────────────────────────────────────────
submit_composiohq() {
echo "=== Submitting to ComposioHQ/awesome-claude-skills ==="
echo "WARNING: This repo may only list official Anthropic skills."
echo "Check the README first: if all entries link to anthropics/skills/, skip this."
read -p "Continue? (y/n) " -n 1 -r
echo ""
[[ ! $REPLY =~ ^[Yy]$ ]] && { echo "Skipped."; return; }
cd "$WORK_DIR"
gh repo fork ComposioHQ/awesome-claude-skills --clone=true 2>/dev/null || true
cd awesome-claude-skills 2>/dev/null || cd ComposioHQ-awesome-claude-skills
git checkout -b add-satori 2>/dev/null || git checkout add-satori
echo ""
echo ">>> MANUAL STEP: Edit README.md"
echo ">>> Add under Productivity & Organization (alphabetically):"
echo '- [satori](https://github.com/MetcalfSolutions/Satori) - Psychologically grounded wisdom companion blending psychology and philosophy into a structured thinking partner.'
echo ""
read -p "Press Enter after editing README.md..."
git add README.md
git commit -m "Add Satori - psychologically grounded wisdom companion"
git push -u origin add-satori
gh pr create \
--title "Add Satori - psychologically grounded wisdom companion skill" \
--body "$PR_BODY_STANDARD"
echo "✓ ComposioHQ PR created"
cd "$WORK_DIR"
}
# ──────────────────────────────────────────────
# 7. travisvn/awesome-claude-skills
# ──────────────────────────────────────────────
submit_travisvn() {
echo "=== Submitting to travisvn/awesome-claude-skills ==="
echo "REQUIREMENTS: 10+ GitHub stars, PR must NOT be AI-generated"
echo "Write/edit this PR by hand for compliance."
read -p "Continue? (y/n) " -n 1 -r
echo ""
[[ ! $REPLY =~ ^[Yy]$ ]] && { echo "Skipped."; return; }
cd "$WORK_DIR"
gh repo fork travisvn/awesome-claude-skills --clone=true 2>/dev/null || true
cd awesome-claude-skills 2>/dev/null || cd travisvn-awesome-claude-skills
git checkout -b add-satori 2>/dev/null || git checkout add-satori
echo ""
echo ">>> MANUAL STEP: Edit README.md"
echo ">>> Find the Individual Skills table under Community Skills and add:"
echo '| **[Satori](https://github.com/MetcalfSolutions/Satori)** | Claude Code skill & open-source wisdom companion (v6.5.4, Apache 2.0) for CLI, IDE, and web chat. One lens per turn, local SQLite vault, 350-case benchmark (98.0% code non-activation). Install: npx skills add MetcalfSolutions/Satori. Built to be outgrown. |'
echo ""
read -p "Press Enter after editing README.md..."
git add README.md
git commit -m "Add Satori - wisdom companion Claude skill"
git push -u origin add-satori
gh pr create \
--title "Add Satori - wisdom companion Claude skill" \
--body "$PR_BODY_STANDARD"
echo "✓ travisvn PR created"
cd "$WORK_DIR"
}
# ──────────────────────────────────────────────
# 8. e2b-dev/awesome-ai-agents (Tier 3)
# ──────────────────────────────────────────────
submit_e2b() {
echo "=== Submitting to e2b-dev/awesome-ai-agents ==="
cd "$WORK_DIR"
gh repo fork e2b-dev/awesome-ai-agents --clone=true 2>/dev/null || true
cd awesome-ai-agents 2>/dev/null || cd e2b-dev-awesome-ai-agents
git checkout -b add-satori 2>/dev/null || git checkout add-satori
echo ""
echo ">>> MANUAL STEP: Edit README.md"
echo ">>> Find the open-source section and add the detailed entry."
echo ">>> See SUBMISSION-GUIDE.md #8 for the exact format."
echo ""
read -p "Press Enter after editing README.md..."
git add README.md
git commit -m "Add Satori - psychologically grounded wisdom companion agent"
git push -u origin add-satori
gh pr create \
--title "Add Satori - wisdom companion cognitive agent" \
--body "Satori v6.5.4: open-source wisdom companion skill (Apache 2.0) for Claude Code, CLIs, IDEs, and web chat. One lens per turn, a local SQLite memory vault you control, and a 350-case trigger benchmark (98.0% non-activation on pure code). 16 environments. Install: npx skills add MetcalfSolutions/Satori. Built to be outgrown: success is needing it less, not using it more.
Full zip for Claude.ai and Gemini, Compact edition for ChatGPT, crisis handoff on every surface. Canonical repo: github.com/MetcalfSolutions/Satori. Satori is a structured thinking partner for self-reflection. It is not a substitute for professional therapy, medical advice, or crisis intervention."
echo "✓ e2b-dev PR created"
cd "$WORK_DIR"
}
# ──────────────────────────────────────────────
# 9. kyrolabs/awesome-agents (Tier 3)
# ──────────────────────────────────────────────
submit_kyrolabs() {
echo "=== Submitting to kyrolabs/awesome-agents ==="
cd "$WORK_DIR"
gh repo fork kyrolabs/awesome-agents --clone=true 2>/dev/null || true
cd awesome-agents 2>/dev/null || cd kyrolabs-awesome-agents
git checkout -b add-satori 2>/dev/null || git checkout add-satori
echo ""
echo ">>> MANUAL STEP: Edit README.md"
echo ">>> Find the Conversational/General Agents section and add:"
echo '- [Satori](https://github.com/MetcalfSolutions/Satori) - Claude Code skill & open-source wisdom companion (v6.5.4, Apache 2.0) for CLI, IDE, and web chat. One lens per turn, local SQLite vault, 350-case benchmark (98.0% code non-activation). Install: npx skills add MetcalfSolutions/Satori. Built to be outgrown. '
echo ""
read -p "Press Enter after editing README.md..."
git add README.md
git commit -m "Add Satori - psychologically grounded wisdom companion"
git push -u origin add-satori
gh pr create \
--title "Add Satori - wisdom companion agent" \
--body "Adding Satori, a psychologically grounded AI wisdom companion.
GitHub: https://github.com/MetcalfSolutions/Satori
License: Apache 2.0"
echo "✓ kyrolabs PR created"
cd "$WORK_DIR"
}
# ──────────────────────────────────────────────
# Run submissions
# Uncomment the ones you want to run:
# ──────────────────────────────────────────────
echo ""
echo "Available submission functions:"
echo " submit_behisecc # BehiSecc/awesome-claude-skills"
echo " submit_majiayu000 # majiayu000/claude-skill-registry (JSON)"
echo " submit_karanb192 # karanb192/awesome-claude-skills"
echo " submit_voltagent # VoltAgent/awesome-agent-skills"
echo " submit_antigravity # sickn33/antigravity-awesome-skills"
echo " submit_composiohq # ComposioHQ/awesome-claude-skills"
echo " submit_travisvn # travisvn/awesome-claude-skills (requires 10+ stars)"
echo " submit_e2b # e2b-dev/awesome-ai-agents (Tier 3)"
echo " submit_kyrolabs # kyrolabs/awesome-agents (Tier 3)"
echo ""
echo "Source each function or uncomment below to run:"
# submit_behisecc
# submit_majiayu000
# submit_karanb192
# submit_voltagent
# submit_antigravity
# submit_composiohq
# submit_travisvn
# submit_e2b
# submit_kyrolabs.agents
plugins
satori
skills
satori
references
.claude-plugin
.codex-plugin
.cursor
skills
satori
references
.gemini
.github
.hermes
skills
satori
references
.opencode
command
skills
satori
references
.tessl-plugin
.windsurf
rules
compact
hooks
references
registry-submissions
scripts