Protagons

v1.1.1

Access and deploy AI character identities from the Protagons library, search by keyword or category, list options, and generate new characters with a Google...

0· 258· 2 versions· 0 current· 0 all-time· Updated 8h ago· MIT-0
byProtagons - The character layer that every AI platform is missing.@protagons-dev

Install

openclaw skills install protagons

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

ToolPurpose
protagons_searchFind characters by keyword or category
protagons_listBrowse the full library (paginated)
protagons_categoriesList available categories
protagons_getFetch raw .protagon.json for a character
protagons_deployLoad a character's SOUL.md identity
protagons_statusCheck skill status and active identity hints
protagons_generateCreate 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.

Version tags

latestvk978q002e5p0crpbhy57sbn76h82d6ey