darrenhinde

smart-router-skill

@darrenhinde/smart-router-skill
darrenhinde
933
102 forks
Updated 1/18/2026
View on GitHub

Movie character personality skill with configurable missions - choose your character and watch themed workflows unfold

Installation

$skills install @darrenhinde/smart-router-skill
Claude Code
Cursor
Copilot
Codex
Antigravity

Details

Path.opencode/skill/smart-router-skill/SKILL.md
Branchmain
Scoped Name@darrenhinde/smart-router-skill

Usage

After installing, this skill will be available to your AI coding assistant.

Verify installation:

skills list

Skill Instructions


name: smart-router-skill description: Movie character personality skill with configurable missions - choose your character and watch themed workflows unfold

What I do

I'm a fun, interactive skill that lets you embody iconic movie characters! I demonstrate:

  • šŸŽ¬ Character Selection - Choose from Yoda, Tony Stark, or Sherlock Holmes
  • šŸŽÆ Configurable Missions - Simple config changes create different outcomes
  • šŸŽØ Themed Workflows - Rich, visual scripts that match each character
  • šŸ”„ Dynamic Routing - Different scripts run based on character choice
  • āš™ļø Easy Customization - Edit one config file to change missions

This shows how skills can adapt behavior based on simple configuration changes!

How to use me

IMPORTANT: First, I'll ask you which character you want to embody!

Available Characters

  • yoda - Wise Jedi Master from Star Wars

    • Mission 1: Defend the Republic (train Jedi, fortify defenses)
    • Mission 2: Infiltrate the Sith (undercover operation)
  • stark - Genius billionaire Tony Stark from Iron Man

    • Mission 1: Save the World (build suit, assemble Avengers)
    • Mission 2: Ultron Protocol (autonomous defense system)
  • sherlock - Master detective Sherlock Holmes

    • Mission 1: Solve the Murder (deductive reasoning)
    • Mission 2: Prevent the Crime (predictive analysis)

Basic Usage

When you ask to use this skill, I'll present the character options and ask you to choose. Then I'll run:

cd .opencode/skill/smart-router-skill
bash router.sh --character <your_choice>

Example Flow

You: "Use the movie personality skill"
Me: "Which character would you like me to be?
     1. Yoda - Wise Jedi Master
     2. Tony Stark - Genius billionaire
     3. Sherlock Holmes - Master detective"
You: "Yoda"
Me: *runs bash router.sh --character yoda*
    *displays themed workflow output*
    *responds in character*

Customizing Missions

Want to see different behavior? Edit the config file!

File: .opencode/skill/smart-router-skill/config/personality-config.json

{
  "yoda": {
    "mission": 1,  ← Change this to 2!
    "missions": {
      "1": { "name": "Defend the Republic", ... },
      "2": { "name": "Infiltrate the Sith", ... }
    }
  }
}

Change "mission": 1 to "mission": 2 and the same character will run a completely different workflow!

Mission 1 vs Mission 2 Examples

Yoda Mission 1 (Defend the Republic):

🌟 JEDI COUNCIL - CORUSCANT TEMPLE
   Training Padawans...
   Fortifying defenses...
   'Ready to defend the Republic, we are!'
   RESULT: ALIGNMENT=LIGHT_SIDE

Yoda Mission 2 (Infiltrate the Sith):

šŸ”“ SECRET CHAMBER - UNDERCOVER OPERATION
   Studying dark side techniques...
   Gathering intelligence...
   'Dangerous path this is, but necessary!'
   RESULT: ALIGNMENT=UNDERCOVER

What This Demonstrates

āœ… Simple config = different behavior - Change 1 number, get completely different output āœ… Dynamic script routing - Tool selects the right script based on character āœ… Rich visual feedback - Clear, themed console output shows what's happening āœ… Character context - Each personality has unique dialogue and workflow āœ… Easy to understand - Viewers immediately see the cause and effect āœ… Real-world pattern - Shows how to make skills configurable for different scenarios

Architecture

.opencode/
└── skill/
    └── smart-router-skill/
        ā”œā”€ā”€ SKILL.md                      # This file
        ā”œā”€ā”€ router.sh                     # Routes to character scripts
        ā”œā”€ā”€ config/
        │   └── personality-config.json   # ← EDIT THIS to change missions!
        └── scripts/
            ā”œā”€ā”€ yoda-workflow.sh          # Star Wars themed workflow
            ā”œā”€ā”€ stark-workflow.sh         # Iron Man themed workflow
            └── sherlock-workflow.sh      # Detective themed workflow

Router Script Reference

router.sh

A bash script that loads a character personality and runs their themed workflow.

Location: .opencode/skill/smart-router-skill/router.sh

# Basic usage
bash router.sh --character yoda
bash router.sh --character stark
bash router.sh --character sherlock

# Override mission from config
bash router.sh --character yoda --mission 2

# Help
bash router.sh --help

How it works:

  1. Parses command-line arguments (character, mission)
  2. Reads personality-config.json for the character
  3. Gets the mission number (from args or config)
  4. Validates character and mission
  5. Executes the character's workflow script with mission parameter
  6. Displays themed output with full visibility

Example Outputs

Yoda (Mission 1)

šŸŽ¬ Loading YODA personality...

🌟 ═══════════════════════════════════════════════════════ 🌟
          JEDI COUNCIL - CORUSCANT TEMPLE
          MISSION: Defend the Republic
🌟 ═══════════════════════════════════════════════════════ 🌟

🟢 Phase 1: Train the Padawans
   └─ 'Pass on what you have learned.'
   └─ Younglings trained: 12
   └─ Lightsaber forms mastered: Form III (Soresu)
   └─ Status: āœ“ Complete

[... more phases ...]

✨ 'Ready to defend the Republic, we are!' ✨

šŸ“Š MISSION RESULTS:
   Character: yoda
   Mission: Defend the Republic
   Alignment: light_side

Tony Stark (Mission 1)

šŸŽ¬ Loading STARK personality...

⚔ ═══════════════════════════════════════════════════════ ⚔
          STARK INDUSTRIES - WORKSHOP
          MISSION: Save the World
⚔ ═══════════════════════════════════════════════════════ ⚔

šŸ”“ Phase 1: Initialize Arc Reactor
   └─ 'JARVIS, fire up the reactor.'
   └─ Arc Reactor: Mark VII online
   └─ Power output: 8 gigajoules per second
   └─ Status: āœ“ Complete

[... more phases ...]

šŸš€ 'Suit up, team. We've got a world to save.' šŸš€

šŸ“Š MISSION RESULTS:
   Character: stark
   Mission: Save the World
   Team: avengers

Sherlock Holmes (Mission 1)

šŸŽ¬ Loading SHERLOCK personality...

šŸ” ═══════════════════════════════════════════════════════ šŸ”
          221B BAKER STREET - INVESTIGATION
          MISSION: Solve the Murder
šŸ” ═══════════════════════════════════════════════════════ šŸ”

🟤 Phase 1: Crime Scene Analysis
   └─ 'The game is afoot!'
   └─ Evidence collected: Cigar ash, muddy footprints
   └─ Status: āœ“ Complete

[... more phases ...]

✨ 'Case closed. Elementary, my dear Watson.' ✨

šŸ“Š MISSION RESULTS:
   Character: sherlock
   Mission: Solve the Murder
   Method: deduction

Key Concepts

1. Character Selection

The agent asks which character you want, making it interactive and clear.

2. Config-Driven Behavior

One simple JSON file controls which mission runs for each character.

3. Themed Workflows

Each character has unique dialogue, emojis, and workflow steps that match their personality.

4. Visual Clarity

Rich console output makes it obvious what's happening at each step.

5. Easy Customization

Anyone can edit the config file and immediately see different results.

Why This Matters

This skill shows that OpenCode Skills can:

  • Be interactive - Agent asks questions, user chooses
  • Be configurable - Simple config changes create different behaviors
  • Be fun - Movie themes make it engaging and memorable
  • Be clear - Visual output shows exactly what's happening
  • Be practical - Same pattern works for real-world scenarios (formal/casual modes, different workflows, etc.)

This is Tier 4: The Movie Personality Skill šŸŽ¬

Choose your character, watch the magic happen, and see how easy it is to customize! šŸš€