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:
- User activates persona:
"Use Dev" - Bot reads
data/dev.md(~3KB) - Persona prompt loaded into context
- 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
- Read README.md for full guide
- Try a persona:
"Use Dev"or"Use Chef Marco" - Create custom persona:
"Create a [specialty] persona" - Check FAQ.md if issues
For Developers
- Read INTERNAL.md for architecture
- Review creator-workflow.md for implementation
- Test persona creation workflow
- Contribute improvements via PR
For Publishing
- Verify all files present
- Test 3-5 personas thoroughly
- Test creator workflow
skills publishwhen 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:
- Source: Chameleon AI Chat
- License: MIT
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