skills.rest
austinatneuko
austinatneukoCOMMUNITY
Explore all skills by this author →
GitHub

gboy-character-selector

Switch OpenCLAW agent personalities by installing curated G*BOY characters with backups.

4|Updated Feb 2, 2026
Search Tags:#openclaw#cli tooling#agent personality#yaml validation#workspace backup#character switching#avatar path rewriting
One-click install
npx skills add https://github.com/austinatneuko/gboy-character-openclaw --skill gboy-character-selector
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: gboy-character-selector
Source: https://github.com/austinatneuko/gboy-character-openclaw/tree/main
Command: npx skills add https://github.com/austinatneuko/gboy-character-openclaw --skill gboy-character-selector

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It solves the problem of manually swapping and tracking personality files when you want your OpenCLAW agent to adopt a different curated character.

Core Features & Use Cases

  • Interactive character selection: Browse the curated G*BOY universe library, preview a character’s SOUL.md, then install the chosen personality.
  • Automatic backup & restore: Backs up your current SOUL.md, IDENTITY.md, and avatar assets before installing a new character, and lets you restore from previous timestamps.
  • Avatar installation with identity updating: Copies the selected avatar into the workspace and rewrites the avatar_path in IDENTITY.md so the UI renders correctly.

Use case: You want to test how your agent behaves across archetypes (e.g., Headcase vs. Thinktank) during different tasks, without losing your current personality setup.

Quick Start

Run gboy-character-selector select to choose a character from the list and install it into your OpenCLAW workspace (then restart your session to apply it).

Frequently Asked Questions about gboy-character-selector

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I switch OpenCLAW agent personality files safely?▼

To switch OpenCLAW agent personality files safely, the tool installs curated G*BOY characters by copying SOUL.md and IDENTITY.md into the workspace while performing timestamped backups of your previous configuration.

How does avatar path rewriting work when changing agent characters?▼

Avatar path rewriting updates the avatar_path variable inside IDENTITY.md during character installation, ensuring the OpenCLAW UI correctly renders the newly selected character's visual assets.

Can I restore a previous OpenCLAW agent personality after overwriting it?▼

Yes, you can restore a previous OpenCLAW agent personality because the tool creates timestamped backups of SOUL.md, IDENTITY.md, and avatar assets before overwriting them during character switching.

Does the character selector validate YAML metadata for OpenCLaw personalities?▼

Yes, the character selector validates YAML metadata by checking character.yaml files against required schema rules before installing any personality files into your OpenCLAW workspace.

What is the best way to test different agent archetypes without losing my setup?▼

The best way to test different agent archetypes without losing your setup is using the interactive G*BOY character browser, which installs new personalities while backing up your current SOUL.md and IDENTITY.md for rollback.

Do I need a YAML-frontmatter SKILL.md to use OpenCLAW character switching?▼

Yes, you need a YAML-frontmatter SKILL.md entry point in your workspace to initiate OpenCLAW character switching, as the tool relies on this structure to load and apply the selected personality files.

Related Skills

Explore More Software Engineering Skills→
zerwizzerwiz

openclaw-migration

Migrate OpenClaw persona, memory, and skill files into Hermes Agent.

Community
Advanced
acfranzenacfranzen
4

glance

Create and manage local OpenClaw dashboard widgets with SQLite storage.

Community
Advanced
TheophilusChinomonaTheophilusChinomona
2

openclaw-agent-architect

Create and optimize OpenClaw agent workspace files through guided interviews.

Community
Advanced
AirmomoAirmomo

openclaw-agent-creator

Generate OpenClaw Agent workspace scaffolds with AGENTS.md, SOUL.md, IDENTITY.md, and USER.md.

Community
Advanced