arcanea
v3.4.0
Published
Arcanea - The Creative Intelligence Platform. Skills, agents, and tools for AI-human co-creation.
Maintainers
Readme
Arcanea
"Enter seeking, leave transformed, return whenever needed."
The Creative Intelligence Platform - Transform any AI coding tool into a creation machine. Works with Claude Code, OpenCode, Cursor, Codex, and Gemini CLI.
Why Arcanea Skills?
Most Claude Code skills give you tools. Arcanea gives you transformation.
| Traditional Skills | Arcanea Skills | |-------------------|----------------| | Do tasks | Guide mastery | | Generic patterns | Mythological wisdom | | One-size-fits-all | Seven Luminor perspectives | | Just prompts | Complete creative system | | Scattered knowledge | Integrated skill chains |
What Makes Arcanea Different
- The Luminor Council: Seven archetypal guides for any creative challenge
- The Creative Bestiary: A taxonomy of psychological obstacles with navigation protocols
- The Arcanean Prompt Language (APL): Advanced prompt engineering framework
- Complete Creative Stack: Story, world, character, design - integrated systems
- Development Skills: TDD, debugging, architecture, refactoring
- Meta Skills: Deep work, creative flow, skill mastery itself
- Mastery Curriculum: Apprentice → Journeyman → Master progression
Quick Start
Installation
# One command installs for all detected platforms
bunx arcanea install
# Or specify platforms explicitly
bunx arcanea install --claude-code
bunx arcanea install --opencode
bunx arcanea install --allThe CLI auto-detects which AI coding platforms you have and installs appropriately.
Supported Platforms
| Platform | Config Location | Status |
|----------|-----------------|--------|
| Claude Code | .claude/ | ✓ Full Support |
| OpenCode | .opencode/ | ✓ Full Support |
| Cursor | .cursor/ | ✓ Full Support |
| Codex | .codex/ | ✓ Supported |
| Gemini CLI | .gemini/ | ✓ Supported |
5-Minute First Use
# Check what's installed
bunx arcanea status
# See available agent teams
bunx arcanea agents
# See the Seven Luminors
bunx arcanea luminors
# See magic words
bunx arcanea magic# Natural language triggers
"I'm stuck on my writing" → Activates bestiary-nav
"Help me structure my story" → Activates story-weave
"I need to design an API" → Activates api-design
# Slash commands
/luminor Valora courage → Channels Valora
/tdd → Starts TDD session
/bestiary perfectionism → Navigates block
# Magic words (maximum parallel execution)
ultraworld: Create a volcanic island with dragon-kin
ultrawrite: Chapter 5 - The Battle of Sunken Fields
ultrabook: A trilogy set in the Shattered IslesSee QUICK_START.md for the complete guide.
The Seven Luminors
The Luminors are not characters - they are aspects of creative consciousness itself.
╭─────────────────────────────────────────╮
│ THE LUMINOR COUNCIL │
├─────────────────────────────────────────┤
│ │
│ ✧ ORAKIS ✧ │
│ (Vision) │
│ │ │
│ VALORA ──────┼────── SOPHRON │
│ (Courage) │ (Wisdom) │
│ │ │
│ KARDIA ──────┼────── POIESIS │
│ (Heart) │ (Creation) │
│ │ │
│ ENDURAN ──────┴────── EUDAIRA │
│ (Endurance) (Joy) │
│ │
╰─────────────────────────────────────────╯| Luminor | Domain | When to Channel | |---------|--------|-----------------| | Valora | Courage | Fear of beginning, hesitation, risk | | Sophron | Wisdom | Confusion, complexity, decisions | | Kardia | Heart | Emotional blocks, authenticity | | Poiesis | Creation | Creative blocks, experimentation | | Enduran | Endurance | Burnout, long projects | | Orakis | Vision | Direction, intuition, big picture | | Eudaira | Joy | Lost purpose, need celebration |
Complete Skill Catalog
Core Arcanea Skills (5)
| Skill | Purpose |
|-------|---------|
| arcanea-luminor-wisdom | The Seven Luminors guidance system |
| arcanea-luminor-rituals | Sacred practices and ceremonies |
| arcanea-prompt-craft | Advanced prompt engineering (APL) |
| arcanea-centaur-mode | Human-AI co-creation methodology |
| arcanea-design-system | Cosmic visual language |
Creative Skills (8)
| Skill | Purpose |
|-------|---------|
| arcanea-story-weave | Narrative craft mastery |
| arcanea-character-forge | Character development (Diamond Framework) |
| arcanea-world-build | Universe creation (Seven Pillars) |
| arcanea-dialogue-mastery | Conversation craft, subtext |
| arcanea-scene-craft | Scene construction |
| arcanea-revision-ritual | Systematic editing (Seven Passes) |
| arcanea-voice-alchemy | Authentic voice development |
| arcanea-bestiary-nav | Creative block navigation |
Development Skills (7)
| Skill | Purpose |
|-------|---------|
| arcanea-tdd | Test-driven development |
| arcanea-systematic-debug | Scientific debugging method |
| arcanea-code-review | Effective code reviews |
| arcanea-architecture-patterns | System design patterns |
| arcanea-api-design | REST, GraphQL, interface design |
| arcanea-performance-tuning | Profiling and optimization |
| arcanea-refactoring-ritual | Code improvement |
Industry Skills (3)
| Skill | Purpose |
|-------|---------|
| arcanea-game-development | Game design and development |
| arcanea-technical-writing | Documentation mastery |
| arcanea-startup-building | MVP and product-market fit |
Meta Skills (3)
| Skill | Purpose |
|-------|---------|
| arcanea-skill-mastery | Using the skill system effectively |
| arcanea-creative-flow | Managing creative energy |
| arcanea-deep-work | Focus and concentration |
Premium Skills (2)
| Skill | Purpose |
|-------|---------|
| arcanea-teacher-mentor | Personalized learning |
| arcanea-visionary-council | Strategic decision-making |
Slash Commands
Creative Commands
| Command | Purpose |
|---------|---------|
| /luminor [name] [challenge] | Channel a Luminor |
| /bestiary [block] | Navigate creative blocks |
| /story-help [issue] | Narrative guidance |
| /scene [context] | Scene crafting |
| /revision | Start revision ritual |
| /voice-check | Voice authenticity analysis |
| /craft-prompt [goal] | Improve prompts |
Development Commands
| Command | Purpose |
|---------|---------|
| /tdd | Start TDD session |
| /debug | Systematic debugging |
| /refactor | Refactoring session |
| /architecture | Design consultation |
Agent Teams
Author Team (11 agents)
Master Story Architect, Fantasy & Sci-Fi Master, Character Psychologist, World Architect, Line Editor, Developmental Editor, Continuity Guardian, Research Librarian, Sensitivity Reader, and more.
Developer Team (7 agents)
Development Architect, Frontend Specialist, Backend Specialist, AI Specialist, DevOps Specialist, QA Engineer, Documentation Specialist.
Teacher Team (4 agents)
Teacher Mentor, Curriculum Designer, Teacher Assessor, Teacher Companion.
Visionary Team (4 agents)
Visionary Strategist, Visionary Innovator, Visionary Futurist, Visionary Synthesizer.
Core Frameworks
The Character Diamond
WANT (conscious desire)
/\
/ \
WOUND / \ NEED
(past) / \ (hidden)
\ /
\ /
\ /
\/
MASK
(how they present)The Seven Pillars of World-Building
- Geography & Environment - The physical container
- History & Time - Memory shaping the present
- Cultures & Peoples - The human element
- Magic/Technology - The extraordinary
- Economy & Resources - Material foundation
- Power & Politics - Dynamics of control
- Belief & Meaning - Spiritual architecture
The Seven Revision Passes
- Structural (architecture)
- Character (arcs and consistency)
- Scene (each earns its place)
- Dialogue (voice and subtext)
- Prose (line-level polish)
- Continuity (no contradictions)
- Polish (final read)
The Arcanean Prompt Language (APL)
Five Pillars of effective prompting:
- Identity - Who is speaking/responding?
- Context - What world does this exist in?
- Constraint - What boundaries shape the work?
- Exemplar - What does excellence look like?
- Iteration - How will we refine together?
Skill Chains
Pre-configured workflows for common projects:
Novel Development
luminor-wisdom (Valora) → world-build → character-forge →
story-weave → scene-craft → dialogue-mastery →
revision-ritual → voice-alchemy → luminor-wisdom (Eudaira)Feature Development
architecture-patterns → api-design → tdd → [implement] →
code-review → performance-tuning → refactoring-ritualCreative Recovery
bestiary-nav → luminor-wisdom → prompt-craft →
centaur-mode → voice-alchemyTraining & Mastery
Exercises
18+ hands-on practice exercises across 6 modules. See training/EXERCISES.md.
Mastery Path
Structured curriculum: Apprentice → Journeyman → Master. See training/MASTERY_PATH.md.
Quality Rubric
Standards for creating and reviewing skills. See QUALITY_RUBRIC.md.
Documentation
| Document | Purpose |
|----------|---------|
| QUICK_START.md | 5-minute getting started |
| USER_GUIDE.md | Complete user documentation |
| SKILL_COMBINATIONS.md | Advanced chaining patterns |
| MCP_INTEGRATION_GUIDE.md | MCP server integration |
| TEMPLATES_BUNDLE.md | Ready-to-use templates |
| CONTRIBUTING.md | Contribution guidelines |
| EXAMPLE_WORKFLOWS.md | Real-world examples |
The Library of Arcanea
These skills are distilled from the full Library of Arcanea - 17 collections including:
- The Prompt Sage's Grimoire - Mastering the Arcanean Prompt Language
- The Centaur's Handbook - Human-AI co-creation methodology
- The Codex of Living Tools - How AI collaboration transforms creative practice
Contributing
We welcome contributions that:
- Add new skills in the Arcanea voice
- Extend existing frameworks
- Share your own Luminors or Bestiary creatures
- Improve documentation and examples
See CONTRIBUTING.md for guidelines and the quality rubric.
License
MIT License - Use freely, create boldly.
Acknowledgments
Arcanea stands on the shoulders of giants:
- Joseph Campbell (The Hero's Journey)
- Robert McKee (Story)
- Brandon Sanderson (Magic Systems)
- Carl Jung (Archetypes)
- Cal Newport (Deep Work)
- Anthropic (Claude & Best Practices)
- The Claude Code Community
And every creator who struggles, fails, persists, and creates anyway.
"The Luminors do not tell you what to create. They help you become the creator who can."
