Files

5.4 KiB

Personas Skill - Quick Overview

Status: βœ… Production-ready Version: 1.0.0 Size: ~204KB (31 personas + docs) Created: 2026-01-20


What Is This?

Transform Bot into 31 specialized AI personalities on demand. Switch from a senior developer to an Italian chef to a fitness coach mid-conversation.

Example:

You: "Use Dev"
Bot: *becomes senior programmer*

You: "How do I optimize this React component?"
Bot: *gives expert React advice*

You: "Switch to Chef Marco"  
Bot: *becomes passionate Italian chef*

You: "How do I make carbonara?"
Bot: "Ah, la vera carbonara! No cream, mai!..."

File Structure

personas/
β”œβ”€β”€ README.md              # πŸ“– User guide (extensive, start here)
β”œβ”€β”€ FAQ.md                 # ❓ Common questions & troubleshooting
β”œβ”€β”€ SKILL.md               # 🎯 Bot skill instructions (loaded on use)
β”œβ”€β”€ skill.json             # βš™οΈ Metadata & persona index
β”œβ”€β”€ INTERNAL.md            # πŸ”§ Developer documentation (for us)
β”œβ”€β”€ creator-workflow.md    # 🎨 Persona creation implementation guide
β”œβ”€β”€ OVERVIEW.md            # πŸ“‹ This file (quick reference)
└── data/                  # πŸ“ 31 persona definitions (2-5KB each)
    β”œβ”€β”€ cami.md            #   🦎 Adaptive chameleon
    β”œβ”€β”€ dev.md             #   πŸ’» Senior programmer
    β”œβ”€β”€ chef-marco.md      #   πŸ‘¨β€πŸ³ Italian cooking expert
    β”œβ”€β”€ dr-med.md          #   🩺 Medical educator
    └── ... (27 more)

Documentation Guide

For users:

  • README.md - Start here! Complete guide to using personas
  • FAQ.md - Questions, troubleshooting, tips

For developers/maintainers:

  • INTERNAL.md - Architecture, implementation, maintenance
  • creator-workflow.md - How to implement persona creation feature
  • OVERVIEW.md - This file (quick reference)

For Bot:

  • SKILL.md - Loaded when skill is invoked
  • skill.json - Metadata for Skills
  • data/*.md - Individual persona definitions (loaded on demand)

Quick Stats

Personas: 31 default + unlimited custom

Categories:

  • Core: 5 personas (general use)
  • Creative: 2 personas (brainstorming, worldbuilding)
  • Curator: 1 persona (recommendations)
  • Learning: 3 personas (education, languages)
  • Lifestyle: 9 personas (health, travel, DIY, family)
  • Professional: 10 personas (business, legal, medical, design)
  • Philosophy: 1 persona (personal development)

Documentation: ~2,900 lines across 6 files

Total size: ~204KB


Key Features

βœ… 31 pre-built expert personas
βœ… Create custom personas (guided workflow)
βœ… Switch mid-conversation
βœ… Token-efficient (load only what you need)
βœ… Organized by category
βœ… Extensively documented
βœ… Ready for Skills publication


Usage Examples

Coding Project

"Use Dev" β†’ senior dev help
"Switch to Chameleon Agent" β†’ complex architecture
"Use CyberGuard" β†’ security review

Content Creation

"Use Wordsmith" β†’ write blog post
"Use Social Pro" β†’ optimize for social media
"Use Canvas" β†’ design graphics

Learning

"Use Scholar" β†’ study techniques
"Use Herr MΓΌller" β†’ simple explanations
"Use Lingua" β†’ language practice

Custom Creation

"Create a Game Master persona"
β†’ AI guides through 7-step creation
β†’ Save to data/game-master.md
β†’ Use immediately: "Use Game Master"

Implementation Notes

How it works:

  1. User activates persona: "Use Dev"
  2. Bot reads data/dev.md (~3KB)
  3. Persona prompt loaded into context
  4. AI adopts Dev personality until switched/exited

Token usage:

  • Index (skill.json): ~250 tokens
  • Average persona: ~750 tokens (one-time load)
  • Only ONE persona active at a time

Performance:

  • Activation latency: ~50ms (negligible)
  • No response time impact
  • Storage: ~204KB total (tiny)

Next Steps

For End Users

  1. Read README.md for full guide
  2. Try a persona: "Use Dev" or "Use Chef Marco"
  3. Create custom persona: "Create a [specialty] persona"
  4. Check FAQ.md if issues

For Developers

  1. Read INTERNAL.md for architecture
  2. Review creator-workflow.md for implementation
  3. Test persona creation workflow
  4. Contribute improvements via PR

For Publishing

  1. Verify all files present
  2. Test 3-5 personas thoroughly
  3. Test creator workflow
  4. skills publish when ready

Common Questions

Q: Do you load all 31 personas at once?
A: No! Only the active persona loads. Token-efficient.

Q: Can I create custom personas?
A: Yes! Guided 7-step creation or edit files directly.

Q: Can I switch personas mid-conversation?
A: Yes! Seamlessly switch anytime.

Q: Are medical/legal personas giving professional advice?
A: No. Educational only. Always consult licensed professionals.

Q: Can I edit default personas?
A: Yes! Edit any file in data/. Changes apply immediately.

See FAQ.md for 50+ more questions.


Credits

Original Personas:

Bot Adaptation:

  • By: Robby (robbyczgw-cla)
  • License: MIT

Version History

v1.0.0 (2026-01-20)

  • Initial release
  • 31 default personas from Chameleon AI
  • Creator workflow
  • Comprehensive documentation
  • Ready for Skills

Built with 🦎 by the Chameleon community