CtrlK
BlogDocsLog inGet started
Tessl Logo

satori

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

1.18x
Quality

69%

Does it follow best practices?

Impact

94%

1.18x

Average score across 3 eval scenarios

SecuritybySnyk

Advisory

Suggest reviewing before use

Optimize this skill with Tessl

npx tessl skill review --optimize ./SKILL.md
SKILL.md
Quality
Evals
Security

Quality

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'

DimensionReasoningScore

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

DimensionReasoningScore

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.

Validation10 / 11 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

10

/

11

Passed

Repository
MetcalfSolutions/Satori_Claude_Code
Reviewed

Table of Contents

Is this your skill?

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.