--- name: vamo-outreach description: Use when writing to software engineers about a role, for one person or a whole list. Starts with describing the role well in a few lines, then drafts personalized technical outreach that links one thing the person actually built, read through Vamo, to the work the team is hiring for. Covers the role pitch, choosing the right repository, the first message, subject lines, follow-ups, answering a reply, a check before anything is handed over, and merge fields for a sending tool. A person approves every message, and the agent never sends. Triggers "write outreach to", "draft an email to this engineer", "personalize these messages", "write a first email that shows we read their code", "help me pitch this role", "draft a sequence for this list", "write a follow-up", "they replied, what do I say". metadata: version: "1.0.0" updated: "2026-10-14" --- # Personalized outreach This skill drafts first messages, follow-ups and replies to engineers about a role. Each first message links one thing the person built to the work the team is hiring for. The sender keeps control of the role pitch, the ask and the signature. The agent writes the part that changes per person, and a person approves every message before it is sent. `vamo-enrich` fills in the person. `vamo-search` finds people to write to. `vamo-workflows` covers putting drafts into a mail tool or a sequencer. ## 1. Describe the role first Write the role down once, before any message. Every message reuses it, so a few minutes here makes the whole list better. Ask the sender for what is missing, in one message: | Part | What good looks like | | --- | --- | | **One-line pitch** | "We're building `` for ``." Under 150 characters. What the company makes, in plain words | | **The work** | One or two sentences on what this person would build, and the hard part of it | | **Three reasons to care** | Taken from the job description or the sender, never invented. Stage, team, a hard problem, ownership, compensation if the sender shares it | | **Facts** | Title, seniority, location or remote, and the main languages or systems | | **The ask** | A 15 to 20 minute call, a reply, or a short chat with the hiring manager | | **The sender** | Name, role, company, and a link the candidate can check | If the sender pastes a job description, draft these parts from it and ask them to confirm or correct. Keep the pitch plain: what the company does and who it is for, with no adjectives about the company itself. Use the facts to keep each message accurate. Do not list them back in the message. ## 2. Choose who to write to first Start with the people whose work is closest to the role. A message to someone whose work does not fit gets no reply however it is worded. Put these people later in the list, or leave them out: - The role would be a step down, or a different job from the one they do now. - They founded or run a company that is still active. - Their current employer comes from an old profile. Mark it as inferred, and leave the employer out of the message. Say so when a list is thin, rather than writing to weaker matches to fill it. ## 3. Read the person and pick one repository Look the person up with `vamo-enrich` (`core` or `deep`, with summaries), or the Vamo MCP `enrich` tool. Read the repository descriptions and READMEs yourself. Pick the **one repository that best shows they can do this role's work.** A famous repository that has nothing to do with the role is the wrong choice. Then check: - **Built or contributed.** Say "built" or "wrote" only for a repository they own. For anything else, say "contributes to" or "worked on". - **What it does.** Describe it from its description and README, in one plain clause. Do not add technical details that are not there. - **No good repository.** If nothing they built relates to the role, do not pretend. Write the message from the role side, or leave the person out and say why. ## 4. Write the first message Three parts, 50 to 80 words in total: 1. **Their work.** One sentence on the repository and what it does, with its link. Write it so it leads into the next sentence, for example by naming the problem it solves. 2. **Who you are and the role.** One or two sentences: the sender, the one-line pitch, and how their work connects to the work in the role. 3. **The ask.** One low-pressure question that can be answered in a line. Then the sender's signature. Keep the tone of a busy person writing between meetings. Plain sentences, no exclamation marks, no selling. Let the description of their work stand in for the compliment. **Vary the opening across a list.** If every message starts the same way, the list reads like a form letter. Rotate between opening on the repository, on the problem it solves, and on something specific in how it was built. **Subject lines.** Up to six words, lower case, specific: the repository, the problem, or the role. Offer two. Leave subject lines to the sender when they have a format they use. ## 5. Follow-ups Only the first message is personalized. Follow-ups are short: 1. **A few days later.** Two or three sentences. Add one new thing: who they would work with, what the first months look like, or another piece of their work. Ask the same question again. 2. **About a week after that.** Two sentences that give an easy out, and say you will not write again. Do not write "just bumping this" or set a deadline that is not real. ## 6. When they reply Answer what they actually said first. Two to four sentences, in their tone. If they asked a question, answer it, or say who can. If they said no, thank them and stop. Take the sender's instructions as a guide for the reply, not as words to copy. ## 7. Check before handing over Rewrite a message that fails any of these: - The first sentence names their actual work, or the person was left out. - Every claim about them comes from something you read. "Built" only for repositories they own. - One question, answerable in a line. - 50 to 80 words for a first message. - Nothing about their tenure, how they feel about their job, or whether they are looking. - No em dashes, and no "not X, it's Y" sentences. - None of: "impressive", "impressed", "passionate", "great fit", "perfect fit", "aligns perfectly", "reach out", "I hope this finds you well", "excited to connect", "exciting opportunity", "showcases", "deep expertise", "rockstar", "just checking in". - Across a list, the openings vary. ## Output For one person: ``` To: () Repository: , , built or contributed Subject: