Agent skill

Journey Deploy

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

Use as the deploy-verification stage of the Butterbase journey, after journey-frontend (or after any build stage if there is no frontend).

MITAuto-check passedTesting & QA

Install Journey Deploy

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

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

GitHub CLI
$ gh skill install butterbase-ai/butterbase-skills journey-deploy --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-deploy .claude/skills/journey-deploy && 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-deploy
GitHub stars
534
Token cost
~666 tokens
SKILL.md length
291 words
Files
1
Skills in repo
39
Repo updated
First seen
Licence
MIT

At a glance

Use as the deploy-verification stage of the Butterbase journey, after journey-frontend (or after any build stage if there is no frontend).

  • Works in 6 steps: Frontend reachable. If deployed_url is… → Functions respond. For each function in… → Auth round-trip (if configured). If the… → …
  • Tasks that involve QA and bug reports
  • SKILL.md covers When to use, Preflight, Inputs and Procedure, plus 2 more sections
  • Calls curl; reaches docs.butterbase.ai

What it does

Journey Deploy is an agent skill from butterbase-ai/butterbase-skills. Use as the deploy-verification stage of the Butterbase journey, after journey-frontend (or after any build stage if there is no frontend). Smoke-tests the deployed app — hits the live URL, invokes any deployed functions, checks auth round-trip. Writes results to docs/butterbase/04-build-log.md. Blocks journey-submit if smoke fails.

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

It sits in Testing & QA, covering QA and bug reports. The repository describes itself as: Plugin for Butterbase.ai. The licence is MIT.

When your agent uses it

  • Tasks that involve QA and bug reports

Example prompts

  • “/journey-deploy”

Workflow steps

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

  1. Frontend reachable. If deployed_url is set, fetch it via Bash curl -sS -o /dev/null -w "%{http_code}" . Expect 200. Log deploy curl 200 ok…
  2. Functions respond. For each function in the plan with HTTP trigger, call mcpbutterbaseinvoke_function with a representative payload…
  3. Auth round-trip (if configured). If the plan included OAuth, prompt the user: "Open , click 'Sign in with ', and confirm you land…
  4. Function logs clean. Call mcpbutterbasemanage_function action: get_logs for the most recent invocations. Show the user any error-level…
  5. If all checks pass, tick - [x] deploy in 00-state.md, set current_stage: submit (if hackathon_mode: true) or current_stage: done…
  6. Return to journey orchestrator.

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

    Shell commands in SKILL.md call:

    • curl

    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 Deploy loads about 666 tokens when it runs. Until then it costs about 87 tokens; SKILL.md has 291 words of instructions outside code blocks.

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

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). 291 words, ~666 tokens.

Download SKILL.mdSave it as .claude/skills/journey-deploy/SKILL.md (or your agent's skills folder).
name
journey-deploy
description
Use as the deploy-verification stage of the Butterbase journey, after journey-frontend (or after any build stage if there is no frontend). Smoke-tests the deployed app — hits the live URL, invokes any deployed functions, checks auth round-trip. Writes results to docs/butterbase/04-build-log.md. Blocks journey-submit if smoke fails.

Journey: Deploy verification

Stage 4 of the guided journey. Verify the deployed app actually works end-to-end.

When to use

  • Dispatched by journey when current_stage: deploy.
  • Directly via /butterbase-skills:journey-deploy.

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/00-state.md — for app_id, deployed_url.
  • docs/butterbase/02-plan.md — for the function list to smoke.
  • docs/butterbase/04-build-log.md — to know what shipped.

Procedure

  1. Refresh docs. Call butterbase_docs with topic: "frontend". For end-to-end smoke patterns, also WebFetch https://docs.butterbase.ai/deploy. Skip if cache is fresh.

For each check, log a one-line result to 04-build-log.md. Halt on the first ✗ and ask the user to fix or skip.

  1. Frontend reachable. If deployed_url is set, fetch it via Bash curl -sS -o /dev/null -w "%{http_code}" <url>. Expect 200. Log <ISO> deploy curl 200 ok or ... <code> fail.

  2. Functions respond. For each function in the plan with HTTP trigger, call mcp__butterbase__invoke_function with a representative payload. Expect 2xx. Log per function.

  3. Auth round-trip (if configured). If the plan included OAuth, prompt the user: "Open <deployed_url>, click 'Sign in with <provider>', and confirm you land logged-in. Did it work? (yes/no)". Log the answer.

  4. Function logs clean. Call mcp__butterbase__manage_function action: get_logs for the most recent invocations. Show the user any error-level lines. Ask: "Anything concerning here? (no → continue, yes → fix and re-run)".

  5. If all checks pass, tick - [x] deploy in 00-state.md, set current_stage: submit (if hackathon_mode: true) or current_stage: done (otherwise).

  6. Return to journey orchestrator.

Outputs

  • Multiple lines in 04-build-log.md.
  • Updated 00-state.md.

Anti-patterns

  • ❌ Treating a 200 from the frontend root as proof the app works — actually invoke a function.
  • ❌ Skipping the auth round-trip check just because OAuth is configured server-side — judges will try to log in.

© 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-deploy of butterbase-ai/butterbase-skills.

Open the folder on GitHubat commit aa8ae69

Compare with similar skills

Journey Deploy 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 Deploy compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Journey Deploy this skillbutterbase-ai/butterbase-skills534—~666Automated safety check: PassMIT
Reproduce Chat Statesdifferent-ai/openwork24k—~673Automated safety check: PassCustom licence
Visual QA For Web And Terminal UIscode-yeongyu/oh-my-openagent70k—~9.5kAutomated safety check: PassCustom licence
Test And Breakrohunj/claude-build-workflow231—~1.6kAutomated safety check: PassNone
Verify Form Validationreticlehq/reticle1.2k—~1.6kAutomated safety check: PassApache-2.0
Scoutqa Testgithub/awesome-copilot40k1 repos~3.5kAutomated safety check: PassMIT

Similar skills

  • Reproduce Chat States

    different-ai/openwork

    Fires known chat states in the running OpenWork desktop app, such as provider errors, retries and tool steps, so you can check how each renders.

    24k GitHub stars~673 tokensUpdated today
    Testing & QAAuto-check passed
  • Visual QA For Web And Terminal UIs

    code-yeongyu/oh-my-openagent

    Checks a built UI against a human-interface checklist and any reference image, pairing day and night screenshots at two screen widths.

    70k GitHub stars~9.5k tokensUpdated today
    Testing & QAAuto-check passed
  • Test And Break

    rohunj/claude-build-workflow

    Autonomous testing skill that opens a deployed app, goes through user flows, tries to break things, and writes detailed bug reports.

    231 GitHub stars~1.6k tokensUpdated 8 mo ago
    Testing & QAAuto-check passed
  • Verify Form Validation

    reticlehq/reticle

    Check that a form actually rejects bad input: the error message renders, the submit button stays disabled, and no request goes out.

    1.2k GitHub stars~1.6k tokensUpdated today
    Testing & QAAuto-check passed
  • Scoutqa Test

    github/awesome-copilot

    Official

    This skill should be used when the user asks to "test this website", "run exploratory testing", "check for accessibility issues", "verify the login flow works", "find bugs on this page", or requests…

    40k GitHub starsUsed in 1 repo~3.5k tokens
    Testing & QAAuto-check passed
  • Kb Testing Strategy

    Community-Access/accessibility-agents

    Reference data, not a reviewer. An agent skill from Community-Access/accessibility-agents.

    423 GitHub stars~1.4k tokensUpdated 16 days ago
    Testing & QAAuto-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 4 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 4 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 4 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 4 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 4 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 4 days ago
    Auto-check passed

Questions about Journey Deploy

What does Journey Deploy do?

Use as the deploy-verification stage of the Butterbase journey, after journey-frontend (or after any build stage if there is no frontend). Journey Deploy is an agent skill from butterbase-ai/butterbase-skills. Use as the deploy-verification stage of the Butterbase journey, after journey-frontend (or after any build stage if there is no frontend).

When should I use Journey Deploy?

Journey Deploy fits situations like: tasks that involve QA and bug reports.

How do I install Journey Deploy in Claude Code?

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

How do I install Journey Deploy in Codex?

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

Can I use Journey Deploy 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-deploy -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-deploy, .gemini/skills/journey-deploy, .github/skills/journey-deploy and .opencode/skills/journey-deploy in your project.

What does Journey Deploy need to run?

Going by SKILL.md and its folder, Journey Deploy needs the command-line tools its instructions call (curl).

Does Journey Deploy 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 Deploy 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 Deploy use?

Journey Deploy 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 Deploy use?

About 666 tokens (SKILL.md is roughly 2.7k 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 Deploy?

Skills that share tags, products or a category with Journey Deploy: Reproduce Chat States (different-ai/openwork, 24k stars), Visual QA For Web And Terminal UIs (code-yeongyu/oh-my-openagent, 70k stars), Test And Break (rohunj/claude-build-workflow, 231 stars) and Verify Form Validation (reticlehq/reticle, 1.2k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Journey Deploy?

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.