Vamos

View saved version →

---
name: get-started
description: Set up the user's Vamos workspace from their social accounts, website and what they do, so its research and writing fit their brand. Use when the user first connects Vamos, asks to set it up, or a Vamos tool reports the workspace has nothing set up.
---

Vamos fits every answer to the workspace's brand, voice and the creators it follows. A new workspace has none of these, so its answers stay generic until it is set up.

1. In one message, ask the user for:
   - their social accounts: @handle and platform, or profile links (Instagram, TikTok, YouTube, LinkedIn, X, Facebook);
   - their website, if they have one;
   - in their own words, what they do, what they sell and who it is for.

   Setup needs at least one account or the website, because it reads them.
2. Call `set_up_workspace` with `accounts`, `website` and `about` from what the user shared, in their words. Leave out anything they did not give.
3. Call `chat_completion_poll` with the `runId` it returns until `status` is `done`. Setup reads their profiles and site, so it takes a few minutes.
4. From the `result`, tell the user what Vamos set up (brand profile, content pillars, voice, the creators it now follows) and anything it still needs from them.

If the user arrived with a request, start it with the `social-research` skill and ask for these details in the same reply: setup runs in its own chat, alongside their request.

The user's instructions take precedence over this skill.

View saved version →

---
name: social-research
description: Research and write social media content with Vamos. Use when the user wants to find what is working on TikTok, Instagram or YouTube (trending formats, hooks and topics in a niche, a creator's or competitor's best posts, similar creators), break down a post's hook, comments or video, study Meta ads, or write posts, hooks, scripts, captions and briefs in their brand voice.
---

Vamos reads public posts and profiles by @handle or link (metrics, comments, transcripts, the video itself) and the Meta Ad Library, and it knows the workspace's brand, voice, memory and saved files. It plans its own research, so your part is to pass the request on and bring the answer back. It does not post for the user.

## One message per request

1. **Pick the chat.** For a follow-up on the same brand, campaign, creator or draft, continue its chat from `list_chats`. For unrelated work, call `create_chat` with a short name for it. Both return `brain`, the brand Vamos writes for; when the user has several workspaces, `list_chats` lists them, and work for another one goes in a chat created with `workspace` set to its name.
2. **Send the user's whole request in their own words** with `chat_completion_start`. Vamos researches and writes in the same turn, so "find the creators, then write scripts from them" is one message.
3. **Wait for it** with `chat_completion_poll` until `status` is `done`.
4. **Follow up in the same chat** once the answer has arrived: "now shorter", "do it for Instagram" or the user's pushback is the next message there. A message sent while a run is working starts a second run.

## What goes in the message

The user's words and whatever they named: handles, links, dates, platform, format, and facts about their own account. Their analytics (retention, reach, follower growth, sales) are private, so Vamos has those numbers only when the user shares them; pass them on as given.

Leave out what you would add yourself (a research plan, numbered parts, an output template, handles or numbers you found elsewhere), because it narrows Vamos's research.

- `Break down @vanessalau.co's last 30 days. Which patterns are worth using and which are noise?`
- Follow-up: `Now write scripts for the top two patterns.`
- `How does Portland Leather Goods run TikTok Shop lives? I sell leather handbags and want to copy the model.`

## Reuse before you resend

- **An earlier answer:** `get_messages` returns it at no cost.
- **The same analysis every day or week:** ask Vamos to save it as a routine; each run appears in `list_chats`.
- **Creators to keep watching, or a fact to remember** (a brand fact, a voice rule): ask Vamos in plain words, and it saves them to the workspace.

## The answer

Vamos's `result` is the deliverable. Present it with every link exactly as returned, because the links are the sources the user checks. A short framing line is fine.

After a dropped call or an unclear error, check `get_messages` before sending again: the run may have finished, and a resend runs it again.

The user's instructions take precedence over this skill.