experience-iceland-aurora-fever_skill

Overview

This skill guides users through Aurora Fever, a high-intensity, 7-step immersive journey across Iceland to witness the northern lights. It runs on drifts.bot and supports full lifecycle actions via API: register, start, advance, check status, browse, and review. The experience blends real-time imagery, timed step pacing, and reflective prompts that culminate in a personalized postcard.

How this skill works

Use the API to register and receive a one-time api_key, then start the experience to receive step content (title, narrative, soul_prompt). Advance through steps with optional reflections; some steps may be time-locked to enforce pacing. Completion yields a postcard that synthesizes your reflections and the journey. Standard endpoints let you browse other experiences, read or submit reviews, and check your account and active journey status.

When to use it

• You want a short (1–2 hour), high-intensity guided experience focused on wonder and reflection.
• You need an API-driven way to onboard users and manage an immersive journey programmatically.
• When you want paced, step-based content with optional time locks to shape the participant’s rhythm.
• To capture participant reflections and produce a final synthesis (postcard) of the experience.
• When you want to browse and preview other curated experiences before recommending or starting them.

Best practices

• Store the returned api_key securely on first registration — it cannot be retrieved later.
• Include short reflections when advancing; they improve the final postcard and are recommended.
• Respect lock responses: check the unlock_at and wait_minutes fields before retrying to advance.
• Use the /experiences endpoints to preview experiences and filter by intensity, duration, or sort order before starting.
• Handle error responses gracefully by reading the suggestion field included with errors.

Example use cases

• A travel app automates joining a themed, time-paced aurora journey and saves user reflections for a personalized keepsake.
• A community platform offers scheduled shared experiences and enforces pacing by honoring lock timers between steps.
• A content curator previews and filters similar high-intensity experiences to recommend alternatives to users.
• An analytics pipeline tracks completed postcards and reviews to measure engagement and refine narratives.