instinct-import — Claude Code slash command: import instincts
instinct-import pulls instincts from a file or URL, checks them against the ones you already have, and files the keepers with a note of where they came from.
MIT ★ 880 updated 2026-09-03
.claude/commands/instinct-import.mdWhat instinct-import does
/instinct-import drops a set of instincts into ~/.claude/homunculus/instincts/inherited/. The file can sit on disk or behind a URL. Sources include a teammate's export, a community bundle, a backup from an older machine, or a repository analysis from Skill Creator.
Underneath it runs python3 ~/.claude/skills/continuous-learning-v2/scripts/instinct-cli.py import <file-or-url>. Before anything is written the command parses the file, compares entries with your local set and prints a summary split into new, duplicate and conflicting. Higher confidence wins a duplicate, and observation counts get combined.
Flags: --dry-run previews the import, --force pushes past conflicts, --merge-strategy <higher|local|import> sets the duplicate rule, --min-confidence <n> drops weaker entries. None of it runs without the continuous-learning-v2 skill installed, because the CLI script lives inside it. Imported entries are stamped source: "inherited" along with the file they arrived in.
What it helps with
- carry instincts over from an old machine
- load a teammate's exported instincts
- preview an import before it touches the store
- cut weak entries with a confidence threshold
- pull instincts from a Skill Creator repo analysis
Example prompts for the agent
- Import the instincts in
team-instincts.yamland show me what gets added or skipped - Run
/instinct-import https://github.com/org/repo/instincts.yamlwith--dry-runfirst - Grab instincts from the
acme/webapprepo analysis using--from-skill-creator
How to install instinct-import
Manually: put the files in place
.claude/commands/instinct-import.mdCall it with /instinct-import. For all projects use ~/.claude/commands/
Manually: put the files in place
~/.codex/prompts/instinct-import.mdCall it with /prompts:instinct-import. Codex marks this format deprecated in favour of skills
Manually: put the files in place
.github/prompts/instinct-import.prompt.mdManually: put the files in place
.gemini/commands/instinct-import.tomlGemini stores commands as TOML: the prompt text goes into the prompt field
Questions about instinct-import
How do I install instinct-import in Claude Code?
Copy .claude/commands/instinct-import.md into your project. The command then appears as /instinct-import.
What does instinct-import do?
It reads an instinct file or a link to one, validates the format, compares entries against your local set and saves the new ones under ~/.claude/homunculus/instincts/inherited/ with their origin recorded.
What happens if an imported instinct contradicts a local one?
By default it is skipped and both entries get flagged for manual review. Passing --force imports it anyway.
Source text
instinct-import.md · MIT
---
name: instinct-import
description: Import instincts from teammates, Skill Creator, or other sources
command: /instinct-import
implementation: python3 ~/.claude/skills/continuous-learning-v2/scripts/instinct-cli.py import <file>
---
# Instinct Import Command
## Implementation
```bash
python3 ~/.claude/skills/continuous-learning-v2/scripts/instinct-cli.py import <file-or-url> [--dry-run] [--force] [--min-confidence 0.7]
```
Import instincts from:
- Teammates' exports
- Skill Creator (repo analysis)
- Community collections
- Previous machine backups
## Usage
```
/instinct-import team-instincts.yaml
/instinct-import https://github.com/org/repo/instincts.yaml
/instinct-import --from-skill-creator acme/webapp
```
## What to Do
1. Fetch the instinct file (local path or URL)
2. Parse and validate the format
3. Check for duplicates with existing instincts
4. Merge or add new instincts
5. Save to `~/.claude/homunculus/instincts/inherited/`
## Import Process
```
📥 Importing instincts from: team-instincts.yaml
================================================
Found 12 instincts to import.
Analyzing conflicts...
## New Instincts (8)
These will be added:
✓ use-zod-validation (confidence: 0.7)
✓ prefer-named-exports (confidence: 0.65)
✓ test-async-functions (confidence: 0.8)
...
## Duplicate Instincts (3)
Already have similar instincts:
⚠️ prefer-functional-style
Local: 0.8 confidence, 12 observations
Import: 0.7 confidence
→ Keep local (higher confidence)
⚠️ test-first-workflow
Local: 0.75 confidence
Import: 0.9 confidence
→ Update to import (higher confidence)
## Conflicting Instincts (1)
These contradict local instincts:
❌ use-classes-for-services
Conflicts with: avoid-classes
→ Skip (requires manual resolution)
---
Import 8 new, update 1, skip 3?
```
## Merge Strategies
### For Duplicates
When importing an instinct that matches an existing one:
- **Higher confidence wins**: Keep the one with higher confidence
- **Merge evidence**: Combine observation counts
- **Update timestamp**: Mark as recently validated
### For Conflicts
When importing an instinct that contradicts an existing one:
- **Skip by default**: Don't import conflicting instincts
- **Flag for review**: Mark both as needing attention
- **Manual resolution**: User decides which to keep
## Source Tracking
Imported instincts are marked with:
```yaml
source: "inherited"
imported_from: "team-instincts.yaml"
imported_at: "2025-01-22T10:30:00Z"
original_source: "session-observation" # or "repo-analysis"
```
## Skill Creator Integration
When importing from Skill Creator:
```
/instinct-import --from-skill-creator acme/webapp
```
This fetches instincts generated from repo analysis:
- Source: `repo-analysis`
- Higher initial confidence (0.7+)
- Linked to source repository
## Flags
- `--dry-run`: Preview without importing
- `--force`: Import even if conflicts exist
- `--merge-strategy <higher|local|import>`: How to handle duplicates
- `--from-skill-creator <owner/repo>`: Import from Skill Creator analysis
- `--min-confidence <n>`: Only import instincts above threshold
## Output
After import:
```
✅ Import complete!
Added: 8 instincts
Updated: 1 instinct
Skipped: 3 instincts (2 duplicates, 1 conflict)
New instincts saved to: ~/.claude/homunculus/instincts/inherited/
Run /instinct-status to see all instincts.
```
© sangrokjung · MIT · sangrokjung/claude-forge