agentsclimarketplace

Journey storage

Skill butterbase-ai/butterbase-skills/skills/journey-storage

Plugin for Butterbase.ai

Install
npx -y skills add butterbase-ai/butterbase-skills --skill journey-storage

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

What its author says it does

Copied from the file, not written here

Use as the storage build stage of the Butterbase journey. Implements the Storage section of 02-plan.md by delegating to the storage skill. Calls manage_storage (update_config) for bucket setup; uploads are exercised at frontend integration time, not here. Skipped if the plan has no file uploads.

SKILL.md

2.1 KB, as published. Nobody here has run it

Journey: Storage

Stage 3d of the guided journey. Configure storage buckets/ACLs from the plan.

When to use

  • Dispatched by journey when current_stage: storage.
  • Directly via /butterbase-skills:journey-storage.
  • Skipped (annotated (n/a)) if the plan has no Storage 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 Storage section.
  • docs/butterbase/00-state.md — for app_id.

Procedure

  1. Refresh docs. Call butterbase_docs with topic: "storage". For presigned URL patterns, also WebFetch https://docs.butterbase.ai/storage. Skip if cache is fresh.

  2. Read the Storage section of 02-plan.md. Print it back: "About to configure storage: <buckets>. Proceed?". Wait for yes.

  3. Invoke butterbase-skills:storage via the Skill tool, passing the Storage plan and app_id. The wrapped skill calls manage_storage action: update_config per bucket (visibility, max object size).

  4. Smoke: request an upload URL via manage_storage action: upload_url and a matching download_url to confirm presigned URL minting works.

  5. Append one line to docs/butterbase/04-build-log.md: <ISO timestamp> storage manage_storage ok

  6. Tick - [x] storage in 00-state.md, set current_stage: to the next unchecked stage.

  7. Return to journey orchestrator (or ask "Continue to the next stage? (yes/no)").

Outputs

  • Configured storage buckets.
  • One line in 04-build-log.md.

Anti-patterns

  • ❌ Persisting s3_key in app data — always persist object_id. The wrapped skill handles this; do not override it.

Keep looking

Skills are one crate of 328,083. Ordering is by how many stacks a row turns up in, so the top of any crate is what has actually been picked rather than what has the most stars.