alekspetrov/navigator/nav-profile
Claude Code and agent skill by alekspetrov/navigator
- community
Checking that the SKILL.md file is still in the repository.
Manage user preferences and corrections for bilateral modeling. Auto-learns from session corrections. Use when user says "save my preferences", "remember I like...", or auto-triggers after corrections.
Install
npx vskill@latest install alekspetrov/navigator/nav-profileSKILL.md
Navigator Profile Skill
Manage user preferences for bilateral modeling - enabling Claude to understand and adapt to your working style, technical preferences, and past corrections.
Why This Exists (Theory of Mind)
Based on Riedl & Weidmann 2025 research on Human-AI Synergy:
- Theory of Mind (ToM) is the key differentiator in human-AI collaboration success
- Users with higher ToM achieve 23-29% performance boost
- Bilateral modeling completes the ToM loop: Claude models you, you model Claude
This skill enables Claude to:
- Remember your preferences across sessions
- Learn from corrections without you repeating them
- Adapt communication style to your level
- Build a persistent mental model of YOU
When to Invoke
Auto-invoke when:
- User says "save my preferences", "remember I like..."
- User says "update my profile", "change my preference for..."
- After detecting a correction pattern (auto-learn mode)
- User says "show my profile", "what do you know about me?"
DO NOT invoke if:
- User is creating a context marker (use nav-marker)
- User wants session-specific preferences only
- User explicitly says "just for this session"
Profile Location
.agent/.user-profile.json (git-ignored, session-persistent)
Execution Steps
Step 1: Determine Action
SHOW (viewing profile):
UPDATE (explicit preference):
LEARN (auto-detect correction):
RESET (clear profile):
Step 2: Load or Initialize Profile
Check if profile exists:
Initialize new profile (if not exists):
Step 3A: Show Profile (If SHOW Action)
Display current profile:
Step 3B: Update Profile (If UPDATE Action)
Parse preference from user input:
Map common expressions to profile fields:
| User Says | Category | Field | Value | |
|---|---|---|---|---|
| "concise", "brief", "short" | communication | verbosity | concise | |
| "detailed", "thorough" | communication | verbosity | detailed | |
| "always confirm" | communication | confirmation_threshold | always | |
| "skip confirmations" | communication | confirmation_threshold | never | |
| "functional style" | technical | code_style | functional | |
| "OOP style" | technical | code_style | oop | |
| "prefer React" | technical | preferred_frameworks | [append "react"] | |
| "prefer Express" | technical | preferred_frameworks | [append "express"] |
Update and save:
Confirm update:
Step 3C: Auto-Learn Correction (If LEARN Action) [AUTO-TRIGGER]
IMPORTANT: This action triggers automatically - no explicit skill invocation needed.
When to detect corrections (monitor ALL conversations):
- User says "No, I meant...", "Actually...", "Not X, use Y"
- User repeats a correction they gave before
- User shows frustration at repeated mistake
Trigger patterns to watch for:
When detected:
Extract correction pattern:
Add to corrections list:
Silently acknowledge (don't interrupt flow):
Sync to Knowledge Graph (if enabled in config):
This creates a pitfall/pattern/learning memory in the knowledge graph, making the correction available via "What do we know about X?" queries.
Periodically surface learnings (every 5 corrections):
Step 3D: Reset Profile (If RESET Action)
Confirm before delete:
If confirmed:
Confirm deletion:
Step 4: Update Goals (Optional)
If user mentions a goal:
Goal structure:
Goal cleanup (auto-archive goals not mentioned in 7 days):
Step 5: Confirm Action
For explicit actions (SHOW, UPDATE, RESET): Show confirmation message.
For auto-learn (LEARN): Silent acknowledgment, periodic summaries.
Profile Schema Reference
Integration with Other Skills
nav-start (Session Start)
Loads profile automatically:
nav-marker (Context Markers)
Preserves profile reference:
All ToM Checkpoints
Respect profile settings:
Auto-Learn Triggers
Correction patterns to detect:
| User Pattern | Extracted Learning | |
|---|---|---|
| "No, I meant..." | Direct correction | |
| "Actually, prefer..." | Preference correction | |
| "Not X, use Y" | Substitution correction | |
| "Always do X" | Rule establishment | |
| "Never do Y" | Anti-pattern | |
| "I like when you..." | Positive preference | |
| "Stop doing X" | Negative preference |
Confidence scoring:
- High: Explicit correction with reasoning
- Medium: Correction without explanation
- Low: Implicit preference from behavior
Privacy & Data
Profile is:
- Git-ignored (
.agent/.user-profile.json) - Local only (not synced)
- User-controlled (can delete anytime)
- Session-persistent (survives context clears)
Profile does NOT store:
- Code snippets
- File contents
- Conversation history
- Sensitive data
Success Criteria
Profile management succeeds when:
- [ ] Profile loads at session start
- [ ] Preferences affect behavior (verbosity, confirmations)
- [ ] Corrections persist across sessions
- [ ] Auto-learn captures patterns silently
- [ ] Goals track user's current focus
- [ ] Reset cleanly removes all data
Best Practices
Good profile usage:
- "Remember I prefer concise explanations" (clear preference)
- "Save that I use functional components" (specific)
- "Show my profile" (verify what's stored)
This is the start of the file. Read the full SKILL.md on GitHub.
Security
- Security scanPassed, 100 of 100Pattern checks on the skill's files.
- Model reviewPassed
Quality evaluation
- Task evaluationPassed, 90 of 100Effective. 1 run. Evaluated 8 months ago.
Source
- SKILL.md in the repositoryCheckingskills/nav-profile/SKILL.md
Popularity
- Repository stars
- 161
- Repository forks
- 8
- 7-day trend score
- 25
Stars and forks are for the whole GitHub repository, not this skill alone. Refreshed 31 Mar 2026, 7 months ago.
Works with
Any agent vskill installs to: 56 targets in all. These 39 have a page on this site.
- Claude Code
- Cursor
- GitHub Copilot
- Windsurf
- Codex
- Gemini CLI
- Cline
- Amp
- Roo Code
- Goose
- Continue
- Kilo Code
- Junie
- Trae
- OpenHands
- Qwen Code
- AI Agent
- Tabnine Chat
- Sourcegraph Cody
- Amazon Q
- Firebase Genkit
- Sweep
- Devin
- Phind
- Mentat
- Claude Desktop
- Aider
- GPT Pilot
- Plandex
- bolt.new
- v0
- Replit Agent
- Anse
- TypingMind
- BetterChatGPT
- LibreChat
- Warp AI
- Pieces
- Fig AI
Embed badge
[](https://verified-skill.com/skills/alekspetrov/navigator/nav-profile)