Agent skill

Journey Idea

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

Use as stage 1 of the Butterbase journey, when the user has only a rough idea ("I want to build something that...").

MITAuto-check passedAgent Workflows

Install Journey Idea

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

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

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

At a glance

Use as stage 1 of the Butterbase journey, when the user has only a rough idea ("I want to build something that...").

  • Works in 12 steps: "In one sentence, what is the painful… → "Who is the first user? ① solo creator ②… → "What is the first action they take in… → …
  • Has only a rough idea (I want to build something that...)
  • SKILL.md covers When to use, Inputs, Procedure — questioning… and 01-idea.md format, plus 2 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Journey Idea is an agent skill from butterbase-ai/butterbase-skills. Use as stage 1 of the Butterbase journey, when the user has only a rough idea ("I want to build something that..."). Conducts a concrete, one-question-at-a-time brainstorm that surfaces who the user is, what they do first, what the must-haves are, and inline-tags Butterbase capabilities (→ manageschema, → deployfunction, etc.). Produces docs/butterbase/01-idea.md.

Its SKILL.md is about 1.3k 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 Agent Workflows, covering Brainstorming. The repository describes itself as: Plugin for Butterbase.ai. The licence is MIT.

When your agent uses it

  • Has only a rough idea (I want to build something that...)
  • Tasks that involve Brainstorming

Example prompts

  • “I want to build something that...”
  • “/journey-idea”

Workflow steps

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

  1. "In one sentence, what is the painful thing your user does today that this replaces?"
  2. "Who is the first user? ① solo creator ② small team ③ end customers of a business ④ Other"
  3. "What is the first action they take in the app?"
  4. "If we could ship only ONE screen, which one?"
  5. "Do two different users see different data when they log in? (yes → user-scoped data → manage_rls; no → shared → simpler)"
  6. "Are there files/images involved? (yes → manage_storage; no → skip)"
  7. "Does anything happen on a schedule or in response to an external event? (yes → deploy_function cron/webhook; no → skip)"
  8. "Is there a knowledge base / search-over-documents feature? (yes → manage_rag_content; no → skip)"
  9. "Does the UI need live updates or presence? (yes → manage_realtime; no → skip)"
  10. "Any chat rooms / multiplayer / per-user-actor state? (yes → manage_durable_objects; no → skip)"
  11. "Any LLM features (chat, embeddings, summarisation)? (yes → manage_ai; no → skip)"
  12. "Any multi-step LLM+tool workflows the user triggers (e.g. 'summarise my orders', 'auto-tag a doc', 'research and reply')? (yes →…

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 (its code samples are markdown).

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

  • Network

    No URLs in SKILL.md.

    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 Idea loads about 1.3k tokens when it runs. Until then it costs about 95 tokens; SKILL.md has 528 words of instructions outside code blocks.

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

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). 528 words, ~1,252 tokens.

Download SKILL.mdSave it as .claude/skills/journey-idea/SKILL.md (or your agent's skills folder).
name
journey-idea
description
Use as stage 1 of the Butterbase journey, when the user has only a rough idea ("I want to build something that..."). Conducts a concrete, one-question-at-a-time brainstorm that surfaces who the user is, what they do first, what the must-haves are, and inline-tags Butterbase capabilities (→ manage_schema, → deploy_function, etc.). Produces docs/butterbase/01-idea.md.

Journey: Idea brainstorm

Stage 1 of the guided journey. Turn a vague idea into a written brief with capability tags.

When to use

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

Inputs

None required. Optionally reads any existing 01-idea.md to resume.

Procedure — questioning discipline

Follow the cross-cutting rules from the spec:

  • One question at a time. Never batch.
  • Multiple-choice preferred, with 2–4 concrete options.
  • Concrete, not abstract.
  • Recommend when a Butterbase primitive is obvious.
  • Tag inline. When a feature surfaces, append the capability tag immediately (→ manage_schema, → deploy_function, → manage_storage, → manage_oauth, → manage_rag_content, → manage_realtime, → manage_durable_objects, → manage_ai, → create_agent).
  • Write as you go. After each answered question, append the decision to 01-idea.md so progress survives a crash.

Walk through these questions in order. Do not skip — but adapt the wording.

  1. "In one sentence, what is the painful thing your user does today that this replaces?"
  2. "Who is the first user? ① solo creator ② small team ③ end customers of a business ④ Other"
  3. "What is the first action they take in the app?"
  4. "If we could ship only ONE screen, which one?"
  5. "Do two different users see different data when they log in? (yes → user-scoped data → manage_rls; no → shared → simpler)"
  6. "Are there files/images involved? (yes → manage_storage; no → skip)"
  7. "Does anything happen on a schedule or in response to an external event? (yes → deploy_function cron/webhook; no → skip)"
  8. "Is there a knowledge base / search-over-documents feature? (yes → manage_rag_content; no → skip)"
  9. "Does the UI need live updates or presence? (yes → manage_realtime; no → skip)"
  10. "Any chat rooms / multiplayer / per-user-actor state? (yes → manage_durable_objects; no → skip)"
  11. "Any LLM features (chat, embeddings, summarisation)? (yes → manage_ai; no → skip)"
  12. "Any multi-step LLM+tool workflows the user triggers (e.g. 'summarise my orders', 'auto-tag a doc', 'research and reply')? (yes → create_agent; no → skip)". If yes, also ask: "Will the agent need external MCP servers (e.g. GitHub, Slack, custom MCP)?" and "Visibility: ① only the developer ② any logged-in user ③ unauthenticated public — note: public + write tools requires explicit safety acknowledgement."
  13. "Are you planning to publish this app as a public template others can clone? (yes / unlisted-public / no)". Set publish_as_template: <yes|unlisted|no> in 00-state.md front-matter. Public templates require a README with clone instructions and butterbase repo push to sync the source tree — flag this so plan and the publish stage know to plan for it.
Show full SKILL.md (138 more words)Show less

If hackathon_mode: true in 00-state.md: after question 4, also ask:

  • "Hackathon deadline (ISO date/time)?" — write to 00-state.md front-matter.
  • After each subsequent feature ask "Can this ship in time, or move to a 'post-hackathon' section?"

01-idea.md format

markdown
# Idea

**One-liner:** <user's answer to Q1>

**First user:** <Q2>
**First action:** <Q3>
**One screen:** <Q4>

## Must-haves
- <feature> → <capability tag>
- ...

## Post-hackathon (nice-to-have)
- ...

## Capability map
| Capability | Used? | Why |
|---|---|---|
| manage_schema | yes | core data model |
| manage_rls | yes | user-scoped data |
| manage_oauth | yes | Google sign-in |
| manage_storage | no | no files |
| deploy_function | yes | daily-digest cron |
| manage_ai | no | |
| manage_rag_content | no | |
| manage_realtime | no | |
| manage_durable_objects | no | |
| create_agent | no | |
| publish_as_template | no | set true if user plans to share this app publicly |
Toolchain note

At the end of the idea write-up, also note in one line that the build will use:

  • @butterbase/sdk for any frontend / Node app code
  • @butterbase/cli for the local dev loop (scaffolding, logs, key generation)
  • The MCP tools (this plugin) for orchestrating provisioning, deployments, integrations

This sets expectations before plan makes specific package choices.

Outputs

  • Writes docs/butterbase/01-idea.md.
  • Ticks - [x] idea and bumps current_stage: plan, last_updated in 00-state.md.

Anti-patterns

  • ❌ "Tell me more about your app." Use the concrete questions above.
  • ❌ Asking 3 questions at once.
  • ❌ Accepting "all of the above" in hackathon mode — force prioritisation.
  • ❌ Moving on before writing 01-idea.md to disk.

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

Open the folder on GitHubat commit aa8ae69

Compare with similar skills

Journey Idea 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 Idea compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Journey Idea this skillbutterbase-ai/butterbase-skills534—~1.3kAutomated safety check: PassMIT
Yao Meta Skillyaojingang/yao-meta-skill2.7k—~768Automated safety check: PassMIT
Qnniblameandrew/open-deepthink151—~7.1kAutomated safety check: PassMIT
Activate Tavernweave SoulLiarMTTT/TavernWeave154—~1.8kAutomated safety check: PassCustom licence
Hwb Modeling Workflowxieyouxixi/hwb-math-modeling-skills197—~993Automated safety check: PassNone
Solve Taskhashgraph-online/awesome-codex-plugins1.3k—~2.1kAutomated safety check: PassApache-2.0

Similar skills

  • Yao Meta Skill

    yaojingang/yao-meta-skill

    Create, improve, or evaluate an existing skill from workflows, prompts, SOPs, scripts.

    2.7k GitHub stars~768 tokensUpdated 1 mo ago
    Agent WorkflowsAuto-check passed
  • Qnn

    iblameandrew/open-deepthink

    Launch a Qualitative Neural Network (QNN) — a layered, multi-epoch brainstorm of agent personas that maps divergent strategies before implementation.

    151 GitHub stars~7.1k tokensUpdated 1 mo ago
    Agent WorkflowsAuto-check passed
  • Activate Tavernweave Soul

    LiarMTTT/TavernWeave

    Activate, switch, combine, or close TavernWeave Soul as a portable current-task teaching overlay with 阿瞳 for warm guidance, MTTT.sir for strict learning examination, 灵魂杀手 for blunt frontend and…

    154 GitHub stars~1.8k tokensUpdated 7 days ago
    Agent WorkflowsAuto-check passed
  • Hwb Modeling Workflow

    xieyouxixi/hwb-math-modeling-skills

    Orchestrate the HWB (HUAWEI Cup China Post-Graduate Mathematical Contest in Modeling) Skills across problem reading, idea generation, model selection, paper drafting, section checks, final…

    197 GitHub stars~993 tokensUpdated 24 days ago
    Agent WorkflowsAuto-check passed
  • Solve Task

    hashgraph-online/awesome-codex-plugins

    Gather disciplined context for solving a task, then hand off to development.

    1.3k GitHub stars~2.1k tokensUpdated yesterday
    Agent WorkflowsAuto-check passed
  • Brainstorming

    obra/superpowers

    Makes the agent clarify intent and agree on a design with you before writing any code, scaling the process from a quick spike to a written spec.

    297k GitHub starsUsed in 1 repo~2.5k tokens
    Agent WorkflowsAuto-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 Idea

What does Journey Idea do?

Use as stage 1 of the Butterbase journey, when the user has only a rough idea ("I want to build something that..."). Journey Idea is an agent skill from butterbase-ai/butterbase-skills.").

When should I use Journey Idea?

Journey Idea fits situations like: has only a rough idea (I want to build something that...); tasks that involve Brainstorming.

How do I install Journey Idea in Claude Code?

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

How do I install Journey Idea in Codex?

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

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

What does Journey Idea need to run?

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

Does Journey Idea access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Journey Idea 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 Idea use?

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

About 1.3k tokens (SKILL.md is roughly 5k 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 Idea?

Skills that share tags, products or a category with Journey Idea: Yao Meta Skill (yaojingang/yao-meta-skill, 2.7k stars), Qnn (iblameandrew/open-deepthink, 151 stars), Activate Tavernweave Soul (LiarMTTT/TavernWeave, 154 stars) and Hwb Modeling Workflow (xieyouxixi/hwb-math-modeling-skills, 197 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Journey Idea?

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.