CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

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.

82

1.18x
Quality

79%

Does it follow best practices?

Impact

94%

1.18x

Average score across 3 eval scenarios

SecuritybySnyk

Low

Low-risk findings worth noting

Fix and improve this skill with Tessl

tessl review fix ./SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

75%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

A well-structured overview body that uses tables for token efficiency, externalizes all deep content to real one-level-deep reference files, and provides genuinely executable conversational guidance (verbatim opening lines, explicit load conditions, a sequenced conversation model). The main defects are two dangling references — the 'Always' CLAUDE.md load and the skills/[command].md backing for 18 listed slash commands — and the absence of any checkpoint/feedback loop in the conversation workflow.

Suggestions

Resolve the dangling references: either include the skills/ directory files for the 18 listed slash commands and the CLAUDE.md file, or remove those rows/commands from the tables so every referenced path exists in the bundle.

Trim the 18-row slash-command table to the commands a fresh session actually needs (or move the full command list to a reference file), and compress the 'North Star' quote block into a single line to tighten conciseness.

Add one explicit checkpoint to the conversation model — e.g. a drift-detection or re-attunement step ('if the response sounds institutional or stacked with frameworks, re-anchor on SOUL.md') — to give the workflow a feedback loop rather than a one-way sequence.

DimensionReasoningScore

Conciseness

The body is a lean, table-driven overview: no explanation of concepts Claude already knows, no padding paragraphs, and bulk detail (a 35KB clinical-spine.md, 35KB conversation-toolkit.md) is properly externalized. Minor trims are possible — the 18-row slash-command table and the 'North Star' quote block are identity content that could partially live in SOUL.md/tone-and-voice.md — keeping it at 'efficient; minor instances of over-explanation that could be trimmed' rather than the every-token-earns-its-place level of 5.

4 / 5

Actionability

For an instruction-only conversational skill, the guidance is concrete and executable: verbatim opening lines per situation ('I'm glad you're here. What's on your mind, or what's been weighing on you?'), a six-step conversation model with a one-line definition per step, explicit prohibitions ('one per response, applied with precision'), and exact file paths with load conditions. It stops short of 'fully executable covering common cases' because the core model steps are deliberately one-line summaries ('Offer a soft working hypothesis with tentative language') whose operational detail is deferred to clinical-spine.md — the depth that would make responses copy-paste ready isn't in this file, matching 'mostly executable guidance; concrete ... with minor gaps.'

4 / 5

Workflow Clarity

Two clear sequences are present: the mandatory load order ('Load SOUL.md, clinical-spine.md, and traditions-quickref.md at the start of every conversation. In Claude Code, also load CLAUDE.md and the .satori/core/ files') and the six-step Attune→Anchor model, plus condition→action branching for openings ('Clearly in distress — skip framing, move directly to empathic presence'). No destructive or batch operations exist, so the validation-loop cap doesn't apply. It's a 4 rather than 5 because there are no feedback/checkpoint mechanisms (e.g., drift detection or mid-conversation re-attunement steps are named only as reference-file topics, not sequenced here).

4 / 5

Progressive Disclosure

Excellent one-level-deep structure overall: an overview SKILL.md with a load-order table signaling every reference file by condition, all references/*.md files verified present in the bundle, and the references/traditions/[name].md pattern backed by 34 real tradition files. The gap keeping it from 5: two referenced paths are dangling — 'CLAUDE.md' ("Always (Claude Code)") and 'skills/[command].md' ("When a slash command is invoked") do not exist in the bundle (no CLAUDE.md file, no skills/ directory), yet 18 slash commands are listed whose backing skill files are absent.

4 / 5

Total

16

/

20

Passed

Description

75%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

A strong description with explicit what/when structure and genuinely natural trigger phrases quoted verbatim. Its weaknesses are abstract capability language (the companion 'navigates' and 'draws from' rather than performing named actions) and deliberately broad trigger guidance ('any emotionally charged framing', 'When in doubt, activate') that raises conflict risk. Voice is correctly third person throughout.

Suggestions

Replace abstract capability framing ('wisdom companion for navigating the inner life') with 2-3 concrete named actions, e.g. 'Reflects emotional reality, identifies recurring patterns, and offers one framework (Taoist, Stoic, IFS, DBT) to reframe it' — this would lift specificity from 3 toward 4-5.

Add missing natural trigger phrases users commonly say, such as 'I'm feeling stuck,' 'I'm overwhelmed,' 'I feel lost,' or 'I'm grieving,' to round out trigger term coverage.

Narrow the catch-all triggers: instead of 'any emotionally charged framing' + 'When in doubt, activate,' bound the skill to inner-life topics (emotions, meaning, identity, grief) so emotionally charged but non-therapeutic requests (e.g. frustrated code reviews) don't fire it.

DimensionReasoningScore

Specificity

The description names the domain clearly ("clinically informed wisdom companion for navigating the inner life — emotions, meaning, grief, purpose, relationship, identity") and gives a couple of concrete framings ("think alongside someone who won't rush them toward an answer"), and it lists specific knowledge sources (IFS, DBT, CFT, Schema Therapy, Somatic, Motivational Interviewing). However, the actual actions Satori performs are described only abstractly — "companion for navigating" is not a concrete verb list like the anchor-5 example's "extract text and tables, fill forms, merge documents" — and the enumerated traditions are inputs, not capabilities. It sits at the 'names domain and 1-2 concrete actions, but not comprehensive' level, not below it (the domain is named precisely, unlike 'Processes PDF files') and not at 4 (no list of several specific actions).

3 / 5

Completeness

It explicitly answers both questions: 'what' ("clinically informed wisdom companion for navigating the inner life" with enumerated domains and frameworks) and 'when' with concrete trigger phrases ("Activate when someone is processing something difficult... Also activate when someone uses language like 'I've been struggling with,' 'I don't know what to do'..."). This matches the anchor-5 example structure exactly; neither 'what' nor 'when' is vague or implied.

5 / 5

Trigger Term Quality

It includes excellent natural user phrases — "I've been struggling with," "I don't know what to do," "I need to figure out" — plus situational triggers ("processing something difficult, wrestling with a life question, seeking perspective") and a catch-all ("any emotionally charged framing"). This is well above the 'some relevant keywords but missing common variations' level, but not a 5: common natural variations users actually say — e.g. "I'm feeling stuck," "I'm overwhelmed," "I'm lost," "I'm grieving," "burnout" — are not covered as explicit keywords.

4 / 5

Distinctiveness Conflict Risk

The niche itself is distinct — no technical skill competes for 'navigating the inner life' — but the trigger scope is deliberately maximal: "or any emotionally charged framing" and "When in doubt, activate" mean emotionally toned requests in any other domain (e.g., a frustrated coding session) would match. This is more specific than the anchor-2 'very broad; high overlap risk' example, but the explicit over-trigger guidance keeps it from 4-5 ('minimal conflict risk'), landing at 'somewhat specific but could still overlap.'

3 / 5

Total

15

/

20

Passed

Validation

93%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

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

Warning

Total

15

/

16

Passed

Repository

MetcalfSolutions/Satori_Claude_Code

Path

SKILL.md

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.