soul

Build persistent user identity profiles from session observations into SOUL.md.

37|7|Updated Mar 19, 2026
One-click install
npx skills add https://github.com/unclejobs-ai/second-claude-code --skill soul-unclejobs-ai
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: soul
Source: https://github.com/unclejobs-ai/second-claude-code/tree/main/skills/soul
Command: npx skills add https://github.com/unclejobs-ai/second-claude-code --skill soul-unclejobs-ai

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

The SOUL skill builds and maintains a persistent user identity profile from observed session signals, so downstream actions are grounded in evidence rather than generic assumptions.

Core Features & Use Cases

  • Session signal learning: Collect structured observations (with context, raw evidence, and inferred patterns) into an append-only log for later synthesis.
  • Evidence-backed identity synthesis: Propose updates to SOUL.md using minimum thresholds, an anti-generic filter, contradiction handling as conditional rules, and drift detection that blocks large changes unless acknowledged.
  • Operational profile management: Initialize, show, diff, apply after review, reset (archive + clear), and generate shipping/retro-grounded cadence context.

Quick Start

Ask: "Run soul propose in hybrid mode and show the proposed SOUL.md diff with evidence citations."

Frequently Asked Questions about soul

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I build a persistent user identity profile from session observations?

You can model user work patterns by collecting session signals with context and raw evidence, then synthesizing inferred patterns into an operational profile that grounds downstream actions in observed behavior rather than generic assumptions.

What is the best way to apply context-aware communication preferences across sessions?

You can apply context-aware communication preferences by using the propose command in hybrid mode to generate a SOUL.md diff with evidence citations, reviewing the changes, and applying them only after passing strict drift detection and approval guardrails.

How does drift detection work when updating an evidence-backed user profile?

Drift detection works by blocking large or contradictory changes to the user profile unless explicitly acknowledged, resolving contradictions as conditional rules to maintain an accurate, evidence-backed identity synthesis without sudden unreviewed shifts.

Can I generate shipping cadence context using retro metrics and user behavior modeling?

Yes, you can generate shipping cadence context by running retro commands that ground summaries in retro metrics and synthesized work-pattern models, producing an operational profile that reflects actual observed shipping behaviors.

Do I need YAML frontmatter commands to initialize and manage a session memory profile?

Yes, you need YAML frontmatter-defined commands to initialize, learn, propose, apply, diff, and reset the session memory profile, as these commands enforce the strict thresholds, anti-generic filtering, and drift detection required for evidence-backed synthesis.

Why does my user profiling synthesis get blocked by the anti-generic filter?

Your user profiling synthesis gets blocked by the anti-generic filter when proposed updates lack sufficient raw evidence or fall below minimum thresholds, preventing generic assumptions from contaminating the evidence-backed identity profile.