gobi-vault

Manage Gobi vaults by publishing PUBLISH.md profiles and syncing local files with Webdrive.

3|Updated Feb 25, 2026
One-click install
npx skills add https://github.com/gobi-ai/gobi-cli --skill gobi-vault-gobi-ai
Or copy as Structured Prompt for Agentâ–¼
Please help me install this Agent Skill.
Skill: gobi-vault
Source: https://github.com/gobi-ai/gobi-cli/tree/main/skills/gobi-vault
Command: npx skills add https://github.com/gobi-ai/gobi-cli --skill gobi-vault-gobi-ai

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Managing a Gobi vault — creating it, publishing its public profile, and keeping local files in sync with Webdrive — requires running multiple CLI commands in the right order with the right flags. This Skill gives an agent the exact command reference, safety rules, and publishing workflow so vault operations happen correctly and with user confirmation before any external state changes. ## Core Features & Use Cases - Vault lifecycle management: Initialize a vault for the current directory, create, rename, list, and delete vaults via gobi vault commands. - Public profile publishing: Publish or unpublish PUBLISH.md to Webdrive so the vault appears at https://gobispace.com/@{vaultSlug} with title, description, tags, thumbnail, and prompt frontmatter. - Bidirectional file sync: Sync local vault files with Gobi Webdrive using upload-only, download-only, dry-run, conflict-strategy, and plan-file options. - Use Case: A user edits their vault's PUBLISH.md to add a description and tags, then asks the agent to make the changes live — the agent syncs referenced files, runs gobi vault publish, and confirms the public profile URL. ## Quick Start Ask the agent to initialize a Gobi vault in the current directory and publish its PUBLISH.md profile so it appears on your public gobispace.com page.

Frequently Asked Questions about gobi-vault

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I publish a Gobi vault profile?â–¼

Edit PUBLISH.md frontmatter with at least title and description, run gobi vault sync to upload referenced files like thumbnails, then run gobi vault publish. The vault goes live at https://gobispace.com/@{vaultSlug} after post-processing updates the metadata.

How do I sync local vault files with Gobi Webdrive?â–¼

Run gobi vault sync from the vault directory. Use --upload-only or --download-only for one-way syncs, --dry-run to preview changes, and --conflict with ask, server, client, or skip to control conflict resolution.

What frontmatter fields does PUBLISH.md support?â–¼

PUBLISH.md supports title, description, tags (block list or inline array), thumbnail as a wiki-link to an image file, and prompt as a wiki-link to a system prompt file. Title and description are required for the vault to appear in the public catalog.

Why is my vault file not visible on gobispace.com after syncing?â–¼

Files uploaded to a non-public vault are stored on Webdrive but not visible at gobispace.com/@{vaultSlug}. Run gobi vault status to check isPublished, then run gobi vault publish to make the vault public.

Can I delete a Gobi vault that still has content?â–¼

No. The API rejects gobi vault delete if the vault still owns content. Clean up posts, members, and files first, then run gobi vault delete <slug> — the deletion is irreversible and the slug must be passed explicitly.