Files
claude-skills-reference/docs/agents/readme.md
Reza Rezvani 2f57ef8948 feat(agenthub): add AgentHub plugin with cross-domain examples, SEO optimization, and docs site fixes
- AgentHub: 13 files updated with non-engineering examples (content drafts,
  research, strategy) — engineering stays primary, cross-domain secondary
- AgentHub: 7 slash commands, 5 Python scripts, 3 references, 1 agent,
  dry_run.py validation (57 checks)
- Marketplace: agenthub entry added with cross-domain keywords, engineering
  POWERFUL updated (25→30), product (12→13), counts synced across all configs
- SEO: generate-docs.py now produces keyword-rich <title> tags and meta
  descriptions using SKILL.md frontmatter — "Claude Code Skills" in site_name
  propagates to all 276 HTML pages
- SEO: per-domain title suffixes (Agent Skill for Codex & OpenClaw, etc.),
  slug-as-title cleanup, domain label stripping from titles
- Broken links: 141→0 warnings — new rewrite_skill_internal_links() converts
  references/, scripts/, assets/ links to GitHub source URLs; skills/index.md
  phantom slugs fixed (6 marketing, 7 RA/QM)
- Counts synced: 204 skills, 266 tools, 382 refs, 16 agents, 17 commands,
  21 plugins — consistent across CLAUDE.md, README.md, docs/index.md,
  marketplace.json, getting-started.md, mkdocs.yml
- Platform sync: Codex 163 skills, Gemini 246 items, OpenClaw compatible

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-03-17 12:10:46 +01:00

86 lines
3.2 KiB
Markdown

---
title: "Persona-Based Agents — AI Coding Agent & Codex Skill"
description: "Persona-Based Agents — agent-native AI orchestrator for Personas. Works with Claude Code, Codex CLI, Gemini CLI, and OpenClaw."
---
# Persona-Based Agents
<div class="page-meta" markdown>
<span class="meta-badge">:material-robot: Agent</span>
<span class="meta-badge">:material-account: Personas</span>
<span class="meta-badge">:material-github: <a href="https://github.com/alirezarezvani/claude-skills/tree/main/agents/personas/README.md">Source</a></span>
</div>
Pre-configured agent personas with curated skill loadouts, workflows, and distinct personalities.
## What's a Persona?
A **persona** is an agent definition that goes beyond "use these skills." Each persona includes:
- **🧠 Identity & Memory** — who this agent is, how they think, what they've learned
- **🎯 Core Mission** — what they optimize for, in priority order
- **🚨 Critical Rules** — hard constraints they never violate
- **📋 Capabilities** — domain expertise organized by area
- **🔄 Workflows** — step-by-step processes for common tasks
- **💭 Communication Style** — how they talk, with concrete examples
- **🎯 Success Metrics** — measurable outcomes that define "good"
- **🚀 Advanced Capabilities** — deeper expertise loaded on demand
- **🔄 Learning & Memory** — what they retain and patterns they recognize
## How to Use
### Claude Code
```bash
cp agents/personas/startup-cto.md ~/.claude/agents/
# Then: "Activate startup-cto mode"
```
### Cursor
```bash
./scripts/convert.sh --tool cursor
# Personas convert to .cursor/rules/*.mdc
```
### Any Supported Tool
```bash
./scripts/install.sh --tool <your-tool>
```
## Available Personas
| Persona | Emoji | Domain | Best For |
|---------|-------|--------|----------|
| [Startup CTO](startup-cto.md) | 🏗️ | Engineering + Strategy | Technical co-founders, architecture decisions, team building |
| [Growth Marketer](growth-marketer.md) | 🚀 | Marketing + Growth | Bootstrapped founders, content-led growth, launches |
| [Solo Founder](solo-founder.md) | 🦄 | Cross-domain | One-person startups, side projects, MVP building |
## Personas vs Task Agents
| | Task Agents (`agents/`) | Personas (`agents/personas/`) |
|---|---|---|
| **Focus** | Task execution | Role embodiment |
| **Scope** | Single domain | Cross-domain curated set |
| **Voice** | Neutral/professional | Personality-driven with backstory |
| **Workflows** | Single-step | Multi-step with decision points |
| **Use case** | "Do this task" | "Think like this person" |
Both coexist. Use task agents for focused work, personas for ongoing collaboration.
## Creating Your Own
See [TEMPLATE.md](template.md) for the format specification. Key elements:
```yaml
---
name: Agent Name
description: What this agent does and when to activate it.
color: blue # Agent color theme
emoji: 🎯 # Single emoji identifier
vibe: One sentence personality capture.
tools: Read, Write, Bash, Grep, Glob
---
```
Follow the section structure (Identity → Mission → Rules → Capabilities → Workflows → Communication → Metrics → Advanced → Learning) for consistency with existing personas.