nav-skill-creator

Navigator Skill Creator

Create project-specific skills by analyzing codebase patterns and automating repetitive workflows.

When to Invoke

Auto-invoke when user mentions:

• "Create a skill for [pattern]"
• "Automate this workflow"
• "We keep doing X manually"
• "Enforce this pattern"
• "Generate boilerplate for [feature type]"
• "We need consistency for [task type]"

What This Does

1. Analyzes codebase to understand project patterns
2. Identifies best practices from existing code
3. Generates skill with:
   • Auto-invocation triggers
   • Predefined functions
   • Templates
   • Examples
4. Tests the generated skill
5. Documents the new skill

Execution Steps

Step 1: Understand Skill Request

Ask clarifying questions:

• What pattern/workflow to automate?
• What triggers should invoke this skill?
• What output format is expected?
• Are there existing examples in the codebase?

Example dialogue:

User: "Create a skill for adding React components"
Assistant: "I'll analyze your codebase to understand React component patterns.
- What directory are components in?
- Do you use TypeScript or JavaScript?
- Do you want tests generated automatically?
- Are there style files (CSS/SCSS) per component?"

Step 2: Analyze Codebase Patterns

Use Task agent to explore (saves 60-80% tokens):

Use Task agent with subagent_type=Explore:
"Find existing [pattern type] in codebase:
 - Locate all [files matching pattern]
 - Identify common structure
 - Extract best practices
 - Find configuration files
 - Return summary of findings"

What to look for:

• File naming conventions (kebab-case, PascalCase, etc.)
• Directory structure patterns
• Import/export patterns
• Testing patterns
• Configuration patterns
• Documentation patterns

Example for React components:

Task agent finds:
- Components in src/components/
- PascalCase naming (UserProfile.tsx)
- Co-located tests (UserProfile.test.tsx)
- Props interfaces defined above component
- Export default at bottom