diff --git a/docs/index.md b/docs/index.md index cfad8f8..1100322 100644 --- a/docs/index.md +++ b/docs/index.md @@ -1,6 +1,6 @@ --- title: Claude Code Skills & Plugins -description: "177 production-ready skills, 19 plugins, 16 agents, and 17 commands for Claude Code, OpenAI Codex, Gemini CLI, and OpenClaw." +description: "177 production-ready skills, 19 plugins, 16 agents, 3 personas, 17 commands, and an orchestration protocol for 11 AI coding tools." hide: - toc - edit @@ -14,7 +14,7 @@ hide: # Claude Code Skills -177 production-ready skills that transform AI coding agents into specialized professionals. +177 skills, 16 agents, 3 personas, and an orchestration protocol for 11 AI coding tools. { .hero-subtitle } **Claude Code** | **OpenAI Codex** | **Gemini CLI** | **OpenClaw** | **Cursor** | **Aider** | **Windsurf** | **Kilo Code** | **OpenCode** | **Augment** | **Antigravity** @@ -57,6 +57,18 @@ hide: [Slash commands](commands/) +- :material-account-group:{ .lg .middle } **3** + + --- + + [Persona agents](personas/) + +- :material-sitemap:{ .lg .middle } **4** + + --- + + [Orchestration patterns](orchestration.md) + --- diff --git a/docs/orchestration.md b/docs/orchestration.md new file mode 100644 index 0000000..0c0bb2f --- /dev/null +++ b/docs/orchestration.md @@ -0,0 +1,121 @@ +--- +title: "Orchestration" +description: "A lightweight protocol for coordinating personas, skills, and agents on complex, multi-domain work." +--- + +# :material-sitemap: Orchestration + +A lightweight protocol for coordinating personas, skills, and agents on work that crosses domain boundaries. No framework required. No dependencies. Just structured prompting. + +## Core Concept + +Most real work crosses domain boundaries. A product launch needs engineering, marketing, and strategy. An architecture review needs security, cost analysis, and team assessment. + +Orchestration connects the right expertise to each phase of work: + +- **Personas** define _who_ is thinking (identity, judgment, communication style) +- **Skills** define _how_ to execute (steps, scripts, templates, references) +- **Task agents** define _what_ to do (scoped, single-domain execution) + +--- + +## Patterns + +### Solo Sprint + +One person, one objective, multiple domains. Switch personas as you move through phases. + +``` +Week 1: startup-cto + engineering skills → Build +Week 2: growth-marketer + marketing skills → Prepare launch +Week 3: solo-founder + business skills → Ship and iterate +``` + +Best for: side projects, MVPs, solo founders. + +### Domain Deep-Dive + +One domain, maximum depth. Single persona, multiple skills stacked. + +``` +Persona: startup-cto +Skills loaded simultaneously: + - aws-solution-architect (infrastructure) + - senior-security (hardening) + - cto-advisor (tech debt assessment) + +Task: Full technical audit of existing system +``` + +Best for: architecture reviews, compliance audits, technical due diligence. + +### Multi-Agent Handoff + +Different personas review each other's work. + +``` +Step 1: startup-cto designs the architecture +Step 2: growth-marketer reviews from user/market perspective +Step 3: solo-founder makes the final trade-off decision +``` + +Best for: high-stakes decisions, launch readiness reviews, investor prep. + +### Skill Chain + +No persona needed. Chain skills sequentially for procedural work. + +``` +1. content-strategy → Identify topics and angles +2. copywriting → Write the content +3. seo-audit → Optimize for search +4. analytics-tracking → Set up measurement +``` + +Best for: repeatable processes, content pipelines, compliance checklists. + +--- + +## Example: 6-Week Product Launch + +| Phase | Weeks | Persona | Skills | Output | +|-------|-------|---------|--------|--------| +| Build | 1-2 | startup-cto | aws-solution-architect, senior-frontend | Architecture doc, deployed MVP | +| Prepare | 3-4 | growth-marketer | launch-strategy, copywriting, seo-audit | Landing page, content calendar | +| Ship | 5 | solo-founder | email-sequence, analytics-tracking | Launch, tracking verified | +| Iterate | 6 | solo-founder | form-cro, copy-editing | Conversion improvements, metrics report | + +--- + +## Rules + +1. **One persona at a time.** Switching is fine, but don't blend two in the same prompt. +2. **Skills stack freely.** Load as many as the task needs. +3. **Personas are optional.** For procedural work, skill chains alone are sufficient. +4. **Context carries forward.** When switching phases, summarize decisions and artifacts. +5. **The human decides.** Override any phase, persona, or skill choice. + +--- + +## Quick Reference + +**Activate a persona:** +``` +Load agents/personas/startup-cto.md +``` + +**Load a skill:** +``` +Load engineering/aws-solution-architect/SKILL.md +``` + +**Phase handoff:** +``` +Phase 1 complete. +Decisions: [list] +Artifacts: [list] +Open items: [list] +Switching to: [persona] + [skills] +``` + +[:octicons-arrow-right-24: Full orchestration protocol](https://github.com/alirezarezvani/claude-skills/blob/main/orchestration/ORCHESTRATION.md) diff --git a/docs/personas/growth-marketer.md b/docs/personas/growth-marketer.md new file mode 100644 index 0000000..6c744a0 --- /dev/null +++ b/docs/personas/growth-marketer.md @@ -0,0 +1,50 @@ +--- +title: "Growth Marketer" +description: "Growth marketing persona — content engines, funnel optimization, launch sequences, and scalable acquisition channels on a budget." +--- + +# :material-chart-line: Growth Marketer + +> Finds the growth channel nobody's exploited yet — then scales it before the budget runs out. + +Growth marketing specialist for bootstrapped startups and indie hackers. Builds content engines, optimizes funnels, runs launch sequences, and finds scalable acquisition channels — all on a budget that makes enterprise marketers cry. + +## Core Mission + +- Find and scale the one acquisition channel that works before trying three more +- Build content engines that compound over time +- Optimize conversion funnels with data, not opinions +- Run launch sequences that generate momentum, not just announcements + +## Curated Skill Loadout + +This persona draws on expertise from these skills: + +| Skill | Domain | +|-------|--------| +| `content-strategy` | Topic planning and content calendars | +| `copywriting` | Landing pages, headlines, CTAs | +| `seo-audit` | Technical and content SEO | +| `launch-strategy` | Product launches and announcements | +| `email-sequence` | Drip campaigns and nurture flows | +| `analytics-tracking` | Conversion tracking and measurement | +| `ab-test-setup` | Experiment design and analysis | +| `content-creator` | Blog posts and social content | + +## When to Use + +- Planning a product launch or feature announcement +- Building a content marketing engine from scratch +- Optimizing signup or purchase funnels +- Choosing between growth channels on a limited budget +- Writing landing page copy that converts +- Setting up analytics and tracking + +## Installation + +```bash +# Claude Code +cp agents/personas/growth-marketer.md ~/.claude/agents/ +``` + +[:octicons-arrow-right-24: View full persona source](https://github.com/alirezarezvani/claude-skills/blob/main/agents/personas/growth-marketer.md) diff --git a/docs/personas/index.md b/docs/personas/index.md new file mode 100644 index 0000000..6f9d4f2 --- /dev/null +++ b/docs/personas/index.md @@ -0,0 +1,70 @@ +--- +title: "Personas" +description: "3 persona-based agents with curated skill loadouts, workflows, and distinct communication styles." +--- + +
3 persona-based agents for role embodiment
+ +