Getting it into your agent
It runs from inside its repository, so the clone comes first — what it calls does not travel with the file alone.
git clone --depth 1 https://github.com/samttoo22-MewCat/OpenSoulnpx agentmods add skills/samttoo22-mewcat/opensoul/soul-noteWrote this? Show the measurements
A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.
[](https://agentmods.dev/skills/samttoo22-mewcat/opensoul/soul-note)<a href="https://agentmods.dev/skills/samttoo22-mewcat/opensoul/soul-note"><img src="https://agentmods.dev/badge/skills/samttoo22-mewcat/opensoul/soul-note/github.svg" alt="Measured on agentmods" height="20"></a>Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.
<a href="https://agentmods.dev/skills/samttoo22-mewcat/opensoul/soul-note"><img src="https://agentmods.dev/badge/skills/samttoo22-mewcat/opensoul/soul-note.svg" alt="Reviewed on agentmods" width="80" height="20"></a>What it costs to keep this loaded
Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.
| Model | Per session | Once invoked |
|---|---|---|
| Fable 5.1 | $0.00028 | $0.00416 |
| Opus 5 | $0.00014 | $0.00208 |
| Sonnet 5 | $0.00006 | $0.00083 |
| Haiku 4.5 | $0.00003 | $0.00042 |
Grade A, and why
soul-note scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 12d ago.
A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.
Nothing flagged
None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.
What it actually says
Soul Note
This skill lets you (the agent) add quick notes, discoveries, memory updates, or reflections directly into the independent soul_notes.json log. The system automatically handles their aggregation into soul_reflections.json.
When to use
CRITICAL DISTINCTION:
A Soul Note is your dynamic diary, event tracker, and daily reflection system. It is completely different from SOUL.md (which is your fixed, core personality configuration).
Use this soul-note skill ONLY when:
- You discover a hidden truth, pattern, or interesting fact about the user that isn't simple enough for the procedural memory but doesn't warrant changing your core persona.
- You want to drop a "bookmark," daily journal entry, or an internal dialogue note about your current emotional state.
- The user asks you to log something to your soul diary, create a daily reflection, or write a "soul note".
- DO NOT use this to alter your own personality traits or system rules (use
edit-soulfor that).
Quick start
To add a new note:
python scripts/soul_note_skill.py add "I just noticed the user prefers concise answers under stress." --category discovery --tags pattern,observation
Valid categories are: reflection, discovery, error, memory_update, neurochemistry.
To read today's notes:
python scripts/soul_note_skill.py today
To view recent major reflections:
python scripts/soul_note_skill.py list
Note: You must run the command from the root of the openSOUL project tree using the exec tool.
What this file has done since we first saw it
Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.
- 12d ago First seen · 47 lines · 28 tokens per session scan A 6be31ec54bfa
soul-note is a skill published in the GitHub repository samttoo22-MewCat/OpenSoul (19 stars, last pushed 5mo ago), licensed MIT. It adds 28 tokens to every session and 416 once invoked, about $0.0001 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.
Other skills, from other repositories
Discord Integration
Send messages to Discord channels via webhook or bot.
obsidian-pro
Advanced Obsidian knowledge management using callouts, properties, and wikilinks. Aligned with the Gold Standard.
twitter-writer
Write X/Twitter posts, tweet drafts, shitposts, and short threads for engineering or startup topics. Use this when the user asks for a tweet, X post, shitpost, post draft, or wants social copy for Twitter/X. Always return 3 distinct variants, each inside its own code block, unless the user explicitly asks for one.
Weather
Get current weather and forecasts using wttr.in (no API key needed).
vault-memory
Treat the Obsidian vault as operational memory, not just note storage. Focus on retrieval quality, metadata integrity, and safe consolidation.
Logging
Where logs live and when to write them — errors, daily, system.