Satori is a clinically informed wisdom companion for navigating the inner life — emotions, meaning, grief, purpose, relationship, identity, and the questions that don't resolve easily. Activate when someone is processing something difficult, wrestling with a life question, seeking perspective, or simply needs to think alongside someone who won't rush them toward an answer. Also activate when someone uses language like "I've been struggling with," "I don't know what to do," or "I need to figure out" — or any emotionally charged framing. When in doubt, activate. Draws from Taoism, Buddhism, Stoicism, Christianity, Sufi wisdom, Hindu philosophy, Confucian ethics, and African thought, alongside modern psychology, neuroscience, and trauma-informed frameworks (IFS, DBT, CFT, Schema Therapy, Somatic). Uses Motivational Interviewing, Voss tactical empathy, McAdams Life Story, and Singer Self-Defining Memory — woven naturally, not mechanically.
78
69%
Does it follow best practices?
Impact
94%
1.18xAverage score across 3 eval scenarios
Advisory
Suggest reviewing before use
Optimize this skill with Tessl
npx tessl skill review --optimize ./SKILL.mdQuality
Discovery
82%Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.
The description excels at trigger term quality and completeness, with explicit activation guidance and natural user language examples. However, the overly broad activation criteria ('When in doubt, activate') and vague action descriptions weaken its distinctiveness and specificity. The description is also verbose and could be more concise while retaining its strengths.
Suggestions
Replace vague action language like 'navigating the inner life' with concrete actions such as 'helps reframe difficult emotions, explores meaning through philosophical lenses, guides reflective self-inquiry'
Remove or narrow 'When in doubt, activate' as it creates high conflict risk with other skills — instead specify more precise boundaries like 'Do NOT activate for simple factual questions or technical problems that happen to use frustrated language'
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | The description names the domain (emotional/psychological support) and lists many frameworks and traditions, but the actual actions are vague — 'navigating the inner life,' 'processing something difficult,' 'think alongside someone.' It doesn't list concrete actions like 'reframe negative thought patterns' or 'guide grief processing exercises.' The specificity is more about inputs/frameworks than outputs/actions. | 2 / 3 |
Completeness | Clearly answers both what (wisdom companion for navigating emotions, meaning, grief, purpose, etc., drawing from multiple philosophical and psychological traditions) and when (explicit 'Activate when' clauses with specific trigger phrases and scenarios, plus the generous 'When in doubt, activate' guidance). | 3 / 3 |
Trigger Term Quality | Excellent coverage of natural trigger phrases users would actually say: 'I've been struggling with,' 'I don't know what to do,' 'I need to figure out,' plus domain terms like 'emotions, meaning, grief, purpose, relationship, identity.' These are highly natural and cover common variations of how users express emotional needs. | 3 / 3 |
Distinctiveness Conflict Risk | While the philosophical/therapeutic framing is distinctive, the extremely broad activation criteria ('any emotionally charged framing,' 'When in doubt, activate') create significant conflict risk. This skill would likely trigger for many conversations that might be better served by other skills, especially any that involve user frustration or uncertainty. | 2 / 3 |
Total | 10 / 12 Passed |
Implementation
57%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This SKILL.md functions well as a hub/overview document with excellent progressive disclosure through its reference file architecture and clear load-order table. Its main weaknesses are the lack of concrete executable examples within the skill itself (relying entirely on referenced files for implementation detail) and some unnecessary descriptive prose that doesn't add actionable value. The workflow is reasonably clear but lacks validation checkpoints for a system with this many moving parts.
Suggestions
Add a concrete example of the 6-step conversation model in action (even a brief one) so the skill is actionable without loading clinical-spine.md
Add a validation step or checklist for session initialization — e.g., 'Confirm these files loaded: SOUL.md ✓, clinical-spine.md ✓, traditions-quickref.md ✓' to improve workflow clarity
Trim the North Star quote and 'What Satori Does Not Do' section — these are identity/soul content that belongs in SOUL.md, not the operational skill file
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The content is reasonably well-organized but includes some unnecessary elaboration. The 'What Satori Does Not Do' section and 'North Star' quote add flavor but could be tighter. The opening conventions section is useful but slightly verbose. Some lines like 'A warm, engaged companion who thinks with clinical discipline and speaks with humane, conversational ease' are descriptive padding. | 2 / 3 |
Actionability | The skill provides concrete guidance through the load order table, slash commands, conversation model steps, and opening conventions — these are actionable. However, the actual execution details are entirely delegated to reference files, so this SKILL.md alone doesn't contain executable instructions. The core conversation model is described at a summary level without concrete examples of what good responses look like. | 2 / 3 |
Workflow Clarity | The load order table provides a clear conditional workflow for which files to load when, and the core conversation model outlines a 6-step sequence. However, there are no validation checkpoints — no way to verify correct file loading, no feedback loops for when the conversation model isn't working, and no explicit error recovery steps. The opening conventions provide good branching logic but lack verification. | 2 / 3 |
Progressive Disclosure | This is the skill's strongest dimension. The content is structured as a clear overview/hub that points to well-organized, one-level-deep reference files with explicit load conditions. The table format for file references with 'When to Load' conditions is excellent progressive disclosure. Content is appropriately split between the overview and detailed reference files. | 3 / 3 |
Total | 9 / 12 Passed |
Validation
90%Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.
Validation — 10 / 11 Passed
Validation for skill structure
| Criteria | Description | Result |
|---|---|---|
frontmatter_unknown_keys | Unknown frontmatter key(s) found; consider removing or moving to metadata | Warning |
Total | 10 / 11 Passed | |
af7528a
Table of Contents
If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.