soul-edit

soul-edit is a skill for Claude Code, Codex from samttoo22-MewCat/OpenSoul. It costs 31 tokens per session (392 once invoked), scanned A, original, MIT.

A careful editor for the SOUL.md file, which stores an agent’s personality instructions. It changes only the selected text unless you explicitly choose to replace the whole file.

In plain words
What is it for?
Use it to read SOUL.md, replace a specific passage, add text at the end, or replace the entire file when that is intentional.
Why use it?
It reduces the risk of accidentally overwriting other personality settings. It also checks that the text to replace appears exactly once.

Skill for Claude CodeCodex

Written for no agent in particular: nothing here depends on one.

Not installable: its command points at a path on the author’s own machine, so it runs nowhere else. The line is /Users/mac/Desktop/coding/py/OpenSoul/OpenSoul.

Good fit Use it to read SOUL.md, replace a specific passage, add text at the end, or replace the entire file when that is intentional.

Compare 6 skills from other repositories ↓
Install

Getting it into your agent

There is no command for this one: it runs only inside a plugin, and the catalogue could not identify which plugin ships it. The source is linked below.

Made for: Claude Code, Codex.

Wrote 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.

agentmods badge for soul-edit

README.md
[![agentmods](https://agentmods.dev/badge/skills/samttoo22-mewcat/opensoul/soul-edit/github.svg)](https://agentmods.dev/skills/samttoo22-mewcat/opensoul/soul-edit)
Your own site
<a href="https://agentmods.dev/skills/samttoo22-mewcat/opensoul/soul-edit"><img src="https://agentmods.dev/badge/skills/samttoo22-mewcat/opensoul/soul-edit/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.

agentmods 80×15 button for soul-edit

Your own site · 80×15
<a href="https://agentmods.dev/skills/samttoo22-mewcat/opensoul/soul-edit"><img src="https://agentmods.dev/badge/skills/samttoo22-mewcat/opensoul/soul-edit.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 31 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 392 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe.
Origin original No closer match found in the catalogue.
Token cost

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.

ModelPer sessionOnce invoked
Fable 5.1 $0.00031 $0.00392
Opus 5 $0.00015 $0.00196
Sonnet 5 $0.00006 $0.00078
Haiku 4.5 $0.00003 $0.00039

Measured 11d ago against content hash e38f35884dea, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-11, from the pricing page.

Security

Grade A, and why

soul-edit 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 11d 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.

local_skills/soul-edit/SKILL.md · 48 lines

What it actually says

編輯 SOUL.md(Diff 模式)

優先使用 diff 指令——只替換指定的舊文字片段,不重寫整個檔案。

Diff 模式(精確修改,推薦)

cd /Users/mac/Desktop/coding/py/OpenSoul/OpenSoul
python scripts/edit_soul_skill.py --command diff \
  --old "要被替換的舊文字(需與 SOUL.md 完全一致)" \
  --new "替換後的新文字"

注意事項:

  • --old 必須與 SOUL.md 現有內容完全一致(含空白、換行符)
  • --old 在檔案中必須唯一,若不唯一請提供更多上下文
  • 修改前先執行 read 確認當前內容

讀取當前內容

python scripts/edit_soul_skill.py --command read

Append 模式(在末尾新增)

python scripts/edit_soul_skill.py --command append --text "新增的內容"

Replace 模式(整體替換,謹慎使用)

python scripts/edit_soul_skill.py --command replace --text "完整的新內容"

使用流程

  1. read 確認當前 SOUL.md 內容
  2. 找出要修改的精確片段
  3. diff 指令替換,提供完整的 --old--new
  4. 再次 read 確認修改結果
Changes

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.

  1. 11d ago First seen · 48 lines · 31 tokens per session scan A e38f35884dea

Subscribe to this mod's changes

soul-edit is a skill published in the GitHub repository samttoo22-MewCat/OpenSoul (19 stars, last pushed 5mo ago), licensed MIT. It adds 31 tokens to every session and 392 once invoked, about $0.0002 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.