Good AI Tools

>> nav-features

stars: 158
forks: 7
watches: 158
last updated: 2026-03-08 22:54:40

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.