description	allowed-tools	arguments
Generate themed spinner verbs for Claude Code status messages. Use /create-spinnerverbs [theme] --scope [local|project|user]	Write Read Bash Glob	name description theme Theme for spinner verbs (e.g., pirate, chef, ninja, corporate, motivational, space, medieval) name description scope Where to save: local (.claude/settings.local.json, gitignored), project (.claude/settings.json), or user (~/.claude/settings.json). Default: project

Create Themed Spinner Verbs

Generate custom spinner verbs (the status messages shown while Claude works) based on a theme.

Arguments received: $ARGUMENTS

Parse Arguments

Extract the theme and scope from arguments:

• Theme: The descriptive theme for generating spinner verb variants
• Scope: Where to save the settings.json file
  • local or --local: Save to .claude/settings.local.json (gitignored, personal to you)
  • project or --project: Save to .claude/settings.json (default, shared with team)
  • user or --user: Save to ~/.claude/settings.json (all projects for this user)

Spinner Verbs Schema

Claude Code spinnerVerbs is a flat array of strings that are randomly selected to display while working.

Schema:

{
  "spinnerVerbs": {
    "mode": "append" | "replace",
    "verbs": ["string1", "string2", "string3", ...]
  }
}

• mode: "append" — Adds your verbs to the default set
• mode: "replace" — Uses ONLY your verbs (replaces defaults entirely)

Output Format

Create a settings.json file with this structure:

{
  "spinnerVerbs": {
    "mode": "replace",
    "verbs": [
      "Themed verb 1",
      "Themed verb 2",
      "Themed verb 3"
    ]
  }
}

Note: Verbs are displayed randomly—they don't map to specific actions. Generate 20-50 themed phrases for good variety.

Instructions

1. Parse the arguments to identify:

   • The theme description (everything except scope flags)
   • The scope (look for --local, --project, --user, or local/project/user keywords)

2. Generate 20-50 creative themed phrases that:

   • Match the theme's vocabulary, tone, and style
   • Are fun, memorable, and on-brand for the theme
   • Can be short (1 word) or longer phrases (up to ~8 words)
   • Mix action verbs, catchphrases, quotes, and situational phrases

3. Determine save location based on scope:

   • local: .claude/settings.local.json (gitignored, personal)
   • project (default): .claude/settings.json (shared with team)
   • user: ~/.claude/settings.json (applies to all projects)

4. Write the JSON file with correct schema:

   {
     "spinnerVerbs": {
       "mode": "replace",
       "verbs": ["phrase1", "phrase2", ...]
     }
   }

5. Confirm creation with a preview of the generated verbs

Example Themes

Pirate theme:

{
  "spinnerVerbs": {
    "mode": "replace",
    "verbs": [
      "Scheming", "Deciphering the map", "Scribing the captain's log",
      "Treasure hunting", "Setting sail", "Hoisting the mainsail",
      "Plundering the codebase", "Walking the plank", "Swabbing the deck",
      "Charting a course", "Avast!", "Shiver me timbers"
    ]
  }
}

Chef theme:

{
  "spinnerVerbs": {
    "mode": "replace",
    "verbs": [
      "Seasoning", "Studying the recipe", "Plating",
      "Foraging for ingredients", "Firing up the grill", "Mise en place",
      "Reducing the sauce", "Caramelizing", "Deglazing",
      "Taste testing", "Julienning", "Flambéing"
    ]
  }
}

Corporate theme:

{
  "spinnerVerbs": {
    "mode": "replace",
    "verbs": [
      "Synergizing", "Reviewing deliverables", "Drafting memo",
      "Deep diving", "Executing", "Circling back",
      "Taking this offline", "Moving the needle", "Boiling the ocean",
      "Low-hanging fruit", "Leveraging best practices", "Aligning stakeholders"
    ]
  }
}

Execute

1. Based on the theme "$ARGUMENTS", generate 20-50 themed spinner verb phrases
2. Use mode: "replace" unless user specifies append
3. Save to the appropriate scope location (.claude/settings.json by default)
4. Show the user a preview of the generated verbs