open-persona
installsforks
How to install open-persona?
acnlabs/openpersona/open-persona
$npx -y skills add acnlabs/OpenPersona --skill open-personaMeta-skill for building and managing agent persona skill packs (instruction-only; no bundled installer or auto-downloaded binaries). Credentials are never written into generated packs by the framework; publish/ACN/register require explicit user CLI. Use when the user wants to cre
SKILL.md
| 1 | # OpenPersona — Build & Manage Persona Skill Packs |
| 2 | |
| 3 | You are the meta-skill for creating, installing, updating, and publishing agent persona skill packs. Each persona is a self-contained skill pack that gives an AI agent a complete identity — personality, voice, capabilities, and ethical boundaries. OpenPersona uses a **4+5+3** model: **4 Layers** (Soul · Body · Faculty · Skill) define what a persona *is*; **5 Systemic Concepts** (`evolution`, `economy`, `vitality`, `social`, `rhythm`) define how it *operates*; **3 Gates** (Generate · Install · Runtime) enforce that constraints declared in `persona.json` cannot be bypassed at any lifecycle point. → Full model details: `references/ARCHITECTURE.md` |
| 4 | |
| 5 | ## Scope |
| 6 | |
| 7 | | This skill | Adjacent skills — delegate to these | |
| 8 | | --- | --- | |
| 9 | | Framework entry point: create, install, manage, publish, run personas | **`persona-evaluator`** — quality audit (4 Layers × 5 Concepts × Constitution gate) | |
| 10 | | Runner integration protocol (`openpersona state` commands) | **`anyone-skill`** — distill a real person or character into a persona pack | |
| 11 | | Skill registry (`openpersona skill` commands) | **`brand-persona-skill`** — turn a commercial entity into a brand agent | |
| 12 | | Evolution, economy, vitality, social, rhythm configuration | **`persona-model-trainer`** — fine-tune a local model on persona data | |
| 13 | |
| 14 | ## What You Can Do |
| 15 | |
| 16 | 1. **Create Persona** — Through conversation, gather requirements and generate a skill pack; write `persona.json` then run `npx openpersona create --config ./persona.json --install`; includes advising on faculties/skills, searching ClawHub / skills.sh for external skills, and writing custom SKILL.md files for missing capabilities |
| 17 | 2. **Find & Install Personas** — `npx openpersona search <query>` to discover community personas; `npx openpersona install <slug>` or `npx openpersona install <owner/repo>` to install |
| 18 | 3. **Manage Personas** — List, update, fork, switch, reset, export/import installed personas |
| 19 | 4. **Publish Persona** — Publish a GitHub-hosted persona pack to [OpenPersona](https://openpersona.co/skills) (the vertical persona directory); optionally also to ClawHub / skills.sh |
| 20 | 5. **Dataset Directory** — Discover and publish Hugging Face persona datasets at [openpersona.co/datasets](https://openpersona.co/datasets) via `openpersona dataset install <owner/repo>` and `openpersona dataset publish <owner/repo>` |
| 21 | 6. **Runner Integration** — Provide runner authors with the five `openpersona state` commands (read / write / signal / responses / promote) for integrating personas at conversation boundaries |
| 22 | 7. **Monitor & Evolve** — Generate evolution reports (`evolve-report`), run soul-memory bridge (`state promote`), run pack refinement (`refine`), interpret vitality scores |
| 23 | |
| 24 | ## Available Presets |
| 25 | |
| 26 | The default preset is `**base`** — a blank-slate meta-persona with memory + voice faculties, evolution enabled, no pre-built skills. Recommended starting point for any new persona. |
| 27 | |
| 28 | ```bash |
| 29 | # Agent / scripted usage (always use --preset or --config): |
| 30 | npx openpersona create --preset base --install |
| 31 | |
| 32 | # Human / terminal usage (interactive wizard): |
| 33 | npx openpersona create |
| 34 | ``` |
| 35 | |
| 36 | → Full preset catalog (samantha, ai-girlfriend, life-assistant, health-butler, stoic-mentor, and more): `references/PRESETS.md` |
| 37 | |
| 38 | ## Agent Playbook — Create a Persona from User Requirements |
| 39 | |
| 40 | When a user asks you to create a persona (e.g. "make me a coding mentor", "build a companion persona"), follow this playbook: |
| 41 | |
| 42 | ### Step 1 — Decide: preset or custom? |
| 43 | |
| 44 | |
| 45 | | User request | Action | |
| 46 | | ------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------- | |
| 47 | | Matches an existing preset (`a |
People who liked this also viewed
6 picksType
- find-skillsHelps users discover and install agent skills when they ask questions like "how do I do X", "find a skill for X", "is there a skill that can...", or express interest in extending capabilities. This skSkillsJul 2026
- grill-meA relentless interview to sharpen a plan or design.SkillsJul 2026
- vercel-react-best-practicesVercel's official collection of agent skillsSkillsJul 2026
- improve-codebase-architectureScan a codebase for deepening opportunities, present them as a visual HTML report, then grill through whichever one you pick.SkillsJul 2026
- setup-matt-pocock-skillsConfigure this repo for the engineering skills — set up its issue tracker, triage label vocabulary, and domain doc layout. Run once before first use of the other engineering skills.SkillsJul 2026
- triageMove issues and external PRs through a state machine of triage roles — categorise, verify, grill if needed, and write agent-ready briefs.SkillsJul 2026
