humanplane avatar

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-code

Installs 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

  1. Read the task/context
  2. Check instinct triggers
  3. If trigger matches, follow the action
  4. 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

More from humanplane/homunculus

All 2

Recommended

1juliusbrussee avatarcavemanjuliusbrussee/cavemanUltra-compressed communication mode. Cuts output tokens 65% (measured) by speaking like caveman while keeping full technical accuracy. Supports intensity levels618.3Kskills.sh installs
2mattpocock avatargrill-memattpocock/skillsA relentless interview to sharpen a plan or design.1.5Mskills.sh installs
3shadcn avatarimproveshadcn/improveSurvey any codebase as a senior advisor and produce prioritized, self-contained implementation plans for OTHER models/agents to execute. Strictly read-only on s40Kskills.sh installs
4obra avatarsystematic-debuggingobra/superpowersUse when encountering any bug, test failure, or unexpected behavior, before proposing fixes326.7Kskills.sh installs
5forrestchang avatarkarpathy-guidelinesforrestchang/andrej-karpathy-skillsBehavioral guidelines to reduce common LLM coding mistakes through explicit assumptions, simplicity, and verifiable success criteria.17.9Kskills.sh installs
6vercel-labs avatarfind-skillsvercel-labs/skillsHelps users discover and install agent skills when they ask questions like "how do I do X", "find a skill for X", "is there a skill that can...", or express int4.3Mskills.sh installs