instinct-apply
Surfaces relevant instincts during work. Use when starting a task to check if any learned behaviors apply.
How do I install this agent skill?
npx skills add https://github.com/humanplane/homunculus --skill instinct-applyIs this agent skill safe to install?
- Gen Agent Trust Hubpass
This skill reads local markdown files containing 'instincts' or behavioral instructions and presents them to the AI agent. While functional, it possesses a surface area for indirect prompt injection as it processes unvalidated content from the filesystem without explicit boundary markers.
- Socketpass
No alerts
- Snykpass
Risk: LOW · No issues
- Runlayerpass
1 file scanned · No issues
- ZeroLeakspass
Score: 93/100 · 2 sections analyzed
What does this agent skill do?
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
When an instinct fires but the action feels wrong for the situation:
- Don't apply it blindly
- Note the mismatch
- This is useful data for the observer
Instincts can be wrong. They're learned from patterns, and patterns have exceptions.
Lightweight Application
Don't read all instincts for every action. Keep relevant ones in working memory.
Quick domain check:
- Writing code? → Check
code-styleinstincts - Running tests? → Check
testinginstincts - Making commits? → Check
gitinstincts - Debugging? → Check
debugginginstincts
Be efficient. Instincts are meant to help, not slow down.
How can the creator link this skill?
Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.
<a href="https://skillzs.dev/skills/humanplane/homunculus/instinct-apply">View instinct-apply on skillZs</a>