nav-profile

Manage persistent user preferences, corrections, and goals in a local JSON profile.

232|12|Updated Oct 10, 2025
One-click install
npx skills add https://github.com/qf-studio/navigator --skill nav-profile-qf-studio
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: nav-profile
Source: https://github.com/qf-studio/navigator/tree/main/skills/nav-profile
Command: npx skills add https://github.com/qf-studio/navigator --skill nav-profile-qf-studio

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? AI coding assistants forget your preferences between sessions, forcing you to repeat corrections and restate how you like to work. This Skill stores your communication, technical, and workflow preferences in a persistent local profile so they apply automatically across sessions. ## Core Features & Use Cases - Preference Management: Show, update, and reset preferences for verbosity, confirmation thresholds, code style, frameworks, and testing approach stored in .agent/.user-profile.json. - Auto-Learning from Corrections: Detects correction patterns like "No, I meant..." or "Not X, use Y" and silently saves generalized rules, keeping a rolling window of the last 20 corrections. - Goal Tracking: Records active work goals with status and last-mentioned dates, auto-archiving stale ones. - Use Case: After telling your AI assistant "Remember I prefer functional style and concise explanations", future sessions load those preferences automatically, and repeated corrections like "use plural REST endpoints" are learned without being asked twice. ## Quick Start Ask the assistant to save your preferences, for example by saying "remember I prefer concise explanations and functional code style".

Frequently Asked Questions about nav-profile

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I save my coding preferences for an AI assistant?

State your preference naturally, such as "remember I prefer functional style" or "I like concise explanations". The preference extractor maps common phrases to profile fields and writes them to .agent/.user-profile.json for future sessions.

How does automatic correction learning work?

The extractor watches for correction signals like "No, I meant...", "Not X, use Y", or "Always do X". When detected, it generalizes the correction into a pattern, stores it with a confidence level, and keeps only the most recent 20 corrections.

Where is the user profile stored and is it private?

The profile lives at .agent/.user-profile.json, which is git-ignored and local only. It stores preferences, corrections, and goals but never code snippets, file contents, or conversation history, and you can delete it anytime.

What happens if the profile JSON file becomes corrupt?

The profile loader catches JSON decode errors and falls back to an empty profile with a warning instead of crashing. You can then recreate the profile with the create action or by saving new preferences.

Can I reset or delete my saved preferences?

Yes, the delete action removes the profile file entirely after confirmation. Future sessions then start fresh, and you can rebuild the profile by saving preferences as you work.