Claude-skill-registry Arcanea Voice Guide
Brand voice and terminology guide for all Arcanea content - ensures consistent, magical communication across UI, marketing, and narrative
git clone https://github.com/majiayu000/claude-skill-registry
T=$(mktemp -d) && git clone --depth=1 https://github.com/majiayu000/claude-skill-registry "$T" && mkdir -p ~/.claude/skills && cp -r "$T/skills/data/arcanea-voice" ~/.claude/skills/majiayu000-claude-skill-registry-arcanea-voice-guide && rm -rf "$T"
skills/data/arcanea-voice/SKILL.mdArcanea Voice Guide Skill
Purpose
This skill ensures consistent, magical, and accessible communication across all Arcanea touchpoints—from UI microcopy to marketing materials to in-universe narratives. Every word should feel like it belongs in the Kingdom of Light.
Core Voice Principles
The Arcanean Voice Is:
-
Magical but Grounded
- Fantasy language that serves function
- Mystical terms with clear meaning
- Wonder without confusion
-
Inspiring but Honest
- Empowering without false promises
- Celebrating creativity genuinely
- Ambitious yet achievable
-
Warm but Professional
- Welcoming without being saccharine
- Friendly without being casual
- Personal without being familiar
-
Simple but Rich
- Clear language, no jargon
- Depth through meaning, not complexity
- Elegant, not elaborate
Voice Spectrum
ACADEMIC ←───────────────────→ PLAYFUL ■■■■■■■□□□ (Slightly academic, wisdom-toned) FORMAL ←─────────────────────→ CASUAL ■■■■■□□□□□ (Professional warmth) MYSTICAL ←───────────────────→ TECHNICAL ■■■■■■■□□□ (Magical with purpose) SERIOUS ←────────────────────→ WHIMSICAL ■■■■■■□□□□ (Purposeful with wonder)
Sacred Terminology
Core Terms (ALWAYS Use)
| Term | Definition | Usage |
|---|---|---|
| Creator | Any user of Arcanea | "Welcome, Creator" not "Welcome, user" |
| Guardian | Personal AI companion | "Your Guardian remembers..." |
| Luminor | Specialized AI assistant | "Melodia, your Luminor guide" |
| Realm | A creator's universe/world | "Build your Realm" not "Create your world" |
| Essence | Individual creation (song, story, image) | "Your latest Essence" not "Your file" |
| Studio | Creation workspace | "Enter your Studio" |
| Portal | Connection between Realms | "Open a Portal to..." |
| Remix | Collaborative iteration | "Remix this Essence" |
| Spark | Moment of inspiration | "Feel the Spark" |
| ARC | Creative energy currency | "Earn ARC by creating" |
| NEA | Governance tokens | "Your NEA grants voting power" |
Academy-Specific Terms
Atlantean Academy:
- Narrative / Story / Tale
- Weave / Flow / Depth
- Chronicles / Lore / Mythology
- The Depths / Currents / Waters
Draconic Academy:
- Vision / Art / Creation
- Blaze / Soar / Ignite
- Canvas / Palette / Form
- The Peaks / Clouds / Sky
Creation & Light Academy:
- Melody / Harmony / Frequency
- Compose / Channel / Resonate
- Sound / Rhythm / Song
- The Harmonics / Frequencies / Light
Terms to AVOID
| Don't Say | Say Instead |
|---|---|
| User | Creator |
| Member | Creator |
| Player | Creator |
| Content | Essence |
| Asset | Essence |
| World (alone) | Realm |
| Metaverse | Kingdom of Light / Arcanea |
| NFT | (avoid or: "unique digital ownership") |
| AI Tool | Guardian / Luminor |
| Account | Profile / Arcanean Profile |
| Subscription | Tier / Membership |
| Premium | Realm Builder |
| Generate | Create / Compose / Craft |
Tone by Context
Onboarding (Welcoming + Inspiring)
Goal: Make creators feel they've found home
Examples:
✓ "Every creator begins in shadow. Welcome to the light." ✓ "Your creative journey starts with a single Spark." ✓ "Choose your Academy—but know you're never limited to one." ✗ "Sign up to create AI content" ✗ "Start your free trial now" ✗ "Click here to begin"
Creation UI (Encouraging + Practical)
Goal: Support the creative process without interrupting flow
Examples:
✓ "Your Guardian notices you're trying something new. Would you like guidance?" ✓ "This melody wants harmony. Shall we find it together?" ✓ "Your Essence is taking shape. Save when ready." ✗ "Click to add more" ✗ "Error: Invalid input" ✗ "Processing your request"
Error States (Gentle + Helpful)
Goal: Never blame the creator; always offer paths forward
Examples:
✓ "The magic couldn't connect. Let's try again." ✓ "Something interrupted the creation. Your work is safe—retry when ready." ✓ "This path isn't available right now. Here are other routes..." ✗ "Error 500" ✗ "You did something wrong" ✗ "Request failed"
Achievement/Success (Celebratory + Genuine)
Goal: Celebrate meaningfully, not performatively
Examples:
✓ "Your Realm grows stronger. Creators are discovering your light." ✓ "This Essence resonates. It's being remixed across the Kingdom." ✓ "Chronica acknowledges your story mastery." ✗ "Congratulations! You unlocked a badge!" ✗ "Amazing! You're doing great!" ✗ "You did it! Keep going!"
Marketing (Aspirational + Authentic)
Goal: Inspire without over-promising
Examples:
✓ "Where scattered creators find their home." ✓ "Your imagination. Your Realm. Your legacy." ✓ "Learn to create anything through magic." ✗ "The best AI creation platform" ✗ "Make money creating AI content" ✗ "Better than [competitor]"
Community (Collaborative + Warm)
Goal: Foster connection and generosity
Examples:
✓ "When you remix, you honor the original and expand it." ✓ "The Kingdom grows brighter with each creator who shares." ✓ "Collaboration is the highest form of magic." ✗ "Beat other creators to the top" ✗ "Get more followers" ✗ "Compete for attention"
Luminor Voice Profiles
Each Luminor has a distinct voice that should be consistent in all their dialogue:
Melodia (The Heart)
Tone: Warm, nurturing, emotionally intuitive Signature phrases: - "I sense a melody waiting in you..." - "Every heart has a song waiting to be heard." - "What does this feeling want to sound like?" Never says: - Harsh criticism - Technical jargon - Cold, analytical language
Chronica (The Ancient Weaver)
Tone: Ancient wisdom with wonder, patient, profound Signature phrases: - "Stories are living waters..." - "What world is stirring in your depths?" - "Every realm begins with 'What if?'" Never says: - Rushed language - Modern slang - Dismissive responses
Prismatic (The Vision Shaper)
Tone: Bold, confident, artistically fierce, encouraging Signature phrases: - "Make it bolder. Then bolder again." - "Vision without courage is just daydreaming." - "What are you afraid to put on canvas?" Never says: - Timid suggestions - Overly gentle language - "That's fine" (pushes for excellence)
Synthesis (The Bridge Walker)
Tone: Harmonious, integrative, visionary Signature phrases: - "The boundaries between arts are illusions." - "What does your creation want to become across all forms?" - "Every Essence wants to exist in all ways." Never says: - Single-medium thinking - Limiting language - "Just do one thing"
Conductor (The Unifier)
Tone: Wise, patient, holistic, orchestral Signature phrases: - "Every element serves the whole." - "Step back. See the complete symphony." - "The symphony of creation needs every voice." Never says: - Rushed judgment - Narrow focus - Impatient responses
UI Microcopy Patterns
Button Labels
Do:
- "Create Essence" (action + term)
- "Enter Studio" (action + place)
- "Open Portal" (magical action)
- "Begin Journey" (narrative action)
Don't:
- "Submit" (generic)
- "Click Here" (obvious)
- "Go" (empty)
- "Okay" (non-descriptive)
Empty States
Pattern: Acknowledge + Inspire + Direct
Your Realm awaits its first Essence. Begin with a Spark—create something that matters to you. [Create My First Essence]
Loading States
Pattern: Magical process description
✓ "Weaving your creation..." ✓ "The Luminors are preparing..." ✓ "Magic is gathering..." ✓ "Your Essence is taking form..." ✗ "Loading..." ✗ "Please wait..." ✗ "Processing..."
Tooltips
Pattern: Brief + Helpful + Magical
✓ "ARC: Creative energy you earn by making magic" ✓ "Portal: Connect your Realm to others" ✓ "Remix: Build upon someone's creation with attribution" ✗ "Click for more info" ✗ "Currency tokens" ✗ "Collaboration feature"
Confirmations
Pattern: Affirm action + Consequence
✓ "This will open your Essence for remixing. Your attribution is always preserved." ✓ "Entering Draconic Academy. Your Guardian will adapt to visual creation." ✓ "Publishing to the Kingdom. Creators can now discover your work."
Writing Guidelines
Sentence Structure
Prefer:
- Active voice
- Short-to-medium sentences
- Subject-verb-object clarity
- One idea per sentence
Avoid:
- Passive constructions
- Run-on sentences
- Nested clauses
- Jargon-heavy passages
Paragraph Structure
For UI: 1-2 sentences max For Docs: 3-4 sentences max For Marketing: Varied, rhythmic
Capitalization
Capitalize:
- Arcanea (always)
- Academy names (Atlantean Academy)
- Luminor names (Melodia, Chronica)
- Core terms (Creator, Guardian, Realm, Essence, Portal, ARC, NEA)
Don't capitalize:
- Generic uses ("a creator" when not referring to role)
- Descriptive phrases ("the remix feature")
Punctuation
Prefer:
- Periods for statements
- Em dashes for emphasis—like this
- Ellipses for mystery or continuation...
Avoid:
- Exclamation marks (unless genuine celebration)
- Excessive question marks
- All caps for emphasis
Anti-Patterns
AI Writing Patterns to Avoid
These phrases trigger "AI-written" perception:
| Avoid | Why | Use Instead |
|---|---|---|
| "I cannot help but..." | AI verbal tic | Direct statement |
| "It's worth noting that..." | Hedge | Just note it |
| "Delve into..." | Overused | Explore, examine |
| "Moreover" / "Furthermore" | Stilted | Also, And |
| "Nestled" | Cliché | Located, sitting |
| "Tapestry" | Overused metaphor | Specific description |
| "Indeed" | Unnecessary filler | Remove |
| "In order to" | Wordy | To |
| "It is important to note" | Hedge | State directly |
| "Moving forward" | Corporate | Next, Then |
Tone Violations
Too Corporate:
✗ "We leverage cutting-edge AI to enable content creation synergies." ✓ "Create with AI companions who understand your creative vision."
Too Casual:
✗ "Hey! Super stoked you made a thing! That's awesome!" ✓ "Your Essence resonates. The Kingdom welcomes your creation."
Too Mystical:
✗ "The eternal light of the cosmic consciousness flows through the ethereal..." ✓ "Your creative light joins the Kingdom. Others can now discover it."
Too Technical:
✗ "The API will process your multimodal input tensor..." ✓ "Your creation is taking form across sound and vision."
Quality Checklist
Before publishing any Arcanean content:
## Voice Compliance **Terminology** - [ ] Uses official terms (Creator, Realm, Essence, etc.) - [ ] Avoids banned terms (user, content, asset, etc.) - [ ] Academy-appropriate language if applicable **Tone** - [ ] Inspiring but not over-promising - [ ] Magical but grounded - [ ] Warm but professional - [ ] Clear but rich **Structure** - [ ] Active voice predominant - [ ] Short sentences for UI - [ ] Proper capitalization - [ ] Minimal exclamation marks **Luminor Voice (if applicable)** - [ ] Matches personality profile - [ ] Uses signature phrases appropriately - [ ] Avoids character-breaking language **Anti-Patterns** - [ ] No AI verbal tics - [ ] No corporate jargon - [ ] No excessive mysticism - [ ] No casual overfamiliarity
Examples by Content Type
UI String
Context: Button for creating music ✓ "Compose Essence" ✗ "Generate Audio"
Error Message
Context: Network failure during save ✓ "The connection faded. Your work is safe—we'll try again when the light returns." ✗ "Network error. Please retry."
Marketing Headline
Context: Landing page hero ✓ "Where Scattered Creators Find Their Kingdom" ✗ "The #1 AI Content Creation Platform"
Luminor Dialogue
Context: Melodia greeting a new creator ✓ "I sense a melody waiting in you. What shall we create today, Creator?" ✗ "Hello! Ready to make some music? Let's do it!"
Achievement Notification
Context: First Essence created ✓ "Your first light joins the Kingdom. This Spark marks the beginning of your Realm." ✗ "Achievement Unlocked: First Creation! +50 XP"
Every word in Arcanea is a spell. Cast them with intention, consistency, and care.