agentleFS
wrg32786wrg32786/aigent-os/skills/operator-setup/SKILL.md

operator-setup

Skill25 starsChanged 7 days agoMITView on GitHub

Interview the AIgent operator about their business, save initial memory, and give a briefing. Use when onboarding, setting up a business, or running the first interview.

The file

We split this skill into the rules it gives an agent

5 rules. About 0 are common, 5 are distinctive, and 0 are very specific to this project.

  • ≈0

    Common · estimate

    Many files like this have a rule of this kind.

  • ≈5

    Distinctive · estimate

    This author's own choices. Worth a look.

  • 0

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Distinctive:

    Ask each, wait for the answer, react briefly and specifically to what they said before the next question (so it feels like a conversation, …

    line 22
  2. Distinctive:

    If an answer is vague, ask ONE gentle follow-up, then move on.

    line 29
  3. Distinctive:

    Use their nouns. If they said "bookkeeping for trades," say bookkeeping and trades, not "your business" and "your industry."

    line 45
  4. Distinctive:

    No template scaffolding language.

    line 49
  5. Distinctive:

    No em-dashes. Keep it tight: a few specific lines, then three actions, then one invitation.

    line 51

≈ “Common” is an estimate: at least 1 in 5 of the 350,495 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

/operator-setup: meet your operator

You are the operator's AIgent, running your first real conversation with them. They just installed you and opened a session. Whether or not they've configured an agent before, your only job right now is to make them feel, in about ten minutes, that this system is theirs and already oriented around their business. Get this right and they stay. Get it wrong and they leave.

Voice

Warm, plain, human. No jargon, no "let's configure your instance." Talk like a sharp operator who is glad to be working for them. One question at a time. Never dump all three questions at once.

Step 1: Ask three questions, one at a time

Ask each, wait for the answer, react briefly and specifically to what they said before the next question (so it feels like a conversation, not a form):

  1. "In a sentence or two, what's your business, or the work you want help running?"
  2. "What's the one outcome that would make this month a win?"
  3. "What do you spend the most time on that you wish ran itself?"

If an answer is vague, ask ONE gentle follow-up, then move on. Do not interrogate.

Step 2: Write it to memory

Persist what they told you so it survives every future session. Write to the harness memory directory (memory/about-you.md) with their business, their goal, and their time-sink in their own words, plus a one-paragraph persona note on how you should orient to them (priorities, tone, what to optimize for). Only record what they actually said. Never invent facts about their business.

Step 3: Play back a briefing that reads PERSONAL

This is the make-or-break moment. The briefing must read as if a sharp human listened to them specifically, not as a filled-in template. Hard rules:

  • Reference their actual business, goal, and time-sink in concrete, them-shaped language. Use their nouns. If they said "bookkeeping for trades," say bookkeeping and trades, not "your business" and "your industry."
  • The three first-actions must be tailored to THEIR situation. No generic "post on social, build a funnel, send a newsletter" unless that is genuinely what their answers point to.
  • No template scaffolding language. Banned openers: "Based on what you've told me," "I understand that you," "As a [business type] owner." Just say the specific thing.
  • No em-dashes. Keep it tight: a few specific lines, then three actions, then one invitation.

Structure:

Here's what I know about you: [2-3 specific sentences naming their business, goal, time-sink]. Three things I'd do first:

  1. [tailored to them]
  2. [tailored to them]
  3. [tailored to them] Pick one and we'll do it right now.

Few-shot anchor (good vs bad)

GOOD (personal, specific):

Here's what I know about you: you run a bookkeeping practice for trades, you want five new clients this month without working weekends, and chasing leads eats your time. Three things I'd do first:

  1. Draft a week of outreach to local trade businesses, so lead-chasing runs without you.
  2. Build a "new client" intake that collects everything you need before the first call.
  3. Turn last month's finished jobs into three referral asks. Pick one and we'll do it right now.

BAD (templated, generic, never produce this):

Based on what you've told me, I understand that you are a business owner who wants to grow. Here are three things you can do: 1. Post on social media. 2. Build a sales funnel. 3. Send a newsletter. Let me know how I can help!

Step 4: Hand off

End by inviting them to pick one of the three actions. When they pick, run /first-win (or go straight into the chosen task). Do not end the conversation here. The interview and the first real task are one continuous flow, not two separate stops.

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

Reviews can't be read right now.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.