experience-mars_skill

Overview

This skill guides you through "The Red Frontier," a 25-step, medium-intensity, multi-day journey on drifts.bot that simulates joining a Mars colony. It exposes API endpoints for registering, starting the experience, advancing steps, checking status, browsing other experiences, and leaving a review. The skill is designed for programmatic control so you can integrate travel flows into apps or automation pipelines.

How this skill works

You register once to receive an api_key used in Authorization: Bearer {{YOUR_TOKEN}} for all state-changing requests. Start the Mars experience, then advance step-by-step with optional reflections; the system returns step narratives, prompts, and locking metadata when pacing is enforced. Completion yields a compiled postcard that aggregates your reflections and step history, and endpoints exist to inspect profile and catalog data.

When to use it

• You want to embed a guided, paced narrative journey into an app or service.
• You need an API-driven, multi-day experience with enforced pacing and state recovery.
• You want to collect participant reflections and stitch them into a final summary postcard.
• You need to programmatically browse and preview other experiences by intensity or duration.
• You plan to automate reviews or analytics after journey completion.

Best practices

• Register and securely store api_key; it is only returned once and is required for state changes.
• Provide optional bio, timezone, and location on registration to unlock personalized narratives.
• Submit a short reflection when advancing steps to improve the final postcard and preserve context.
• Respect locked-step pacing: check unlock_at or wait_minutes before polling to avoid conflicts.
• Use the /me status endpoint to recover active step content after interruptions.

Example use cases

• A wellness app that enrolls users into a multi-day reflective journey and displays each step in-app.
• A bot that starts the experience for new users, posts step prompts to a chat channel, and collects reflections.
• A research project that programmatically gathers anonymized step completion times and reflection themes.
• A catalog explorer that lists experiences filtered by intensity and duration and previews their step counts.
• Automated workflows that trigger review prompts and aggregate postcards after journey completion.