instinct-review
FeaturedReviews/promotes/removes instincts from `.claude/instincts/*.md`. Triggers: instinct review, curate instincts, manage instincts, promote instinct.
AI & Automation 161 stars
21 forks Updated yesterday Apache-2.0
Install
Quality Score: 93/100
Stars 20%
Recency 20%
Frontmatter 20%
Documentation 15%
Issue Health 10%
License 10%
Description 5%
Skill Content
# /instinct-review - Manage Learned Instincts
$ARGUMENTS
## What This Does
Manages the instinct system: project-local behavioral notes that Claude loads at the start of a session.
Instincts are markdown files in `.claude/instincts/`, loaded at session start by `session-start.sh` whenever any exist (set `AI_TOOLKIT_HOOK_QUIET=1` to suppress).
## Commands
### List all instincts
```
/instinct-review --list
```
Shows all instincts with confidence scores and source sessions.
### Review and curate
```
/instinct-review
```
Interactive review: shows each instinct and asks promote/remove/keep.
### Promote instinct (always apply)
```
/instinct-review --promote <filename>
```
### Remove instinct
```
/instinct-review --remove <filename>
```
### Clear all instincts
```
/instinct-review --clear
```
## How Instincts Work
1. **Authoring**: Instinct files are written by hand — one markdown file per pattern in `.claude/instincts/`. There is no automatic session-end extractor today (see [When NOT to Use](#when-not-to-use)).
2. **Storage**: `.claude/instincts/<pattern-name>.md`, each carrying a confidence score (see format below).
3. **Loading**: At session start, `session-start.sh` loads every instinct file into context whenever any exist. No instincts on disk means nothing is loaded; set `AI_TOOLKIT_HOOK_QUIET=1` to suppress.
4. **Curation**: Use `/instinct-review` to list, promote, remove, or clear them.
## Instinct Format
```markdown
# Pattern: [pattern name]
Confidence: 0.85
S...
Details
- Author
- softspark
- Repository
- softspark/ai-toolkit
- Created
- 4 months ago
- Last Updated
- yesterday
- Language
- Python
- License
- Apache-2.0
Integrates with
Similar Skills
Semantically similar based on skill content — not just same category
AI & Automation Listed
evolve
Cluster related instincts by trigger family and lexical similarity, identify skill-creation candidates
0 Updated 3 days ago
search-atlas-group AI & Automation Listed
learn-eval
Score existing instincts, execute status transitions, prune stale candidates, write scorecard
0 Updated 3 days ago
search-atlas-group AI & Automation Listed
continuous-learning-v2
Instinct-based learning system that observes sessions via hooks, creates atomic instincts with confidence scoring, and evolves them into skills/commands/agents. v2.1 adds project-scoped instincts to prevent cross-project contamination.
3 Updated today
uzysjung