/nav-features

name: nav-features
description: Show and toggle Navigator features. Auto-invoke when user says "show features", "enable/disable feature", "my navigator settings", or "configure navigator".
allowed-tools: Read, Write, Bash
version: 1.0.0

Navigator Features Skill

Display and toggle Navigator features with an interactive table. Helps users understand what's enabled and customize their setup.

When to Invoke

Invoke this skill when the user:

• Says "show my features", "navigator features", "what features are enabled"
• Says "enable [feature]", "disable [feature]", "turn on/off [feature]"
• Says "configure navigator", "my navigator settings"
• Asks "what can navigator do?", "what features are available?"

**DO NOT invoke** if:

• User is asking about project features (not Navigator)
• User is in middle of implementation
• Just starting session (use nav-start instead)

Execution Steps

Step 1: Read Current Configuration

PLUGIN_DIR="${CLAUDE_PLUGIN_ROOT:-$(cat "${NAVIGATOR_CONFIG_HOME:-${XDG_CONFIG_HOME:-$HOME/.config}/navigator}/plugin-root" 2>/dev/null)}"
[ -d "$PLUGIN_DIR/skills" ] || PLUGIN_DIR="$HOME/.claude/plugins/marketplaces/navigator-marketplace"
python3 "$PLUGIN_DIR/skills/nav-features/functions/feature_manager.py" show

This displays the feature table (one row per configurable Navigator feature, current version's number in the header):

v<version> Features:

┌─────────────────────────┬────────┬───────────────────────────────────────────────┐
│ Feature                 │ Status │ Description                                   │
├─────────────────────────┼────────┼───────────────────────────────────────────────┤
│ task_mode               │ [x]    │ Auto-detects task complexity, defers to sk... │
│ tom_features            │ [x]    │ Verification checkpoints, user profile, di... │
│ loop_mode               │ [ ]    │ Autonomous loop execution (enable when nee... │
│ simplification          │ [x]    │ Post-implementation code cleanup with Opus    │
│ auto_update             │ [x]    │ Update notice on session start                │
│ knowledge_graph         │ [x]    │ Unified project knowledge + experiential m... │
│ compact_hook            │ [x]    │ Injects rich summary into compacted sessions  │
│ workflow_enforcer_hook  │ [x]    │ Enforces WORKFLOW CHECK block before task ... │
│ read_guard_hook         │ [x]    │ Warns on excessive Reads (push to agents)     │
│ workflow_state_hook     │ [x]    │ Tracks current task/phase across the session  │
│ task_graph_sync_hook    │ [x]    │ Auto-syncs task files into the knowledge g... │
│ profile_sync_hook       │ [x]    │ Auto-captures preferences/corrections into... │
│ dispatcher              │ [x]    │ Single hook dispatcher runtime (nav_dispat... │
│ tier1                   │ [ ]    │ Zero-token answers for whitelisted prompts    │
│ stop_completion         │ [ ]    │ Completion gate on Stop (decision:block)      │
│ reject_log              │ [x]    │ One JSONL line per refusal (.agent/.nav-re... │
│ jit_memory              │ [ ]    │ Injects relevant memories after tool use      │
│ subagent_context        │ [ ]    │ Injects project context into subagents (2k)   │
│ failure_diagnosis       │ [ ]    │ Surfaces graph pitfalls on tool failures      │
│ judge                   │ [ ]    │ Jev judgments overlay the prompt scorers      │
│ adhd_mode               │ [ ]    │ Per-person reply shaping (one next action,... │
│ ste_mode                │ [ ]    │ STE sentence rules, personal switch           │
│ config_guard            │ [x]    │ Warns when .nav-config.json edits break JSON  │
│ setup_hook              │ [x]    │ One-line runtime status on the Setup event    │
└─────────────────────────┴────────┴───────────────────────────────────────────────┘

All v<version> features configured.

Step 2: Handle Toggle Request (If Applicable)

If user requested to enable/disable a feature:

PLUGIN_DIR="${CLAUDE_PLUGIN_ROOT:-$(cat "${NAVIGATOR_CONFIG_HOME:-${XDG_CONFIG_HOME:-$HOME/.config}/navigator}/plugin-root" 2>/dev/null)}"
[ -d "$PLUGIN_DIR/skills" ] || PLUGIN_DIR="$HOME/.claude/plugins/marketplaces/navigator-marketplace"
# Enable a feature
python3 "$PLUGIN_DIR/skills/nav-features/functions/feature_manager.py" enable task_mode

# Disable a feature
python3 "$PLUGIN_DIR/skills/nav-features/functions/feature_manager.py" disable loop_mode

# Personal toggle (team repo): write to .agent/.nav-config.local.json, not the shared file
python3 "$PLUGIN_DIR/skills/nav-features/functions/feature_manager.py" disable judge --local

**Personal overrides (v7.8.0+)**: `.agent/.nav-config.json` is committed and shared. `.agent/.nav-config.local.json` is gitignored (nav-init adds it) and merges over the shared file last — DEFAULTS < shared < local — in both the hook runtime and this script. Use `--local` when the user says "for me only", "just on my machine", or has no key for a shared-on feature (typical: `disable judge --local`). `show` marks rows the local file decides with `L` and prints a legend; toggling the shared value while a local override exists prints a warning so nobody wonders why nothing changed.

**Supported features**:

Core (config-toggled):

• `task_mode` - Unified workflow orchestration
• `tom_features` - Theory of Mind (verification checkpoints, profile, diagnostics)
• `loop_mode` - Autonomous loop execution
• `simplification` - Code cleanup before commit
• `auto_update` - Update notice on session start; the update is one command
• `knowledge_graph` - Unified project knowledge + memories (v6.0.0)

Hooks (config-toggled, edit with caution):

• `compact_hook` - Pre-compact summary injection
• `workflow_enforcer_hook` - Mandatory WORKFLOW CHECK block (disabling weakens guardrails)
• `read_guard_hook` - Anti upfront-loading guard
• `workflow_state_hook` - Tracks task/phase across the session
• `task_graph_sync_hook` - Auto-syncs tasks into knowledge graph
• `profile_sync_hook` - Auto-captures pr