Agent-Skills.md

Agent Skills: Navigator Features Skill

Show and toggle Navigator features. Auto-invoke when user says "show features", "enable/disable feature", "my navigator settings", or "configure navigator".

UncategorizedID: alekspetrov/navigator/nav-features

Repository

alekspetrov/navigator
alekspetrov
1517

Install this agent skill to your local

pnpm dlx add-skill https://github.com/alekspetrov/navigator/tree/HEAD/skills/nav-features

Skill Files

Browse the full folder contents for nav-features.

Download Skill

Loading file tree…

skills/nav-features/SKILL.md

Skill Metadata

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".

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 (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]    │ Auto-updates on session start                 │
│ knowledge_graph         │ [x]    │ Unified project knowledge + experiential m... │
│ multi_agent             │ [x]    │ Parallel agent orchestration (nav-multi sk... │
│ multi_claude_scripts    │ [*]    │ External shell scripts for multi-Claude wo... │
│ 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... │
└─────────────────────────┴────────┴───────────────────────────────────────────────┘

All v<version> 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:

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 - Auto-update on session start
  • knowledge_graph - Unified project knowledge + memories (v6.0.0)
  • multi_agent - Parallel agent orchestration via nav-multi (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 profile corrections

Install-based:

  • multi_claude_scripts - External shell scripts (navigator-multi-claude.sh on PATH)

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: lists all available feature names (see Supported features section above). The error message is generated dynamically from the FEATURES dict, so it stays current as features are added.

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.