jmagly/soul-status
agentic/code/addons/aiwg-utils/skills/soul-status/SKILL.md
Show SOUL.md enforcement state across all installed providers with quality check
$ install --global
skillsauthnpx skillsauth add jmagly/aiwg soul-statusInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: May 5, 2026, 4:41 AM197.6s1 file scanned
SKILL.md
- namespace:
- aiwg
- name:
- soul-status
- platforms:
- [all]
- description:
- Show SOUL.md enforcement state across all installed providers with quality check
- argumentHint:
- [--provider <name>] [--verbose]
- allowedTools:
- Read, Bash, Glob
- model:
- sonnet
- category:
- soul-management
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
| Flag | Description |
|------|-------------|
| --provider <name> | Check only a specific provider |
| --verbose | Show soul file section analysis and token counts |
Detection Logic
For each provider, check:
- Context file exists? — If no, provider not installed (skip)
@SOUL.mddirective present? — If yes,enabled; if no,disabled- 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/
Directive Patterns to Search
| Provider | Context File | Pattern |
|----------|-------------|---------|
| Claude Code | CLAUDE.md | @SOUL.md |
| Warp Terminal | WARP.md | @SOUL.md |
| Windsurf | AGENTS.md | @SOUL.md |
| GitHub Copilot | .github/copilot-instructions.md | @SOUL.md |
| Cursor | .cursorrules | @SOUL.md |
| Factory AI | AGENTS.md | @SOUL.md |
| OpenCode | .opencode/context.md | @SOUL.md |
| Codex | CODEX.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
| Symbol | Meaning |
|--------|---------|
| ✓ enabled | Soul directive present in context file and SOUL.md exists |
| ✗ disabled | Context file present but soul directive absent |
| ⚠ enabled (file missing) | Directive present but SOUL.md doesn't exist on disk |
| - not found | Context file not present (provider not installed) |
Quality Check
When SOUL.md exists, check for these recommended sections:
| Section | How 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 |
# Check for recommended sections
for section in "Who I Am" "Worldview" "Opinions" "Vocabulary" "Boundaries" "Tensions" "Pet Peeves"; do
grep -qi "## .*${section}" SOUL.md && echo "✓ ${section}" || echo "✗ ${section}"
done
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
- Locate SOUL.md (check
./SOUL.md,./.aiwg/SOUL.md) - For each of the 8 providers, check context file existence
- If context file exists, grep for
@SOUL.mddirective - Check enforcement rule existence
- Scan for per-agent
.soul.mdfiles - Run quality check on SOUL.md sections
- Estimate token count (
wc -w* 1.33 approximation) - Format output with status symbols matching hook-status format
- Print summary line with counts
- Print actionable tips
Examples
# Check all providers
/soul-status
# Check only Claude Code
/soul-status --provider claude
# Verbose with section analysis
/soul-status --verbose
Related Commands
/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
Related Skills
jmagly/radar-status
data-ai
VerifiedTrustedCommunity
Report which research-corpus radar sidecars are overdue for refresh. Computes staleness (days since last refresh vs the cadence window) for every radar, sorted most-overdue-first. Runs via `aiwg corpus radar-status`.
140SKILL.mdUpdated May 28, 2026
jmagly/radar-report
data-ai
VerifiedTrustedCommunity
Aggregate research-corpus radar sidecars into a corpus or per-cluster freshness report — totals, overdue count, per-cluster / per-GRADE / per-trajectory breakdowns, an overdue table, and per-radar rationale snippets. Runs via `aiwg corpus radar-report`.
140SKILL.mdUpdated May 28, 2026
jmagly/radar-init
testing
VerifiedTrustedCommunity
Scaffold radar/freshness sidecars for research-corpus REFs. Pulls title/authors from the citation sidecar and GRADE from the analysis doc, defaults the refresh cadence from GRADE and the cluster from a corpus-local map, and stamps documentation/radar/REF-XXX-radar.md. Runs via `aiwg corpus radar-init`.
140SKILL.mdUpdated May 28, 2026
jmagly/profile-temporal
data-ai
VerifiedTrustedCommunity
Compute an entity's publication trajectory — per-year paper counts, topic drift, hot-streak detection (≥3 consecutive A-grade years), and career phase. Runs via `aiwg corpus profile-temporal`.
140SKILL.mdUpdated May 28, 2026