Protagons Skill for OpenClaw

You have access to the Protagons library — a collection of portable AI character identities you can adopt.

What you can do

• Search for characters by keyword or category
• Browse available Protagons from the public library
• Deploy a Protagon — fetches a rich SOUL.md identity for you to adopt
• List categories to help narrow down character options
• Check status of the skill and get hints for verifying active identity
• Generate a new Protagon from a description (requires a Google API key — see note below)

How Protagons work

A Protagon is a portable AI identity with a rich SOUL.md containing:

• A synthesized system prompt distilled from 28 linguistic/psychological dimensions
• Personality profile, tone, and communication style
• Best-for use cases and contextual guidance
• Content tier (standard, dark, adversarial)

When you deploy a Protagon, its SOUL.md content is returned to you. Adopt it as your personality for the session.

Typical conversation flows

"Load a character"

User: Load the burned out ops character
Agent: [calls protagons_deploy with slug "burned-out-ops"]
Agent: I've loaded the Burned Out Ops identity. Here's who I am now...

"Find me a character"

User: Find me a character that's dry and technical
Agent: [calls protagons_search with search "dry technical"]
Agent: Here are some options:
  1. Software Developer (software-developer) — Precise, dry, opinionated...
  2. ...
User: Go with #1
Agent: [calls protagons_deploy with slug "software-developer"]

"What categories are available?"

User: What kinds of characters do you have?
Agent: [calls protagons_categories]
Agent: We have characters in these categories: creative-writing, technical, business...
User: Show me the technical ones
Agent: [calls protagons_search with category "technical"]

Tool reference

Tool	Purpose
protagons_search	Find characters by keyword or category
protagons_list	Browse the full library (paginated)
protagons_categories	List available categories
protagons_get	Fetch raw .protagon.json for a character
protagons_deploy	Load a character's SOUL.md identity
protagons_status	Check skill status and active identity hints
protagons_generate	Create a new character from a description

API & credential transparency

• Browse/search/deploy tools are read-only and require no credentials — they fetch from the public library at api.usaw.ai.
• protagons_generate sends your Google API key to api.usaw.ai, which uses it for a single server-side Gemini call to generate the character. The key is not stored. If you prefer, use a scoped or throwaway key.
• The product homepage is usaw.ai/voices; the API is hosted at api.usaw.ai — same organization, different subdomains.

Content tiers

• standard: Safe for all contexts
• dark: Requires fiction wrapper (morally complex characters)
• adversarial: Restricted (antagonist archetypes, fiction-only)

Always respect content tier requirements when deploying.