Instinct Status
Show learned instincts (project + global) with confidence
- Type
- Slash Command
- Repository
- affaan-m/ECC
- GitHub stars
- 268k
- License
- MIT
- Repo last updated
- Sep 24, 2026
- Source file
- commands/instinct-status.md
What Instinct Status is
Instinct Status is a slash command published in the affaan-m/ECC repository on GitHub, which has about 268k stars. The repository describes itself as: “The agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.”
A slash command is a reusable prompt saved as a markdown file and run by typing its name after a slash. In Claude Code, custom commands have been merged into skills: a file in .claude/commands/ and a skill folder in .claude/skills/ both create the same kind of command, and existing command files keep working.
Instinct Status gives you a repeatable way to run the same instructions without retyping them, optionally with arguments.
How to install Instinct Status
Claude Code
- Download instinct-status.md from the repository.
- Save it to ~/.claude/commands/ (all projects) or .claude/commands/ (one project). As a skill, you can instead save it as ~/.claude/skills/<name>/SKILL.md.
- Run it by typing / followed by its name.
Claude Cowork
- Turn the command into a skill: create a folder with the file saved as SKILL.md and zip it.
- In Customize → Skills, click +, then upload the ZIP.
- Run it from any task with / and the skill name.
New to extending Cowork? Our plugins guide and Customize guide explain how skills, plugins, and connectors fit together.
Inside the source file
An excerpt from commands/instinct-status.md, shared under the repository's MIT license. Read the full file on GitHub.
Shows learned instincts for the current project plus global instincts, grouped by domain.
Implementation
Run the instinct CLI, resolving the active ECC plugin root the same way hooks/hooks.json and the other slash commands (/sessions, /skill-health) do — env var → standard install → known plugin roots → plugin cache → fallback. This avoids the divergence that happens when CLAUDE_PLUGIN_ROOT is unset while a legacy ~/.claude/skills/continuous-learning-v2/ directory still exists (#2037).
ECC_ROOT="${CLAUDE_PLUGIN_ROOT:-$(node -e "var r=(function(){var p=require('path'),f=require('fs'),o=require('os');var e=process.env.CLAUDE_PLUGIN_ROOT;if(e&&e.trim())return e.trim();var d=p.join(o.homedir(),'.claude');function L(x){try{return require(p.join(x,'scripts','lib','resolve-ecc-root')).resolveEccRoot()}catch(_){return null}}var r=L(d);if(r)return r;var s=['ecc','ecc@ecc','marketplaces/ecc','everything-claude-code','everything-claude-code@everything-claude-code','marketplaces/everything-claude-code'];for(var i=0;i<s.length;i++){r=L(p.join(d,'plugins',s[i]));if(r)return r}try{var g=['ecc','everything-claude-code'];for(var j=0;j<g.length;j++){var c=p.join(d,'plugins','cache',g[j]);var O=f.readdirSync(c);for(var k=0;k<O.length;k++){var q=p.join(c,O[k]);var V=f.readdirSync(q);for(var m=0;m<V.length;m++){r=L(p.join(q,V[m]));if(r)return r}}}}catch(_){}return d})();console.log(r)")}"
python3 "$ECC_ROOT/skills/continuous-learning-v2/scripts/instinct-cli.py" statusUsage
/instinct-statusWhat to Do
- Detect current project context (git remote/path hash)
- Read project instincts from ~/.claude/homunculus/projects/ /instincts/
- Read global instincts from ~/.claude/homunculus/instincts/
- Merge with precedence rules (project overrides global when IDs collide)
- Display grouped by domain with confidence bars and observation stats
Output Format
============================================================
INSTINCT STATUS - 12 total
============================================================
Project: my-app (a1b2c3d4e5f6)
Project instincts: 8
Global instincts: 4
## PROJECT-SCOPED (my-app)
### WORKFLOW (3)
███████░░░ 70% grep-before-edit [project]
trigger: when modifying code
## GLOBAL (apply to all projects)
### SECURITY (2)
█████████░ 85% validate-user-input [global]
trigger: when handling user input Before you install
- Read the whole file first. Skills, commands, and subagents are instructions Claude will follow, so make sure they match what you want.
- Check which tools, scripts, or MCP servers it uses. Local servers and scripts run with your permissions.
- Try it in a test project or a copy of your files before pointing it at real work.
- Pin the version you tested, and review changes before updating.
- Watch for instructions that fetch web content or run shell commands; those are where prompt injection risks start. See our prompt injection guide.
FAQ
What is Instinct Status?
Instinct Status is a slash command for Claude Code and Claude Cowork from the affaan-m/ECC repository on GitHub. Show learned instincts (project + global) with confidence
How do I install Instinct Status in Claude Code?
Download instinct-status.md from the repository. Save it to ~/.claude/commands/ (all projects) or .claude/commands/ (one project). As a skill, you can instead save it as ~/.claude/skills/<name>/SKILL.md. Run it by typing / followed by its name.
Can I use Instinct Status in Claude Cowork?
Turn the command into a skill: create a folder with the file saved as SKILL.md and zip it. In Customize → Skills, click +, then upload the ZIP. Run it from any task with / and the skill name.
Is Instinct Status safe to install?
It is a third-party community resource, not reviewed by Anthropic or this site. Read the source file first, check which tools and connectors it uses, and install only from sources you trust.
Similar resources
- React Reviewer Expert React/JSX code reviewer specializing in hook correctness, render performance, server/client component boundaries, accessibility, and React-specific security. Use for any change touching .tsx/.jsx files or React component logic. MUST BE USED for React projects. Subagent · affaan-m/ECC
- Rust Build Resolver Rust build, compilation, and dependency error resolution specialist. Fixes cargo build errors, borrow checker issues, and Cargo.toml problems with minimal changes. Use when Rust builds fail. Subagent · affaan-m/ECC
- Refactor Cleaner Dead code cleanup and consolidation specialist. Use PROACTIVELY for removing unused code, duplicates, and refactoring. Runs analysis tools (knip, depcheck, ts-prune) to identify dead code and safely removes it. Subagent · affaan-m/ECC
- Rust Reviewer Expert Rust code reviewer specializing in ownership, lifetimes, error handling, unsafe usage, and idiomatic patterns. Use for all Rust code changes. MUST BE USED for Rust projects. Subagent · affaan-m/ECC
- Projects List known projects and their instinct statistics Slash Command · affaan-m/ECC
- Instinct Import Import instincts from file or URL into project/global scope Slash Command · affaan-m/ECC
- Promote Promote project-scoped instincts to global scope Slash Command · affaan-m/ECC
- Instinct Export Export instincts from project/global scope to a file Slash Command · affaan-m/ECC