get-started
Set up a brand-new Marky account end to end, from your AI agent, in one sitting. Use this the first time someone connects Marky and has no business yet, or when they say "set me up", "get me started",
SKILL.mdskills/get-started/SKILL.md
GitHubGet Started with Marky
This is the very first run for a new Marky account. The goal is to take someone from an empty account to a handful of on-brand posts waiting for their approval — without making them touch the onboarding wizard themselves. You do the setup; they just answer a couple of questions and approve at the end.
Read the marky-api skill first for the mk_live_ key, the base URL, and the MCP
connection. This skill drives Marky through the MCP tools and leans on two other skills for
the heavy lifting: build-brand-kit (workspace + brand) and plan-social-content (drafting).
The approval gate is mandatory. This flow ends at drafts, never at scheduled posts.
Publishing to someone's live accounts is brand-facing and irreversible-feeling; they review the
first batch and say go before anything is queued. Do not call schedule_post or queue_post
in this skill. Stop at create_post (which leaves a NEW draft) and hand off.
Marky wants your feedback. First-run is the most important flow to get right — if any step
breaks or confuses you, send Marky a note with the submit_feedback MCP tool. See the "Marky
wants your feedback" section in the marky-api skill.
Before you start: are you connected?
Call list_businesses.
- The call fails / you have no key or MCP connection → you are not connected yet. Follow the
install + connect steps in the
marky-apiskill (or the repo README), get the user signed in, then come back here. - The call returns one or more real businesses → this account is already set up. This skill
is for empty accounts; use
plan-social-contentorsuggest-topicsinstead. - The call returns an empty list (or only a placeholder business) → you're in the right place. Continue.
Stage 1 — Create the workspace and brand kit
A good brand kit is what makes every future post sound and look like the business instead of generic AI filler, so this comes first.
- Ask the user for their website. One question: "What's your website? I'll pull your logo, colors, and voice from it." If they have no website, ask for their most active social profile — any page that carries their branding works.
- Run the
build-brand-kitskill with that URL. It visits the site, extracts the logo, colors, fonts, voice, and imagery style, shows the user the proposed kit, and — on their approval — creates the business and writes the brand profile viaupdate_business. - If the user genuinely has no site or social presence, fall back to
create_businesswith a name and a short description they give you, and set the voice from a couple of questions.
Note the business_id that comes back — every later step needs it.
Stage 2 — Connect the first social account
Publishing can't work until at least one account is connected, and connecting is an OAuth-per-platform step that only happens in the dashboard — there is no API for it. So you hand the user a link and wait.
Tell the user which platforms Marky supports (Instagram, Facebook, LinkedIn, TikTok, X, Google Business, Pinterest, YouTube) and ask which one they want to start with. One is enough to get going; they can add more later.
Send them to their connect page:
https://app.mymarky.ai/ws/BUSINESS_ID/business/profile(Replace
BUSINESS_IDwith the id from Stage 1.) Tell them: "Open this, click the platform you picked, and approve the connection. Come back here when it's done."Poll, don't guess. Call
list_connected_social_accountsfor the business every 10–15 seconds (or when they say they're done) until at least one account shows up with avalidstatus. Don't move on until you can see it — a confident "great, you're connected!" that turns out to be wrong is worse than waiting.
Stage 3 — Learn from what they already post
If the account they connected has posting history, that's the richest possible signal for their real voice and cadence — use it before you write anything.
list_connected_social_accountsgives you the connected integration(s). For one with history, pull their recent posts and stats:list_integration_posts— what they've actually posted (topics, format, length, hashtags).get_integration_stats— what landed (which posts got engagement).
- Read for patterns, not just numbers: what subjects they cover, how long their captions run,
how formal they are, whether they use emoji or hashtags, what their best post had in common.
Fold this into the voice you'll draft in (and, if you keep a
writing-style.mdper theplan-social-contentskill's storage rule, write it there so it compounds). - Brand-new account with no history? That's fine — skip this stage and lean on the brand kit's voice from Stage 1.
Stage 4 — Draft the first few posts (for approval)
Now produce a small, strong first batch — enough to show the value, not a full month.
- Use the
plan-social-contentskill's drafting approach to write 3–5 posts grounded in something real: the brand kit, the learnings from Stage 3, and a quick question or two about what's coming up for them (a launch, an offer, a seasonal moment). Quality over quantity — these are the posts that decide whether they trust Marky. - Create each one with
create_post, which leaves it as aNEWdraft in their queue. Do not schedule. Noschedule_post, noqueue_post, nostatus: SCHEDULED. - Show the user each draft — caption and, if you generated a graphic, the design — right in the conversation.
Stage 5 — Hand off
You've done the setup; now it's their call.
Point them to their drafts to review, edit, and approve:
https://app.mymarky.ai/ws/BUSINESS_ID/social-postsTell them plainly what you did and what's left: "Your brand kit is set, [platform] is connected, and I've drafted 5 posts. Review them here — nothing publishes until you approve and schedule."
Offer the obvious next steps:
- "Schedule the ones you like — just tell me which and when."
- "/plan-social-content for a full week. Ask me what's coming up first."
- "Connect another platform and I'll post there too."
- "/build-brand-kit again if the posts don't sound quite like you yet."
That's a complete first run: empty account → workspace → connected → learned → drafted → approved. Everything after this is normal Marky use.