Cloud Templates

A Cloud template is a versioned *.template.json file that can create a playable Shadow space: server, channels, Buddies, model provider wiring, skills, scripts, CLI tools, and MCP assets.

Official templates live in apps/cloud/templates.

Official Templates

TemplateWhat it createsDefault channelsPlugins
agent-marketplace-buddySpecialist-agent marketplace for development, security, infrastructure, data, docs, SEO, and workflow orchestration.Choose, Build, Reviewmodel-provider, shadowob
ai-werewolfAI game host for roles, pacing, voting, and recap.Lobby, Table, Recapmodel-provider, shadowob
bmad-method-buddyBMAD Method agile development space for analysis, planning, delivery, QA, and retros.Analysis, Planning, Deliverymodel-provider, shadowob
brain-fixOne-minute reset space for breathing, focus, and reflection.Reset, Focus, Reflectmodel-provider, shadowob
claude-ads-buddyPaid ads audit space for platform checks, budget modeling, creative review, and tracking issues.Audit, Creative, Budgetmodel-provider, shadowob
claude-seo-buddyTechnical SEO and GEO/AEO audit space with SEO skills, scripts, and guidance.Audit, Strategy, Technicalmodel-provider, shadowob
code-arenaCoding challenge space for problems, timed battles, hints, and review.Problems, Arena, Reviewmodel-provider, shadowob
daily-briefMorning brief space for global news, technology, markets, and personal focus.Morning, Markets, Technologymodel-provider, shadowob
e-wifeCompanion-style life space for daily check-ins, memory, and small plans.Daily, Memory, Plansmodel-provider, shadowob
everything-claude-code-buddyEngineering harness with skills, commands, agents, hooks, memory, and Codex-compatible guidance.Engineering, Review, Opsmodel-provider, shadowob
financial-freedomRunway, spending clarity, and milestone planning space.Snapshot, Roadmap, Habitsmodel-provider, shadowob
gitstorySoftware history space that turns commits, releases, and decisions into readable stories.Commits, Chapters, Retrosmodel-provider, shadowob
google-workspace-buddyWorkspace operations space for Gmail, Calendar, Drive, Docs, and Sheets after authorization.Inbox, Calendar, Docsmodel-provider, google-workspace, shadowob
gsd-buddySpec-driven development space for context, milestones, planning, execution, and verification.Specs, Execution, Reviewmodel-provider, shadowob
gstackFounder strategy space for idea validation, competitive mapping, and pitch shaping.Idea, Market, Pitchmodel-provider, shadowob
gstack-buddyProduct-team strategy space with gstack helper scripts mounted from GitHub.Office Hours, Weekly Retromodel-provider, shadowob
marketingskills-buddyGrowth team space using marketing playbooks for CRO, copy, SEO, paid, email, and decisions.General, Briefsmodel-provider, shadowob
retire-buddyRetirement planning space for life design, financial runway, and daily companionship.Life Plan, Money Map, Daily Caremodel-provider, shadowob
scientific-skills-buddyScientific research space with skills for data analysis, biology, chemistry, medicine, visualization, and writing.Research, Analysis, Writingmodel-provider, shadowob
seomachine-buddySEO growth space for keyword research, content briefs, on-page audits, and topical authority.Keyword Research, Content Briefs, On-page Auditsmodel-provider, shadowob
slavingia-skills-buddySolo operator space for writing, decisions, design taste, and focused execution.General, Decisionsmodel-provider, shadowob
superclaude-buddyStructured development workbench with commands, modes, agents, MCP guidance, and confidence checks.General, Commands, Architecturemodel-provider, shadowob
superpowers-buddyEngineering-method space for specs, TDD, implementation planning, execution, and review.General, Specs, Reviewmodel-provider, shadowob
world-pulseWorld news signal space for concise summaries, context, and follow-up questions.Headlines, Signals, Contextmodel-provider, shadowob

Template Shape

{
  "version": "1.0.0",
  "name": "gstack-buddy",
  "title": "${i18n:title}",
  "description": "${i18n:description}",
  "use": [
    { "plugin": "model-provider" },
    {
      "plugin": "shadowob",
      "options": {
        "servers": [
          {
            "id": "gstack-hq",
            "name": "gstack",
            "slug": "gstack",
            "channels": [
              { "id": "office-hours", "title": "Office Hours", "type": "text" }
            ]
          }
        ],
        "buddies": [{ "id": "strategy-buddy", "name": "Strategy Buddy" }],
        "bindings": [
          {
            "targetId": "strategy-buddy",
            "targetType": "buddy",
            "servers": ["gstack-hq"],
            "channels": ["office-hours"],
            "agentId": "strategy-buddy"
          }
        ]
      }
    }
  ],
  "deployments": {
    "namespace": "gstack-buddy",
    "agents": [
      {
        "id": "strategy-buddy",
        "runtime": "openclaw",
        "identity": {
          "name": "Strategy Buddy",
          "systemPrompt": "Use the mounted gstack instructions before advising."
        }
      }
    ]
  }
}

Secrets and Variables

SyntaxMeaning
${i18n:title}Locale-aware template text.
${env:VAR_NAME}Local environment variable used by CLI deploys.
${secret:k8s/secret-name/key}Kubernetes Secret reference.

Never place raw API keys in a template. Use env variables, platform secret groups, provider profiles, or secret references.

Publish Checklist

  1. Validate with shadowob-cloud validate --strict.
  2. Confirm all visible text has i18n values.
  3. Confirm every Buddy binding points to a deployed agent.
  4. Confirm the default channel exists and is the landing target.
  5. Confirm secrets are references, not inline values.
  6. Deploy once in a clean cluster and send a test message to the Buddy.

Strong templates are more than chat windows. Add scripts, skills, CLI commands, MCP tools, scheduled tasks, or approval flows when they make the play useful.