CtrlK
BlogDocsLog inGet started
Tessl Logo
PluginPublic

metcalf-solutions1/satori

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.

1.02x
Quality

88%

Does it follow best practices?

Impact

95%

1.02x

Average score across 8 eval scenarios

SecuritybySnyk

Passed

No findings from the security scan

Overview
Quality
Evals
Security
Files

submit-all.shregistry-submissions/

#!/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. ![GitHub stars](https://img.shields.io/github/stars/MetcalfSolutions/Satori?style=social)'
  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

.mcp.json

CHANGELOG.md

CONTRIBUTING.md

facts.json

gemini-extension.json

LICENSE.md

marketplace.json

NOTICE.md

openclaw.plugin.json

package.json

plugin.json

PRIVACY.md

README.md

SAFETY.md

SKILL.md

tessl.json

tile.json