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

python3 "$SKILL_BASE_DIR/functions/feature_manager.py" show

This displays the feature table:

v5.6.0 Features:

┌─────────────────┬────────┬─────────────────────────────────────────────────┐
│ Feature         │ Status │ Description                                     │
├─────────────────┼────────┼─────────────────────────────────────────────────┤
│ task_mode       │ ✅     │ Auto-detects task complexity, defers to skills  │
│ tom_features    │ ✅     │ Verification checkpoints, user profile, diag... │
│ loop_mode       │ ⏸ Off  │ Autonomous loop execution (enable when needed)  │
│ simplification  │ ✅     │ Post-implementation code cleanup with Opus      │
│ auto_update     │ ✅     │ Auto-updates on session start                   │
└─────────────────┴────────┴─────────────────────────────────────────────────┘

All v5.6.0 features configured.

Step 2: Handle Toggle Request (If Applicable)

If user requested to enable/disable a feature:

# Enable a feature
python3 "$SKILL_BASE_DIR/functions/feature_manager.py" enable task_mode

# Disable a feature
python3 "$SKILL_BASE_DIR/functions/feature_manager.py" disable loop_mode

Supported features:

• 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 - Auto-update on session start

After toggle, show updated table.

Step 3: Explain Feature (If Asked)

If user asks about a specific feature, provide details:

task_mode:

Task Mode (v5.6.0)
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Auto-detects task complexity and routes appropriately:
- Simple tasks → Direct execution
- Skill matches → Defers to skill workflow
- Substantial → Task Mode phases (RESEARCH→COMPLETE)

Config: task_mode.enabled, complexity_threshold (0.5)

tom_features:

Theory of Mind (v5.0.0)
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Human-AI collaboration improvements:
- Verification checkpoints for high-stakes skills
- User profile (nav-profile) - remembers preferences
- Quality detection (nav-diagnose) - catches drift

Config: tom_features.verification_checkpoints, profile_enabled

loop_mode:

Loop Mode (v5.1.0)
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
"Run until done" capability:
- Structured completion signals (NAVIGATOR_STATUS)
- Dual-condition exit (heuristics + EXIT_SIGNAL)
- Stagnation detection prevents infinite loops

Trigger: "run until done", "loop mode"
Config: loop_mode.enabled, max_iterations (5)

simplification:

Code Simplification (v5.4.0)
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Automatic code clarity improvements:
- Runs post-implementation, before commit
- Clarity over brevity, functionality preserved
- Uses Opus model for best results

Trigger: "simplify this code"
Config: simplification.enabled, trigger, scope

auto_update:

Auto-Update (v5.5.0)
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Automatic plugin updates on session start:
- Checks for newer version
- Updates silently if available
- Never blocks session start

Config: auto_update.enabled, check_interval_hours (1)

Predefined Functions

functions/feature_manager.py

Purpose: Display and toggle Navigator features

Usage:

# Show all features
python3 feature_manager.py show

# Show for first session (includes welcome message)
python3 feature_manager.py show --first-session

# Enable a feature
python3 feature_manager.py enable task_mode

# Disable a feature
python3 feature_manager.py disable loop_mode

# Get feature details
python3 feature_manager.py info task_mode

Output: Formatted feature table or status message

Error Handling

Config not found:

❌ .nav-config.json not found

Run "Initialize Navigator in this project" first.

Unknown feature:

❌ Unknown feature: xyz

Available features:
  task_mode, tom_features, loop_mode, simplification, auto_update

Success Criteria

• Feature table displayed correctly
• Toggle updates config file
• Updated table shown after toggle
• Feature details available on request

Notes

This skill is triggered on first session (via nav-start) to help users understand available features and optionally disable unused ones to save tokens.