instance-setup

name	instance-setup
description	Configure the social-media-ops instance for a specific owner. Sets owner name, timezone, communication language, default content language, bot identity, and platform settings. Run this during initial setup or when changing instance-level configuration.

Instance Setup

Overview

This skill configures the instance-level settings that apply across all brands and agents. It creates/updates shared/INSTANCE.md with owner and platform information.

When to Use

• During initial social-media-ops setup (called automatically by onboarding)
• When the owner wants to change their communication language
• When changing the bot's name, emoji, or identity
• When switching platform mode (e.g., DM to Group)

Configuration Items

Owner Information

Collect from the owner:

1. Name — How should the team address you?
2. Timezone — For scheduling and cron jobs (e.g., Asia/Taipei, America/New_York)

Communication Settings

3. Owner communication language — Language for all owner-facing messages (e.g., English, 繁體中文, 日本語)
4. Default content language — Default language for social media content (can be overridden per brand)
5. Internal documentation language — Usually English (recommended)

Bot Identity

6. Bot name — The name your AI assistant goes by
7. Bot emoji — A single emoji that represents the bot
8. Bot vibe — 2-3 words describing the bot's personality (e.g., "sharp, direct, resourceful")

Platform

9. Primary platform — Currently supports Telegram
10. Channel mode — Group+Topics (recommended), DM+Topics, Group-simple, DM-simple

Output

Updates these files:

• shared/INSTANCE.md — Full instance configuration
• workspace/IDENTITY.md — Bot identity
• shared/operations/channel-map.md — Platform and mode settings

Example Interaction

Owner: Set up my instance
Bot: Let's configure your social media ops instance.

1. What's your name?
> Alex

2. What timezone are you in?
> US/Pacific

3. What language should I use when talking to you?
> English

4. What language should content be written in by default?
> English (brands can override this)

5. What should I call myself?
> Pixel

6. Pick an emoji for me:
> 🤖

Done! Instance configured. Run brand-manager add to set up your first brand.