VibeyDocs

Agent Skills

Skills are reusable instruction sets with references that tell agents how to do specific tasks your way, not the generic way.

The rule of thumb: If you do something more than three times and you're giving the same direction each time, it should be a skill.

How Skills Work

Every skill has two parts:

  1. Instructions - Step-by-step directions for how to complete the task. "When asked to write a LinkedIn post, follow this structure, use this tone, keep it under 200 words, always start with a hook question."

  2. References - Examples, templates, and source material the agent uses as a guide. Past LinkedIn posts that performed well, your brand voice document, a hook bank.

The instructions tell the agent how. The references show the agent what good looks like.

Building a Skill

The best way to build a skill is through iteration:

1

Give the agent a task

Chat with them one-on-one on the Team page: "Create a viral hook for this YouTube video."

2

Review the output

Is it what you wanted? Probably not on the first try. That's normal.

3

Give feedback

Tell the agent what to change: "This isn't how we write hooks. Our hooks always start with a controversial statement, not a question."

4

Have the agent pull references

Ask the agent to export your existing content as reference: your top YouTube comments, your best LinkedIn posts, your hook bank.

5

Save as a skill

Tell Vibey: "Now create a skill for this. Every time I ask you to write hooks, use this approach and these references."

6

Test and refine

Use the skill a few more times. Adjust the instructions until the output consistently matches your standards. After 5-10 rounds, it's dialed in.

Skill Examples Across Domains

Skills aren't just for marketing. Any repeatable task in any domain can be a skill:

Marketing and Content

SkillWhat it doesReferences to include
Viral hook writingCreates attention-grabbing hooks for short-form contentYour top-performing hooks, hook bank document
LinkedIn post creationTurns long-form content into LinkedIn posts in your voiceYour best LinkedIn posts, brand voice guide
Short-form video scriptingWrites scripts for Reels/TikTok/ShortsYour scripting checklist, top-performing scripts
Email nurture sequenceWrites follow-up email seriesPast email campaigns, audience profile
Ad copywritingCreates ad variations from an offerPast ads, A/B test results, platform guidelines

Research and Analysis

SkillWhat it doesReferences to include
Competitor analysisResearches competitors with a specific frameworkYour analysis template, past reports
Market research briefProduces structured market researchResearch methodology doc, past briefs
Financial reportCompiles revenue data into formatted reportsReport template, KPI definitions

Operations and Client Work

SkillWhat it doesReferences to include
Client onboarding flowCreates welcome emails, setup guides, check-insPast onboarding materials, SLA doc
Weekly status reportSummarizes progress for stakeholdersReport template, past examples
Meeting summaryTurns recording transcripts into action itemsSummary format, past examples

Development

SkillWhat it doesReferences to include
Custom view buildingCreates custom Space views and reporting widgetsView patterns, data source docs
Bug investigationInvestigates and reports on issuesInvestigation template, codebase context

Where Skills Live

Skills belong to individual agents. When you create a skill for your copywriter, only that copywriter uses it. If you hire a second copywriter, they start without those skills. You can build different skills for different contexts.

This is intentional. A copywriter working on your wellness campaign needs different skills than a copywriter working on your SaaS campaign. Same role, different playbooks.

Agents Come with Skills Ready

When you hire an agent from the library or have Jaime build one, they are not blank slates. Every agent comes with starter skills pre-configured for their role:

  • A Copywriter comes with skills for writing ad copy, email sequences, landing page content, and social posts
  • An Analyst comes with skills for research briefs, competitor analysis, and reporting
  • A Developer comes with skills for building widgets, dashboards, and flows
  • A Media Producer comes with skills for video scripting, editing workflows, and audio production

These starter skills mean your agents can produce useful work from day one. You do not need to build everything from scratch.

The path forward: use the starter skills, review the output, then refine or replace them with skills trained on your specific content, references, and standards. That is when agents go from "good" to "sounds like you wrote it."

Skills Get Better Over Time

The first output is a starting point. The 10th is refined. The 50th is dialed in. This is training, not magic.

Think of it like hiring a real employee: you would not expect perfection on day one. You would train them, give feedback, share examples of great work, and over time they would become excellent. Skills are exactly the same, except the training happens in minutes, not months.

When an agent produces great work, check which skills they used. Those are your winning playbooks. Consider building similar skills for agents in other domains.