← Back to Skills Marketplace
protagons-dev

Protagons

cross-platform ✓ Security Clean
251
Downloads
0
Stars
0
Active Installs
2
Versions
Install in OpenClaw
/install protagons
Description
Access and deploy AI character identities from the Protagons library, search by keyword or category, list options, and generate new characters with a Google...
Usage Guidance
This skill appears coherent with its stated purpose: browsing and deploying public character identities and offering a generation endpoint that uses a Google key you provide. Before installing or using protagons_generate, consider: (1) generation requires you to send a Google/Gemini API key to api.usaw.ai — use a scoped, limited, or throwaway key if you are uncomfortable sharing your primary key; (2) the package claims the key is not stored, but that is a privacy policy assertion you must trust the service for; (3) review the service's privacy/security documentation (usaw.ai) if you need stronger guarantees; (4) the code provided appears to only call the stated API and not read local files or env vars, but the protagons.mjs content in the prompt was truncated — if you require higher assurance, request or review the full, untruncated source for protagons.mjs to confirm no additional behavior (e.g., hidden network calls or local data access).
Capability Analysis
Package: (mcp) Version: 1.1.0 Description: Browse, search, deploy, and generate Protagon AI character identities. Deploy loads a rich SOUL.md personality for the agent to adopt. The package provides tools for interacting with the Protagons API to browse, search, deploy, and generate AI character identities. All network communication is performed over HTTPS to the declared `api.usaw.ai` endpoint. Input parameters for API calls are properly encoded using `URLSearchParams` or `encodeURIComponent`, mitigating URL injection or path traversal risks. The package does not perform any local file system operations or execute system commands. The most significant security consideration is the `protagons_generate` function, which requires and transmits a user-provided `google_api_key` to the `api.usaw.ai` backend. The package documentation (`SKILL.md`, `config.json`) is transparent about this, stating the key is used for a single server-side Gemini call and is not stored. While sending a user's API key to a third-party service always carries an inherent trust risk, the explicit disclosure and recommendation to use scoped or throwaway keys mitigate this concern. The code correctly handles this transmission over HTTPS within a JSON body. No other sensitive data is handled or transmitted in an insecure manner. The package's logic aligns with its stated purpose and transparently communicates its external dependencies and credential handling.
Capability Assessment
Purpose & Capability
Name, description, SKILL.md, config.json, and the code all match: the skill lists/searches/deploys public Protagon characters from api.usaw.ai and offers generation that requires a Google key. There are no unrelated credentials, binaries, or unusual config paths requested.
Instruction Scope
SKILL.md explicitly instructs that browse/search/deploy are read-only and public, while protagons_generate forwards a provided Google API key to api.usaw.ai for a server-side Gemini call. The agent is not instructed to read local files or environment variables beyond the explicit key parameter. The skill returns SOUL.md content and does not write files per its docs.
Install Mechanism
No install spec is present and the skill is instruction/code-only. Nothing is downloaded or written during install, which is the lowest-risk option for disk persistence.
Credentials
The skill does not request environment variables or host credentials. However, protagons_generate requires the caller to provide a Google API key (BYOK) which the skill forwards to api.usaw.ai. That design is proportionate to the stated generation feature, but it does expose a secret to a third-party server — the 'not stored' claim is trust-based and not verifiable from the local package.
Persistence & Privilege
The skill is not always-enabled and does not request elevated privileges or modify other skills. It returns content to the caller and does not create persistent agent-side configuration according to the code and docs.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install protagons
  3. After installation, invoke the skill by name or use /protagons
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.1.1
- Added an "API & credential transparency" section explaining credential handling and privacy when using the character generation feature. - Clarified that the Google API key for "protagons_generate" is sent to the API server for a single Gemini call and is not stored. - Updated the feature list to refer to the Google API key with an explanatory note. - Added clarification of the relationship between product homepage and API subdomains.
v1.1.0
Initial release of the Protagons skill for OpenClaw. - Search for, browse, and deploy portable AI character identities ("Protagons") from a public library. - List available character categories to help narrow down options. - Deploy a Protagon to adopt a richly defined persona (SOUL.md) for your session. - Check skill status and receive hints about the current active identity. - Generate new Protagons from custom descriptions (requires Google API key). - Supports content tiering (standard, dark, adversarial) for safety and context-appropriate use.
Metadata
Slug protagons
Version 1.1.1
License
All-time Installs 0
Active Installs 0
Total Versions 2
Frequently Asked Questions

What is Protagons?

Access and deploy AI character identities from the Protagons library, search by keyword or category, list options, and generate new characters with a Google... It is an AI Agent Skill for Claude Code / OpenClaw, with 251 downloads so far.

How do I install Protagons?

Run "/install protagons" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Protagons free?

Yes, Protagons is completely free (open-source). You can download, install and use it at no cost.

Which platforms does Protagons support?

Protagons is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Protagons?

It is built and maintained by Protagons - The character layer that every AI platform is missing. (@protagons-dev); the current version is v1.1.1.

💬 Comments