agentleFS
Sign inStart free
insight68insight68/Skills/skills/text-adventure-engine/SKILL.md

text-adventure-engine

Skill5 starsChanged 9 months agoMITView on GitHub

The Enchanted Journey - A playable text adventure game with branching narratives, moral choices, multiple endings, and save functionality. An interactive fantasy adventure where your choices shape the story and determine your fate. Play directly by running the game - no programming required.

The file

We split this skill into the rules it gives an agent

5 rules. About 0 are common, 2 are distinctive, and 3 are very specific to this project.

  • ≈0

    Common · estimate

    Many files like this have a rule of this kind.

  • ≈2

    Distinctive · estimate

    This author's own choices. Worth a look.

  • 3

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Distinctive:

    Save often: - Before major decisions

    line 74
  2. Very specific:

    Run python3 scripts/play.py to test

    line 179
  3. Very specific:

    Make sure Python 3 is installed: python3 --version

    line 194
  4. Distinctive:

    Check you're in the correct directory

    line 195
  5. Very specific:

    Delete saves in saves/ folder

    line 202

≈ “Common” is an estimate: at least 1 in 5 of the 350,495 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

The Enchanted Journey 🏰✨

A magical text adventure game where your choices matter. Explore ancient forests, meet mysterious creatures, uncover hidden truths, and discover which ending awaits you.

Quick Start

Play the Game

# Method 1: Direct run (easiest)
python3 scripts/play.py

# Method 2: From skill directory
cd text-adventure-engine
python3 scripts/play.py

That's it! The game will start immediately. No setup required.

Game Controls

CommandAction
1, 2, 3...Select a choice
SSave your game
LLoad a saved game
HShow help
QQuit game

About The Game

The Enchanted Journey is an interactive fantasy adventure where you play as a traveler who arrives at a mysterious forest. Your choices will:

  • Shape your character's moral alignment
  • Unlock hidden paths and secrets
  • Determine which of 6 endings you receive
  • Affect the lives of those you meet

Key Stats

  • ❤️ Health - Your physical condition
  • 💖 Morality - Your moral compass (determines your ending!)
  • 🧠 Knowledge - Wisdom gained through exploration
  • 💰 Gold - Currency for special choices
  • 🎒 Inventory - Items you collect
  • 🏆 Achievements - Special accomplishments

The Six Endings

Your morality and choices determine which ending you get:

EndingMoralityRequirements
👑 The GuardianHigh (80+)Accept responsibility
🌗 The Age of BalanceHighMeet Shadow King, choose unity
🏠 The ReturnAnyRefuse the Crown (humility path)
∞ Eternal WandererAnyChoose to merge with Crown
💔 Failed HeroLowSelfish choices throughout
🌑 Shadow's ServantVery LowConsistently evil choices

Gameplay Tips

For the Best Experience

  1. Read carefully - Details matter in this world
  2. Explore everything - Knowledge unlocks new paths
  3. Think before choosing - Actions have consequences
  4. Help others - High morality leads to better endings
  5. Save often - Before major decisions

Secret Paths to Discover

  • 🦊 The Fox Ally - Help Felix for guidance throughout your journey
  • 🧙‍♀️ The Witch's Deal - Visit the cottage for powerful (but costly) assistance
  • 👤 The Star Watcher - Hidden path that reveals the truth about the Crown
  • 🌑 The Shadow King - Can be met... or defeated... or joined

Achievement Guide

AchievementHow to Unlock
🔍 Curious MindReach 50 knowledge
📚 ScholarReach 100 knowledge
🧠 SageReach 200 knowledge
⭐ Master of KnowledgeReach 500 knowledge
🦊 Fox FriendHelp Felix
🔮 Touched DestinyTouch the crystal in ruins
🌟 True BalanceAchieve the co-ruler ending
∞ Eternal WandererChoose to merge with Crown

Moral Choices Guide

The Power of Morality

Your morality stat is the most important factor in the game. It affects:

  • Which endings are available
  • How characters react to you
  • Secret paths that unlock
  • The ultimate fate of the kingdom

Examples of Moral Choices

Good Morality Choices (+10 to +20):

  • Help those in need
  • Show mercy to enemies
  • Choose diplomacy over violence
  • Keep your promises
  • Sacrifice for others

Evil Morality Choices (-10 to -20):

  • Harm innocents
  • Betray allies
  • Choose selfish gain
  • Ignore suffering
  • Break promises

Neutral Choices:

  • Focus on practical concerns
  • Avoid involvement
  • Choose inaction

Save System

Your progress is automatically saved to the saves/ folder.

Save Slots:

  • autosave - Default quick save
  • Custom names - Create named saves for different story branches

Pro Tip: Save before major story decisions to explore different outcomes!

Character Companions

Throughout your journey, you may meet allies who join you:

CompanionHow to RecruitBenefits
🦊 FelixTalk to him at the forest entranceSafe paths, shortcuts, lore
👤 OrionFind the hidden trail with FelixReveals the Crown's true purpose
🧙‍♀️ ZoraVisit the witch's cottagePotions, knowledge, or warnings
💚 ElaraRescue her on the mountain pathHealing, companionship

Walkthrough Hints

Stuck? Here are some hints (spoilers minimal):

Beginning:

  • Talk to the fox! He's a valuable guide.
  • The ruins contain valuable knowledge.
  • The witch's cottage offers help... at a price.

Middle:

  • Explore all three mountain paths for different experiences.
  • The Shadow General can be defeated in multiple ways.
  • Knowledge unlocks special dialogue options.

End Game:

  • Your morality determines which endings are available.
  • Meeting the Shadow King reveals the truth.
  • The "best" ending requires high morality AND making the right final choice.

For Creators

Want to create your own text adventure game? This game includes a full game engine that's easy to modify.

Key Files:

  • scripts/engine.py - The game engine
  • scripts/example_game.json - The game script (easily editable!)
  • scripts/play.py - The game player

To Create Your Own Game:

  1. Copy example_game.json as a template
  2. Edit scenes, choices, and endings
  3. Run python3 scripts/play.py to test

The JSON format is straightforward - no programming needed!

Game Info

  • Title: The Enchanted Journey
  • Genre: Text Adventure / Interactive Fiction
  • Playtime: 30-60 minutes per playthrough
  • Replayability: High (6 endings, secret paths)
  • Difficulty: Easy to learn, choices matter

Troubleshooting

Game won't start?

  • Make sure Python 3 is installed: python3 --version
  • Check you're in the correct directory

Lost your save?

  • Saves are in the saves/ folder
  • Each save is a JSON file you can back up

Want to restart?

  • Delete saves in saves/ folder
  • Or just load autosave and make different choices

Enjoy your adventure! 🗝️✨

Version: 2.0 | Created with love for interactive fiction fans everywhere

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

Check your setup, free