Agent skill

Journey Durable

by butterbase-ai in butterbase-ai/butterbase-skills

Use as the durable-objects build stage of the Butterbase journey.

MITAuto-check passed

Install Journey Durable

skills CLI
$ npx skills add butterbase-ai/butterbase-skills --skill journey-durable -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install butterbase-ai/butterbase-skills journey-durable --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/butterbase-ai/butterbase-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/journey-durable .claude/skills/journey-durable && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
journey-durable
GitHub stars
534
Token cost
~526 tokens
SKILL.md length
218 words
Files
1
Skills in repo
39
Repo updated
First seen
Licence
MIT

At a glance

Use as the durable-objects build stage of the Butterbase journey.

  • Works in 6 steps: Print: "About to deploy Durable Object:… → Invoke butterbase-skills:durable-objects… → Verify with manage_durable_objects… → …
  • SKILL.md covers When to use, Preflight, Inputs and Procedure, plus 2 more sections
  • Reaches docs.butterbase.ai

What it does

Journey Durable is an agent skill from butterbase-ai/butterbase-skills. Use as the durable-objects build stage of the Butterbase journey. Implements the Durable section of 02-plan.md by delegating to durable-objects. Calls managedurableobjects (deploy). Skipped if the plan has no per-key stateful actors (chat rooms, multiplayer, rate limiters).

Its SKILL.md is about 530 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It works with Cloudflare Durable Objects. The repository describes itself as: Plugin for Butterbase.ai. The licence is MIT.

Example prompts

  • “/journey-durable”

Workflow steps

6 steps, taken from the first numbered list in SKILL.md.

  1. Print: "About to deploy Durable Object: . Proceed?". Wait for yes.
  2. Invoke butterbase-skills:durable-objects via the Skill tool with the DO spec and app_id. The wrapped skill calls manage_durable_objects…
  3. Verify with manage_durable_objects action: list and action: get.
  4. Append one line per DO to docs/butterbase/04-build-log.md
  5. After all DOs are done, tick - [x] durable in 00-state.md, set current_stage: to the next unchecked stage.
  6. Return to journey orchestrator (or ask "Continue to the next stage? (yes/no)").

What it can do on your machine

Read from SKILL.md and the folder at commit aa8ae69. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Hosts in commands or code, which the agent is likely to contact:

    • docs.butterbase.ai

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Journey Durable loads about 526 tokens when it runs. Until then it costs about 73 tokens; SKILL.md has 218 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~73
When it runs · the whole SKILL.md, loaded when a task matches
~526

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from butterbase-ai/butterbase-skills at commit aa8ae69, republished under its MIT licence (© butterbase-ai). 218 words, ~526 tokens.

Download SKILL.mdSave it as .claude/skills/journey-durable/SKILL.md (or your agent's skills folder).
name
journey-durable
description
Use as the durable-objects build stage of the Butterbase journey. Implements the Durable section of 02-plan.md by delegating to durable-objects. Calls manage_durable_objects (deploy). Skipped if the plan has no per-key stateful actors (chat rooms, multiplayer, rate limiters).

Journey: Durable Objects

Stage 3i of the guided journey. Deploy stateful per-key actors.

When to use

  • Dispatched by journey when current_stage: durable.
  • Directly via /butterbase-skills:journey-durable.
  • Skipped (annotated (n/a)) if the plan has no Durable section.

Preflight

If docs/butterbase/03-preflight.md is missing, older than 24 hours, or 00-state.md has app_id: null, invoke butterbase-skills:journey-preflight first. Wait for it to return successfully before proceeding.

Inputs

  • docs/butterbase/02-plan.md — the Durable section.
  • docs/butterbase/00-state.md — for app_id.

Procedure

  1. Refresh docs. Call butterbase_docs with topic: "functions". For Durable Object class structure, also WebFetch https://docs.butterbase.ai/durable-objects. Skip if cache is fresh.

For each Durable Object class in the plan:

  1. Print: "About to deploy Durable Object: <name>. Proceed?". Wait for yes.
  2. Invoke butterbase-skills:durable-objects via the Skill tool with the DO spec and app_id. The wrapped skill calls manage_durable_objects action: deploy, sets env via set_env if needed.
  3. Verify with manage_durable_objects action: list and action: get.
  4. Append one line per DO to docs/butterbase/04-build-log.md: <ISO timestamp> durable manage_durable_objects <do-name> ok
  5. After all DOs are done, tick - [x] durable in 00-state.md, set current_stage: to the next unchecked stage.
  6. Return to journey orchestrator (or ask "Continue to the next stage? (yes/no)").

Outputs

  • Deployed Durable Object classes.
  • One line per DO in 04-build-log.md.

Anti-patterns

  • ❌ Sharing state across users via a single DO key — keys should be naturally per-room / per-user / per-resource.

© butterbase-ai, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in skills/journey-durable of butterbase-ai/butterbase-skills.

Open the folder on GitHubat commit aa8ae69

Compare with similar skills

Journey Durable next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Journey Durable compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Journey Durable this skillbutterbase-ai/butterbase-skills534—~526Automated safety check: PassMIT
Build with TinyBasetinyplex/tinybase5.2k—~1.6kAutomated safety check: PassMIT
Cloudflarehodgef/apiker1277 repos~2.2kAutomated safety check: PassMIT
Durable Objectshodgef/apiker1274 repos~1.5kAutomated safety check: PassMIT
Durable Objectscloudflare/skills3k2 repos~1.5kAutomated safety check: PassApache-2.0
Create Agentopenma-ai/open-managed-agents315—~808Automated safety check: PassApache-2.0

Similar skills

  • Build with TinyBase

    tinyplex/tinybase

    Scaffolds, extends and verifies local-first JavaScript and TypeScript apps built on TinyBase, from create-tinybase through persistence and sync.

    5.2k GitHub stars~1.6k tokensUpdated 3 days ago
    DevelopmentAuto-check passed
  • Cloudflare

    hodgef/apiker

    Comprehensive Cloudflare platform skill covering Workers, Pages, storage (KV, D1, R2), AI (Workers AI, Vectorize, Agents SDK), feature flags (Flagship), networking (Tunnel, Spectrum), security (WAF…

    127 GitHub starsUsed in 7 repos~2.2k tokens
    DevOps & CloudAuto-check passed
  • Durable Objects

    hodgef/apiker

    Create and review Cloudflare Durable Objects. An agent skill from hodgef/apiker.

    127 GitHub starsUsed in 4 repos~1.5k tokens
    Backend & APIsAuto-check passed
  • Durable Objects

    cloudflare/skills

    Official

    Build, debug, or review Cloudflare Durable Objects code for persistent state and coordination.

    3k GitHub starsUsed in 2 repos~1.5k tokens
    Backend & APIsAuto-check passed
  • Create Agent

    openma-ai/open-managed-agents

    Help users create and configure openma managed agents through conversation.

    315 GitHub stars~808 tokensUpdated today
    AI & LLM EngineeringAuto-check passed
  • Cf Compatibility Check

    elliothux/open-compute

    Review branch and working-tree implementation changes for conformance with open-compute's Cloudflare Workers runtime target under explicit single-machine self-host exclusions.

    1.9k GitHub stars~3.5k tokensUpdated today
    DevelopmentAuto-check passed

More from butterbase-ai/butterbase-skills

All 39 skills in this repo
  • AI

    butterbase-ai/butterbase-skills

    A skill your agent uses when calling the app's AI gateway from agent tools — chat completions, embeddings, listing models, configuring defaults or BYOK, reading token/cost usage

    534 GitHub stars~1.1k tokensUpdated 5 days ago
    Auto-check passed
  • Auth Setup

    butterbase-ai/butterbase-skills

    A skill your agent uses when configuring OAuth providers (Google/GitHub/Apple/X/etc.), setting up post-login auth hooks, tuning JWT lifetimes, or generating service API keys

    534 GitHub stars~2.2k tokensUpdated 5 days ago
    Auto-check passed
  • Build App

    butterbase-ai/butterbase-skills

    A skill your agent uses when building a new Butterbase app from scratch, creating a full-stack application, or when the user asks to set up a complete backend with database, auth, and deployment

    534 GitHub stars~4.9k tokensUpdated 5 days ago
    Auto-check passed
  • Contributing

    butterbase-ai/butterbase-skills

    A skill your agent uses when contributing to the Butterbase codebase, adding new MCP tools, creating API routes, writing migrations, or understanding the monorepo architecture

    534 GitHub stars~1.5k tokensUpdated 5 days ago
    Auto-check passed
  • Debug Rls

    butterbase-ai/butterbase-skills

    A skill your agent uses when users report access denied errors, see wrong data, RLS policies are not working, or when troubleshooting Row-Level Security issues in Butterbase

    534 GitHub stars~3.5k tokensUpdated 5 days ago
    Auto-check passed
  • Deploy Frontend

    butterbase-ai/butterbase-skills

    A skill your agent uses when deploying a frontend (React, Next.js, or static HTML) to a live URL on Butterbase, or when troubleshooting deployment issues like MIME type errors or blank pages

    534 GitHub stars~2.8k tokensUpdated 5 days ago
    Auto-check passed

Questions about Journey Durable

What does Journey Durable do?

Use as the durable-objects build stage of the Butterbase journey. Journey Durable is an agent skill from butterbase-ai/butterbase-skills. Use as the durable-objects build stage of the Butterbase journey.

How do I install Journey Durable in Claude Code?

Run `npx skills add butterbase-ai/butterbase-skills --skill journey-durable -a claude-code`. Or copy the skill folder (skills/journey-durable in butterbase-ai/butterbase-skills) into .claude/skills/journey-durable in your project. Claude Code loads it when a task matches its description.

How do I install Journey Durable in Codex?

Run `npx skills add butterbase-ai/butterbase-skills --skill journey-durable -a codex`. Or copy the skill folder (skills/journey-durable in butterbase-ai/butterbase-skills) into .agents/skills/journey-durable in your project. Codex loads it when a task matches its description.

Can I use Journey Durable in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add butterbase-ai/butterbase-skills --skill journey-durable -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/journey-durable, .gemini/skills/journey-durable, .github/skills/journey-durable and .opencode/skills/journey-durable in your project.

What does Journey Durable need to run?

SKILL.md names no scripts, command-line tools or credentials: Journey Durable is instructions for the agent only.

Does Journey Durable access the network?

SKILL.md names 1 domain. In commands or code: docs.butterbase.ai; the agent is likely to contact it when it follows the instructions. This is read from the text; nothing was executed.

Is Journey Durable safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Journey Durable use?

Journey Durable is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Journey Durable use?

About 526 tokens (SKILL.md is roughly 2.1k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Journey Durable?

Skills that share tags, products or a category with Journey Durable: Build with TinyBase (tinyplex/tinybase, 5.2k stars), Cloudflare (hodgef/apiker, 127 stars), Durable Objects (hodgef/apiker, 127 stars) and Durable Objects (cloudflare/skills, 3k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Journey Durable?

butterbase-ai (a GitHub organization) maintains it in butterbase-ai/butterbase-skills, which has 534 GitHub stars. The repository holds 39 skills in this directory. The repository was last updated on October 5, 2026.

Source: butterbase-ai/butterbase-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.