
Instinct Apply
This lets Claude check learned behaviors stored in your project's instinct files before starting work. Run it when you're about to code, test, or commit to surface relevant patterns you've captured, like "always run linters before push" or "prefer integration tests for API routes". Each instinct has a trigger, confidence level, and domain tag so you can quickly filter what matters. The confidence scores (0.3 to 0.9+) tell you how strongly to weight each one. It's basically a way to build up project-specific muscle memory without hardcoding rules everywhere. The bash loops read from `.claude/homunculus/instincts/` and dump everything matching your current context.
- skills.sh installs
- 224
- GitHub stars
- 398
- last updated
- Aug 21, 2026
Install
$ npx -y skills add humanplane/homunculus --skill instinct-apply --agent claude-codeInstalls into .claude/skills of the current project.
Files
Instinct Apply
You have learned behaviors. Use them.
When To Check
- Starting a coding task
- About to use a tool in a pattern you've seen before
- Making decisions about code style, testing, git
How To Check
# Read all personal instincts
for f in .claude/homunculus/instincts/personal/*.md; do
[ -f "$f" ] && echo "=== $(basename "$f") ===" && cat "$f" && echo
done 2>/dev/null
# Also check inherited instincts
for f in .claude/homunculus/instincts/inherited/*.md; do
[ -f "$f" ] && echo "=== $(basename "$f") ===" && cat "$f" && echo
done 2>/dev/null
How To Apply
- Read the task/context
- Check instinct triggers
- If trigger matches, follow the action
- Note confidence level - higher confidence = more certain
Instinct Structure
---
trigger: "when [condition]"
confidence: 0.7
domain: "code-style"
---
# Name
## Action
What to do
## Evidence
Why this exists
Confidence Interpretation
- 0.3-0.5: Tentative. Apply if it feels right.
- 0.5-0.7: Moderate. Apply unless there's a reason not to.
- 0.7-0.9: Strong. Apply consistently.
- 0.9+: Near certain. Always apply.
If Instinct Seems Wrong
Sponsors
Details
- Repository
- github.com/humanplane/homunculus
- First seen
- Jun 3, 2026