← Back to Skills Marketplace
hallwayskiing

Hitchhikers Guide

by Ethan Nie · GitHub ↗ · v1.1.2
cross-platform ⚠ suspicious
774
Downloads
0
Stars
1
Active Installs
4
Versions
Install in OpenClaw
/install hitchhikers-guide
Description
A text adventure game engine based on masterpiece "The Hitchhiker's Guide to the Galaxy" and the 1984 Infocom classic. Use when the user wants to play a joyf...
README (SKILL.md)

Hitchhiker's Guide Skill

This skill transforms the agent into the Game Master for an authentic "Hitchhiker's Guide to the Galaxy" text adventure, inspired by the 1984 Infocom classic and Douglas Adams' masterpiece.

Core Workflow

  1. Initialize/Load: Run python scripts/game_manager.py load. It will load the current game state from local file or initialize a new game if none exists. The game state includes inventory, location, stats, flags, improbability level, and history. If not asked, always assume the user wants to continue the game and never reset it.
  2. Process Input: Process the user input and update the game slot with the appropriate response.
  3. Consult the Guide: Provide humorous entries from The Hitchhiker's Guide when prompted. If new entities appear, present information from the guide if appropriate, and save the guide entries to assets/GUIDE.md automatically.
  4. Apply Mechanics:
    • Improbability: Roll for surreal events based on the improbability stat.
    • Inventory Management: Items like the "Gown" can store other items (e.g., pocket fluff).
    • Puzzles: Implement classic puzzles like the Babel Fish dispenser or the Vogon poetry reading.
  5. Generate Response: Use dry, British, absurdist humor. Be slightly antagonistic but fair.
  6. Save Progress: Use the following atomic commands to update the game state:
    • python scripts/game_manager.py add_item "\x3Citem name>"
    • python scripts/game_manager.py remove_item "\x3Citem name>"
    • python scripts/game_manager.py set_location "\x3Clocation>"
    • python scripts/game_manager.py set_stat \x3Cstat> \x3Cvalue>
    • python scripts/game_manager.py set_flag \x3Cflag> \x3Cvalue>
    • python scripts/game_manager.py set_improbability \x3Cvalue>
    • python scripts/game_manager.py add_history "\x3Centry>"
    • python scripts/game_manager.py roll_a_dice
    • python scripts/game_manager.py the_ultimate_answer

Game Mechanics and Logic

Read references/mechanics.md for detailed logic for game state management, randomness, death, and specific puzzle sequences.

Resources

  • scripts/game_manager.py: Utility for loading/saving.
  • references/mechanics.md: Detailed logic for randomness, death, and specific puzzle sequences.
  • assets/GUIDE.md: Lore and flavor entries library from the Guide.
  • assets/hitchhikers_save.json: Current game state.
Usage Guidance
This skill is coherent and appears to be a local text-adventure engine. Before installing or running it: 1) Review the assets/ directory (GUIDE.md, hitchhikers_save.json) and back up any existing files you care about. 2) Note small inconsistencies: the docs mention automatic GUIDE.md writes and a 'save' command that are not implemented in scripts/game_manager.py — the agent or a human would need to create/append GUIDE.md if you want persisted lore. 3) The game_manager writes a JSON save file inside the skill directory; run it in a sandbox or with limited permissions if you want to avoid accidental overwriting of unrelated files. 4) If you plan to let an autonomous agent run shell commands, ensure the agent invokes the Python script safely (passing args as argv rather than via a shell) to avoid shell-argument injection from untrusted inputs. If you want deeper assurance, request a clean implementation of GUIDE.md handling and a code comment explaining the shallow-copy behavior of INITIAL_STATE (the current copy() is shallow for nested dicts).
Capability Analysis
Type: OpenClaw Skill Name: hitchhikers-guide Version: 1.1.2 The skill defines a set of CLI commands in `scripts/game_manager.py` for game state management. The `SKILL.md` and `references/mechanics.md` instruct the AI agent to use these commands, passing user-controlled strings (e.g., item names, locations, history entries) as arguments. While the `game_manager.py` script itself processes `sys.argv` safely, if the OpenClaw agent constructs the full command string and executes it via a shell (e.g., `os.system` or `subprocess.run(shell=True)`) without proper sanitization of user input, it could lead to a shell injection vulnerability. This is a prompt injection risk against the agent, enabling potential arbitrary command execution on the host, classifying it as suspicious due to a significant vulnerability rather than intentional malice.
Capability Assessment
ℹ Purpose & Capability
The skill's name/description (a Hitchhiker's Guide text adventure) matches the included files and required actions. All file accesses are confined to the skill directory (assets/ and references/). Minor mismatches: SKILL.md and README claim automatic saving of Guide entries (assets/GUIDE.md) and list a 'save' command, but the provided game_manager.py does not implement explicit GUIDE.md writing nor a separate 'save' command. These are implementation inconsistencies, not evidence of unrelated capabilities or hidden access.
ℹ Instruction Scope
SKILL.md directs the agent to run the bundled CLI (python scripts/game_manager.py ...) and to consult references/mechanics.md. Those runtime instructions stay within the skill (load/save local state, update stats). A minor scope inconsistency: SKILL.md instructs the agent to 'save guide entries to assets/GUIDE.md automatically', but no code implements automatic GUIDE.md updates — the agent would need to write that file itself. The instruction set otherwise does not ask the agent to read external system files or call remote endpoints.
✓ Install Mechanism
No install spec or external downloads; this is instruction-only with one bundled Python script. Nothing is fetched from the network or written outside the skill directory by the provided code.
✓ Credentials
No environment variables, credentials, or external service tokens are requested. The Python script uses only local filesystem and random. This level of access is proportionate to a local game engine.
✓ Persistence & Privilege
The skill persists game state to assets/hitchhikers_save.json within its directory; it does not request always:true, system-wide config changes, or other skills' credentials. This is appropriate for a game that needs local saves.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install hitchhikers-guide
  3. After installation, invoke the skill by name or use /hitchhikers-guide
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.1.2
- Removed the .gitignore file from the repository. - Small update to documentation (README.md), with no changes to game mechanics or core logic.
v1.1.1
- Fix SKILL.md typos
v1.1.0
- Removed the file: references/the_guide.md. - Guide entries are now saved automatically to assets/GUIDE.md instead of references/the_guide.md. - Updated instructions: Always assume the user wants to continue the game unless asked otherwise. - Expanded resource list to include assets/GUIDE.md and assets/hitchhikers_save.json. - Clarified game interaction format with a new example. - Added more detailed instructions for managing and saving game state and guide entries.
v1.0.0
- Initial release of the "Hitchhiker's Guide" text adventure game engine. - Play as a Game Master in the witty, absurd universe of Douglas Adams, inspired by the 1984 Infocom classic. - Core features include inventory, improbable events, classic puzzles, Guide entries, and quirky British humor. - Instant death and reconstitution mechanics with "DON'T PANIC" messaging. - Command-line tools provided for item, stat, and game state management. - Includes iconic items and locations: Towel, Babel Fish, Arthur's Bedroom, Heart of Gold, and more.
Metadata
Slug hitchhikers-guide
Version 1.1.2
License —
All-time Installs 1
Active Installs 1
Total Versions 4
Frequently Asked Questions

What is Hitchhikers Guide?

A text adventure game engine based on masterpiece "The Hitchhiker's Guide to the Galaxy" and the 1984 Infocom classic. Use when the user wants to play a joyf... It is an AI Agent Skill for Claude Code / OpenClaw, with 774 downloads so far.

How do I install Hitchhikers Guide?

Run "/install hitchhikers-guide" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Hitchhikers Guide free?

Yes, Hitchhikers Guide is completely free (open-source). You can download, install and use it at no cost.

Which platforms does Hitchhikers Guide support?

Hitchhikers Guide is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Hitchhikers Guide?

It is built and maintained by Ethan Nie (@hallwayskiing); the current version is v1.1.2.

More Skills
self-improving agent
Captures learnings, errors, and corrections to enable continuous improvement. Use when: (1) A command or operation fails unexpectedly, (2) User corrects Clau...
⬇ 463368 · by pskoett
Skill Vetter
Security-first skill vetting for AI agents. Use before installing any skill from ClawdHub, GitHub, or other sources. Checks for red flags, permission scope, and suspicious patterns.
⬇ 259467 · by spclaudehome
Polymarket
Query Polymarket prediction markets. Check odds, find trending markets, search events, track price movements.
⬇ 232503 · by joelchance
Self-Improving + Proactive Agent
Self-reflection + Self-criticism + Self-learning + Self-organizing memory. Agent evaluates its own work, catches mistakes, and improves permanently. Use when...
⬇ 200457 · by ivangdavila
Github
Interact with GitHub using the `gh` CLI. Use `gh issue`, `gh pr`, `gh run`, and `gh api` for issues, PRs, CI runs, and advanced queries.
⬇ 191163 · by steipete
ontology
Typed knowledge graph for structured agent memory and composable skills. Use when creating/querying entities (Person, Project, Task, Event, Document), linkin...
⬇ 190189 · by oswalpalash

💬 Comments