A local-first CLI toolkit for designing, analyzing, and managing complex character personas and their developmental arcs.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install persona-forge
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install persona-forge using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is Persona Forge?
Persona Forge is a specialized utility designed for writers, game developers, and AI enthusiasts who need a robust system for character architectural design. It functions as a comprehensive workbench for creating character profiles, backstories, and personality traits while maintaining a local, privacy-focused log of all creative iterations. As part of the ecosystem of Openclaw Skills, it provides a structured way to bridge the gap between raw creative ideas and structured character data.
Built with a philosophy of simplicity and permanence, this tool ensures that every character arc, relationship, and trait analysis is timestamped and searchable. It eliminates the chaos of scattered notes by providing a unified interface for recording character evolution, making it an essential asset for anyone looking to build deep, consistent fictional worlds.
Persona Forge Use Cases
- Character Architecture: Use generate to log new persona concepts and run to execute detailed creation workflows.
- Trait Validation: Record and analyze personality traits to ensure character archetypes remain consistent across narratives.
- World Building Support: Log batch processing for NPCs and side characters to populate stories quickly while maintaining quality control.
- Data Portability: Export character records into structured formats for integration with external game engines or writing software.
- Conflict Mapping: Use the compare command to evaluate character motivations and relationship dynamics.
How Persona Forge Works
- Command Execution: Users interact with the skill via the CLI using specific domain commands like run, analyze, or generate.
- Mode Detection: The tool detects if arguments are provided. No arguments trigger Read Mode (displaying recent history), while providing text triggers Write Mode.
- Local Persistence: Entries are timestamped and appended to specific log files within the local share directory, ensuring data privacy.
- Activity Tracking: Every action is cross-referenced in a master history.log to provide a global audit trail of character development.
- Data Aggregation: Built-in utility commands like stats and search parse across all domain logs to provide high-level insights and specific character retrieval.
Persona Forge Setup
To install and configure this skill within your environment, ensure you have Bash 4+ available. No external package managers are required. Follow these steps:
# Ensure the script is executable
chmod +x persona-forge
# Move to your local bin for global access
mv persona-forge /usr/local/bin/
# Verify the installation and check system health
persona-forge status
Persona Forge Data Schema & Taxonomy
The skill organizes data locally using a flat-file taxonomy for maximum speed and transparency. All files are located in ~/.local/share/persona-forge/.
| File Type | Purpose | Format |
|---|---|---|
*.log |
Domain-specific entries (e.g., run.log, check.log) | YYYY-MM-DD HH:MM|input |
history.log |
Global activity sequence | Chronological text |
export.json |
Structured character data | JSON |
export.csv |
Tabular character data | CSV |
Persona Forge Advanced Features
- Multi-Format Exporting: Native support for JSON, CSV, and TXT ensures your character data is ready for any pipeline.
- Global Search Engine: A powerful built-in search utility to find specific character mentions across all historical logs.
- Health Monitoring: The status command provides real-time reporting on entry counts, versioning, and disk usage.
- Batch Processing Logs: Specifically designed to track high-volume character generation tasks for large-scale world building.
- No-Dependency Architecture: Relies strictly on standard Unix utilities, ensuring long-term stability and zero-cost maintenance.
SKILL.md
Loading
Related Openclaw Skills
Pricing Strategy
An expert AI framework for designing SaaS pricing models that maximize value capture and align with customer willingness to pay.
Aptos TypeScript SDK Transactions
A comprehensive guide for managing the full lifecycle of Aptos blockchain transactions using the official TypeScript SDK.
Work Buddy (Chinese Version)
A proactive AI work partner that provides rhythmic accompaniment and low-pressure task follow-ups throughout the workday.
VAM Scripter
VAM Scripter is a high-performance, JavaScript-inspired scripting language for Virt-A-Mate that enables advanced automation of scene interactions and animations without reflection.
OpenClaw TTS Voice Switch
A specialized skill for OpenClaw that automates ElevenLabs voice swapping, configuration updates, and gateway restarts for seamless text-to-speech management.
Ctxkeeper
Ctxkeeper is a specialized utility for logging, tracking, and managing operational entries across multiple categories to maintain a persistent record of AI agent activity.
Featured*
