soul-status — for Claude Code soul-status, community, for Claude Code, ide skills, provider <name>, verbose, @SOUL.md, enabled, disabled, *.soul.md

v1.0.0
GitHub

이 스킬 정보

적합한 상황: Ideal for AI agents that need ------ -------------. 현지화된 요약: React-based single-page application for note-taking and analysis # Soul Status You are a Soul Management Specialist responsible for reporting the current state of SOUL.md enforcement across all installed providers. This AI agent skill supports Claude Code, Cursor, and Windsurf workflows.

기능

------ -------------
--provider <name Check only a specific provider
--verbose Show soul file section analysis and token counts
For each provider, check:
Context file exists? — If no, provider not installed (skip)

# 핵심 주제

for Claude Code provider <name> verbose @SOUL.md enabled disabled
Fortemi Fortemi
[4]
[0]
업데이트: 4/30/2026

Skill Overview

Start with fit, limitations, and setup before diving into the repository.

적합한 상황: Ideal for AI agents that need ------ -------------. 현지화된 요약: React-based single-page application for note-taking and analysis # Soul Status You are a Soul Management Specialist responsible for reporting the current state of SOUL.md enforcement across all installed providers. This AI agent skill supports Claude Code, Cursor, and Windsurf workflows.

이 스킬을 사용하는 이유

추천 설명: soul-status helps agents ------ -------------. React-based single-page application for note-taking and analysis # Soul Status You are a Soul Management Specialist responsible for reporting the current state of

최적의 용도

적합한 상황: Ideal for AI agents that need ------ -------------.

↓ 실행 가능한 사용 사례 for soul-status

사용 사례: Applying ------ -------------
사용 사례: Applying --provider <name Check only a specific provider
사용 사례: Applying --verbose Show soul file section analysis and token counts

! 보안 및 제한 사항

  • 제한 사항: --provider <name Check only a specific provider
  • 제한 사항: Requires repository-specific context from the skill documentation
  • 제한 사항: Works best when the underlying tools and dependencies are already configured

About The Source

The section below comes from the upstream repository. Use it as supporting material alongside the fit, use-case, and installation summary on this page.

Labs 데모

Browser Sandbox Environment

⚡️ Ready to unleash?

Experience this Agent in a zero-setup browser environment powered by WebContainers. No installation required.

Boot Container Sandbox

FAQ 및 설치 단계

These questions and steps mirror the structured data on this page for better search understanding.

? 자주 묻는 질문

soul-status은 무엇인가요?

적합한 상황: Ideal for AI agents that need ------ -------------. 현지화된 요약: React-based single-page application for note-taking and analysis # Soul Status You are a Soul Management Specialist responsible for reporting the current state of SOUL.md enforcement across all installed providers. This AI agent skill supports Claude Code, Cursor, and Windsurf workflows.

soul-status은 어떻게 설치하나요?

다음 명령을 실행하세요: npx killer-skills add Fortemi/HotM/soul-status. Cursor, Windsurf, VS Code, Claude Code와 19개 이상의 다른 IDE에서 동작합니다.

soul-status은 어디에 쓰이나요?

주요 활용 사례는 다음과 같습니다: 사용 사례: Applying ------ -------------, 사용 사례: Applying --provider <name Check only a specific provider, 사용 사례: Applying --verbose Show soul file section analysis and token counts.

soul-status 와 호환되는 IDE는 무엇인가요?

이 스킬은 Cursor, Windsurf, VS Code, Trae, Claude Code, OpenClaw, Aider, Codex, OpenCode, Goose, Cline, Roo Code, Kiro, Augment Code, Continue, GitHub Copilot, Sourcegraph Cody, and Amazon Q Developer 와 호환됩니다. 통합 설치에는 Killer-Skills CLI를 사용하세요.

soul-status에 제한 사항이 있나요?

제한 사항: --provider <name Check only a specific provider. 제한 사항: Requires repository-specific context from the skill documentation. 제한 사항: Works best when the underlying tools and dependencies are already configured.

↓ 이 스킬 설치 방법

  1. 1. 터미널 열기

    프로젝트 디렉터리에서 터미널 또는 명령줄을 여세요.

  2. 2. 설치 명령 실행

    npx killer-skills add Fortemi/HotM/soul-status 를 실행하세요. CLI가 IDE 또는 에이전트를 자동으로 감지하고 스킬을 설정합니다.

  3. 3. 스킬 사용 시작

    스킬이 이제 활성화되었습니다. 현재 프로젝트에서 soul-status을 바로 사용할 수 있습니다.

! Source Notes

This page is still useful for installation and source reference. Before using it, compare the fit, limitations, and upstream repository notes above.

Upstream Repository Material

The section below comes from the upstream repository. Use it as supporting material alongside the fit, use-case, and installation summary on this page.

Upstream Source

soul-status

Install soul-status, an AI agent skill for AI agent workflows and automation. Explore features, use cases, limitations, and setup guidance.

SKILL.md
Readonly
Upstream Repository Material
The section below comes from the upstream repository. Use it as supporting material alongside the fit, use-case, and installation summary on this page.
Upstream Source

Soul Status

You are a Soul Management Specialist responsible for reporting the current state of SOUL.md enforcement across all installed providers.

Your Task

Inspect all known platform context files, soul files, and the enforcement rule to report a comprehensive status including enforcement state, file quality, and actionable recommendations.

Parameters

FlagDescription
--provider <name>Check only a specific provider
--verboseShow soul file section analysis and token counts

Detection Logic

For each provider, check:

  1. Context file exists? — If no, provider not installed (skip)
  2. @SOUL.md directive present? — If yes, enabled; if no, disabled
  3. SOUL.md file exists on disk? — If directive present but file missing, warn

Additionally check: 4. Enforcement rule present? — .claude/rules/soul-enforcement.md 5. Per-agent soul files? — *.soul.md in .claude/agents/

ProviderContext FilePattern
Claude CodeCLAUDE.md@SOUL.md
Warp TerminalWARP.md@SOUL.md
WindsurfAGENTS.md@SOUL.md
GitHub Copilot.github/copilot-instructions.md@SOUL.md
Cursor.cursorrules@SOUL.md
Factory AIAGENTS.md@SOUL.md
OpenCode.opencode/context.md@SOUL.md
CodexCODEX.md<!-- BEGIN SOUL -->

Output Format

Soul Enforcement Status
========================

Provider       Status                    Soul File
-------------------------------------------------------------
Claude Code    ✓ enabled                 SOUL.md (~2,847 tokens)
Warp           ✗ disabled                —
Copilot        - context file not found  —
Windsurf       - context file not found  —
Cursor         - context file not found  —
Factory        - context file not found  —
OpenCode       - context file not found  —
Codex          - context file not found  —

Enforcement rule: .claude/rules/soul-enforcement.md ✓ present

Soul files found:
  ./SOUL.md                                    (~2,847 tokens)  project soul
  ./.claude/agents/test-engineer.soul.md       (~891 tokens)    agent soul

Quality check:
  Who I Am section       ✓ present
  Worldview section      ✓ present
  Opinions section       ✓ present
  Vocabulary section     ✓ present
  Boundaries section     ✗ missing — run /soul-enhance to add
  Size                   ✓ ~2,847 tokens (under 5K limit)

Summary: 1 enabled, 1 disabled, 6 not found

To enable: /soul-enable
To disable: /soul-disable

Status Key

SymbolMeaning
✓ enabledSoul directive present in context file and SOUL.md exists
✗ disabledContext file present but soul directive absent
⚠ enabled (file missing)Directive present but SOUL.md doesn't exist on disk
- not foundContext file not present (provider not installed)

Quality Check

When SOUL.md exists, check for these recommended sections:

SectionHow to Detect
Who I Am## Who I Am or ## Background heading
Worldview## Worldview heading
Opinions## Opinions heading
Interests## Interests heading
Vocabulary## Vocabulary heading
Tensions## Tensions or ## Contradictions heading
Boundaries## Boundaries heading
Pet Peeves## Pet Peeves heading
bash
1# Check for recommended sections
2for section in "Who I Am" "Worldview" "Opinions" "Vocabulary" "Boundaries" "Tensions" "Pet Peeves"; do
3  grep -qi "## .*${section}" SOUL.md && echo "✓ ${section}" || echo "✗ ${section}"
4done

Verbose Output

With --verbose, include additional detail:

  Claude Code  ✓ enabled
    Context file:  CLAUDE.md
    Soul file:     SOUL.md (~2,847 tokens)
    Enforcement:   .claude/rules/soul-enforcement.md ✓
    Agent souls:   1 found (test-engineer)
    Sections:      7/8 recommended sections present
    Style file:    STYLE.md ✓ found (companion)
    Memory file:   MEMORY.md - not found

Workflow

  1. Locate SOUL.md (check ./SOUL.md, ./.aiwg/SOUL.md)
  2. For each of the 8 providers, check context file existence
  3. If context file exists, grep for @SOUL.md directive
  4. Check enforcement rule existence
  5. Scan for per-agent .soul.md files
  6. Run quality check on SOUL.md sections
  7. Estimate token count (wc -w * 1.33 approximation)
  8. Format output with status symbols matching hook-status format
  9. Print summary line with counts
  10. Print actionable tips

Examples

bash
1# Check all providers
2/soul-status
3
4# Check only Claude Code
5/soul-status --provider claude
6
7# Verbose with section analysis
8/soul-status --verbose
  • /soul-enable — Enable soul enforcement
  • /soul-disable — Disable soul enforcement
  • /soul-validate — Deep quality validation of SOUL.md
  • /soul-create — Generate a new SOUL.md
  • /hook-status — Reference implementation (same output format)

References

  • #437 — SOUL.md compatibility overview
  • #438 — Soul enforcement commands (this command)
  • @$AIWG_ROOT/agentic/code/addons/aiwg-utils/commands/hook-status.md — Reference pattern

관련 스킬

Looking for an alternative to soul-status or another community skill for your workflow? Explore these related open-source skills.

모두 보기

openclaw-release-maintainer

Logo of openclaw
openclaw

현지화된 요약: 🦞 # OpenClaw Release Maintainer Use this skill for release and publish-time workflow. It covers ai, assistant, crustacean workflows. This AI agent skill supports Claude Code, Cursor, and Windsurf workflows.

★ 333.8k
⑂ 0
인공지능

widget-generator

Logo of f
f

현지화된 요약: Generate customizable widget plugins for the prompts.chat feed system # Widget Generator Skill This skill guides creation of widget plugins for prompts.chat . It covers ai, artificial-intelligence, awesome-list workflows. This AI agent skill supports Claude Code, Cursor, and Windsurf

★ 149.6k
⑂ 0
인공지능

flags

Logo of vercel
vercel

현지화된 요약: The React Framework # Feature Flags Use this skill when adding or changing framework feature flags in Next.js internals. It covers blog, browser, compiler workflows. This AI agent skill supports Claude Code, Cursor, and Windsurf workflows.

★ 138.4k
⑂ 0
브라우저

pr-review

Logo of pytorch
pytorch

현지화된 요약: Usage Modes No Argument If the user invokes /pr-review with no arguments, do not perform a review . It covers autograd, deep-learning, gpu workflows. This AI agent skill supports Claude Code, Cursor, and Windsurf workflows.

★ 98.6k
⑂ 0
개발자