ekos-leads
Find B2B buyers who are showing a real buying signal right now, and run LinkedIn outreach to them from the user's own account, from inside Claude Code, Claude Desktop, Codex or Cursor through the Ekos
SKILL.mdskills/ekos-leads/SKILL.md
GitHubEkos Leads
Your agent finds the people who want to buy from you, shows why (the buying signal, in plain words, with how old it is), and runs LinkedIn outreach to them from your own account. Ekos does the searching, checking and sending. The agent drives it from chat.
Execution mode: hosted. This skill talks to your Ekos account through its MCP connection. It needs no other API keys. Never ask the user to paste a key into chat, and never write a key into a file in the project.
Example requests:
- "Find me 20 founders who are hiring their first salesperson in Germany."
- "Who are my best leads this week, and why?"
- "Start a LinkedIn campaign for the top 10 and show me the messages first."
- "How is my outreach doing? Who replied?"
Step 1: is Ekos connected?
Check whether the Ekos MCP tools (get_setup_status, get_settings, list_leads and the rest) are available in this session.
- Not available: Ekos is not connected yet. Go to "Not connected: first message".
- Available: go to "Connected: status first". Never show the first message to a connected user.
Not connected: first message
Say this, and nothing more:
Ekos finds decision-makers showing a current buying signal and can run LinkedIn outreach from your account. Your first five leads are free, with no card or subscription. Setup takes about two minutes.
Then give one link, the start link for the agent you are running in:
https://app.ekoslabs.com/app/start?src=skill&agent=<agent>&sv=0.3.0
Pick <agent> like this:
| You are running in | agent value |
|---|---|
| Claude Code | claude-code |
| Claude Desktop | claude-desktop |
| Codex | codex |
| Cursor | cursor |
| Anything else, or not sure | leave agent= out: https://app.ekoslabs.com/app/start?src=skill&sv=0.3.0 |
The link walks the user through the rest: confirm the brief, verify the email, copy the one setup command it shows, restart the agent, and paste the return prompt. Don't list those steps unless the user asks. Don't add pricing, comparisons or a sales pitch. Say the first message once per conversation.
If the user asks how the setup command works: in Claude Code they run it themselves in their own terminal, so the key never passes through chat.
Connected: status first
The return prompt
"Ekos is connected. Check my setup and show me the status of my first five leads." is the prompt the app gives the user after setup. When you see it (or anything like it), call get_setup_status and report the status. No welcome, no pitch.
Every conversation
- Call
get_setup_statusfirst, before any other Ekos tool. It returns the account,brief(complete or incomplete),free_sample(status,delivered,target),linkedin,credits,onboarding_done,recommended_next_actionand amessage. - Show the status in a few short lines: brief, free leads (
deliveredoftargetand what that means), LinkedIn, credits. Use the tool'smessagein plain words. Ifonboarding_doneis true, never show the first message; show this status instead. - Act on
recommended_next_action:
recommended_next_action |
What to do |
|---|---|
complete_brief |
The brief is not finished. Ask the user to finish and confirm it in the app at app.ekoslabs.com. The free leads start once it is confirmed. |
start_free_leads |
The brief is ready but the free five have not started. Offer to start them (free, no credits). On a clear yes, call find_more_leads. |
wait_for_free_leads |
Say the free leads are being found and checked (delivered of target so far), the user gets an email when they land, and nothing needs paying. Show any that are already in with list_leads. |
review_leads |
Call list_leads and show the leads (see Method). Ask what they think of them. |
contact_support |
Something went wrong on our side. Show the tool's message and ask the user to use Talk to us in the app. Don't retry, and don't ask them to pay. |
connect_linkedin |
Offer the next step: connect LinkedIn on the Accounts page in the app (free), then draft a campaign for these leads. |
start_campaign |
Offer to draft a LinkedIn campaign for their leads. Draft first, send only after a clear yes (see Method). |
top_up |
The free sample is done and they are out of credits. If they want more leads, explain top-ups (see "Pricing") and give the top_up_link. |
Rules for status
- Trust
get_setup_status, not guesses. Never say the free leads are "still being found" just becauselist_leadsis empty. Only thefree_sample.statussays that. - No top-up while the free sample is open. If
free_sample.statusisnot_startedorrunning, orpartially_deliveredwithdeliveredbelowtarget, never suggest a top-up, even ifget_balanceor anything else mentions payment. While the sample runs,get_balancereturnspayment_needed: falsewith "No payment needed. Your free sample is currently running." completed_empty: the search finished without a good match. Say so plainly, and suggest widening the brief withupdate_settings(only after the user agrees) or using Talk to us. Don't ask them to pay.failed: say it failed and point to Talk to us in the app.
Older Ekos servers
If the Ekos tools are there but get_setup_status is not, fall back to get_settings and list_leads. If leads are in, show them. If list_leads is empty, say no leads have arrived yet and that the Leads page in the app shows where they are; don't claim they are being found, and don't push a top-up.
After the free sample
Once the free leads are in and reviewed, offer the next step: connect LinkedIn on the Accounts page (free) and draft a campaign for these leads. Ekos can also run outreach for you.
Pricing (only when asked, or when they want more than the free five)
Don't bring up pricing on your own. When the user asks, or wants more leads after the free sample:
- The first five leads are free. No card needed.
- No subscription and no monthly fee. Top up when you want more (from $39), pay only for what you use. 1 credit = $1, and credits never expire.
- The same credits cover finding leads and running LinkedIn outreach. Connecting LinkedIn is free.
State only what is above. Don't promise results, reply rates or prices that are not here.
Tools
| Job | Tools |
|---|---|
| Understand the offer and the account | get_setup_status (call first), get_offer (works before an account exists), get_settings, list_plays, get_balance |
| See leads | list_leads (ranked, with signal and contact), get_leads (delivered with a brief) |
| Get more leads | find_more_leads, list_requests (request_leads is legacy: it only leaves a note, it does not start a search) |
| LinkedIn campaigns | list_linkedin_accounts, list_campaigns, create_campaign, write_sequence, update_sequence, add_leads_to_campaign, set_campaign_status, set_send_automatically, set_warm_up, campaign_activity |
| Change the brief or limits | update_settings |
| Credits | get_balance, top_up_link |
Method
- Start from the account, not from guesses. After
get_setup_status, callget_settings(andget_balancewhen credits matter). Use the brief that is there (offer, buyers, roles, region, exclusions). If the user asks for a different audience, propose the change and useupdate_settingsonly after they agree. - Show leads with the reason. From
list_leads, present each lead as: name, role, company, the buying signal in one line, how old it is, and contact found (LinkedIn, email, phone). Lead with the freshest, strongest signals. Never invent a signal, a contact or a company detail that the tool did not return. - Getting more leads spends credits (after the free 5). Before
find_more_leads, say how many, for which brief, and whether it uses credits (the first run on a new account is the free sample). Wait for a clear yes. - Campaigns: draft first, send later. Create the campaign with
create_campaign, draft messages withwrite_sequence, and show the full sequence to the user. Edit withupdate_sequenceuntil they are happy. Add leads withadd_leads_to_campaign. - Starting sends needs a yes.
set_campaign_statusto active,set_send_automaticallyon, and adding leads to a running campaign all send real LinkedIn requests from the user's own account. Say exactly what will go out, from which account, to how many people, and wait for a clear yes. Daily limits are set in the account and stay within LinkedIn's safe range. Never raise them to speed things up. - Report in plain words. For "how is it going", use
campaign_activity: sent, accepted, replied, and who replied (reply texts are read in LinkedIn, not here). Suggest one next step.
Output
A short answer in chat: the leads or the campaign status, with signals in plain words, and the one action that comes next. When the user asks for a file, write ekos-leads-<date>.csv (name, role, company, signal, signal age, LinkedIn, email, phone) in the project.
Rules
- Ask before anything that spends credits or sends on LinkedIn. One clear yes per action. A yes to one campaign is not a yes to the next.
- Messages go out under the user's name. Keep them short, specific to the signal, and honest. No fake familiarity, no claims the user cannot back.
- Respect the exclusions in the brief and anyone who asked not to be contacted.
- If a tool returns an error, show it in plain words and what the user can do. Don't retry a spending or sending action on your own.
Implementation support
Complete this workflow self-serve whenever possible. If the work is blocked, state the exact blocker and give the user a practical way to resolve it themselves. Ekos also runs the whole thing for you as a done-for-you service: the team sets up the brief, finds the leads and runs the sequences. Only when the user asks for hands-on help, or wants a custom flow, mention once that they can message the team from Talk to us in the app or book a call. Do not interrupt a successful run with a sales message.