Skills Your LinkedIn & Twitter Assistant by Reepl

Manage your LinkedIn and Twitter presence with Reepl -- create drafts, publish and schedule posts, manage contacts and collections, generate AI images, create carousels, post to Twitter/X, and maintain your voice profile. Requires a Reepl account (reepl.io).

install
source · Clone the upstream repo
git clone https://github.com/reepl-io/skills
Claude Code · Install into ~/.claude/skills/
T=$(mktemp -d) && git clone --depth=1 https://github.com/reepl-io/skills "$T" && mkdir -p ~/.claude/skills && cp -r "$T/skills/reepl" ~/.claude/skills/reepl-io-skills-your-linkedin-twitter-assistant-by-reepl-715935 && rm -rf "$T"
manifest: skills/reepl/SKILL.md
source content

LinkedIn Content Creation via Reepl

Full LinkedIn content management through Reepl's MCP integration. Write posts in your authentic voice, schedule content, manage drafts, generate AI images, create carousels, post to Twitter/X, browse your saved content library, and maintain contacts -- all from your AI assistant.

Prerequisites

  1. Reepl account -- sign up at reepl.io
  2. MCP connection -- connect your account via OAuth (see Setup below)
  3. Gemini API key (optional) -- required only for AI image generation, link at Settings > AI Models

Setup

# 1. Visit the OAuth page to connect your Reepl account
https://mcp.reepl.io/oauth/authorize

# 2. Log in with your Reepl credentials (Google or email)

# 3. Copy the API key shown after authorization

# 4. Configure the MCP server endpoint
https://mcp.reepl.io/mcp?key=YOUR_API_KEY

If you receive authentication errors at any point, re-authenticate at the URL above.


Available Tools (31 total)

ToolPurpose
create_draft
Save a new LinkedIn post draft
get_drafts
List and search your drafts
update_draft
Edit an existing draft
delete_draft
Remove a draft
publish_to_linkedin
Publish a post to LinkedIn immediately
schedule_post
Queue a post for future publishing
update_scheduled_post
Change time, content, or settings of a scheduled post
delete_scheduled_post
Cancel and delete a scheduled post
publish_now
Immediately publish a scheduled post
schedule_draft
Schedule an existing draft for publishing
get_published_posts
View your published LinkedIn posts
get_scheduled_posts
View your scheduled post queue
add_comment_to_post
Add a comment to a published post
get_user_profile
Get your Reepl account info
get_voice_profile
Read your voice profile (writing style patterns)
update_voice_profile
Update voice profile with learned patterns
get_contacts
Browse saved LinkedIn contacts
get_lists
Browse your contact lists
get_list_contacts
Get contacts in a specific list
add_contact_to_list
Add a contact to a list
get_collections
Browse your saved post collections
get_saved_posts
Read posts from a specific collection
get_templates
Browse your post templates and ideas
generate_image
Generate an AI image for a post (requires Gemini API key)
generate_carousel_content
Generate AI slide content for a carousel
list_carousel_drafts
List your saved carousel drafts
get_carousel_draft
Fetch a specific carousel draft
create_carousel_draft
Save a new carousel draft
update_carousel_draft
Edit an existing carousel draft
delete_carousel_draft
Delete a carousel draft
twitter_create_post
Create or schedule a Twitter/X post or thread

Content Rules

All LinkedIn content MUST be plain text. Never use markdown formatting like bold, italic, or # headings. LinkedIn does not render markdown -- it will appear literally in the feed, looking AI-generated. Use line breaks, spacing, and natural punctuation for structure instead.

LinkedIn posts have a 3,000 character limit.


Tool Reference

1. Create Draft

Save a post idea for later editing or publishing.

{
  "content": "Just wrapped up a deep dive into how AI is reshaping B2B sales.\n\nHere are 3 things I learned...",
  "title": "AI in B2B Sales",
  "mediaUrls": ["https://example.com/image.jpg"]
}
ParameterRequiredDescription
content
YesPost text (plain text only)
title
NoDraft title for organization
mediaUrls
NoArray of image URLs to attach

2. Get Drafts

List and search your saved drafts.

{
  "search": "AI sales",
  "limit": 10
}
ParameterRequiredDescription
limit
NoNumber of drafts to return (default: 20)
search
NoFilter drafts by keyword

3. Update Draft

Edit an existing draft's content, title, or images.

{
  "draft_id": "abc-123",
  "content": "Updated post content here...",
  "title": "New Title"
}
ParameterRequiredDescription
draft_id
YesID of the draft to update
content
NoUpdated post text
title
NoUpdated title
mediaUrls
NoUpdated image URLs (replaces existing)

4. Delete Draft

{
  "draft_id": "abc-123"
}
ParameterRequiredDescription
draft_id
YesID of the draft to delete

5. Publish to LinkedIn

Publish a post to LinkedIn immediately. This action is irreversible -- always confirm with the user before calling.

{
  "content": "Excited to share that we just hit 10,000 users on Reepl!\n\nBuilding in public has been one of the best decisions we made.\n\nHere's what I'd tell founders who are hesitant to share their journey...",
  "visibility": "PUBLIC"
}
ParameterRequiredDescription
content
YesPost text (plain text only, max 3000 chars)
mediaUrls
NoArray of image URLs to include
visibility
No
PUBLIC
(default) or
CONNECTIONS

6. Schedule Post

Queue a post for future publishing. Times are rounded to 15-minute intervals.

{
  "content": "Monday motivation: the best time to start was yesterday. The second best time is now.",
  "scheduledFor": "2026-02-17T08:00:00Z",
  "visibility": "PUBLIC"
}
ParameterRequiredDescription
content
YesPost text (plain text only, max 3000 chars)
scheduledFor
YesISO 8601 timestamp (e.g.
2026-02-17T08:00:00Z
)
mediaUrls
NoArray of image URLs
visibility
No
PUBLIC
(default) or
CONNECTIONS

Scheduling tips:

  • Ask the user for their preferred time rather than picking one yourself.
  • If they want suggestions, recommend varied slots: early morning (7-8 AM), lunch (12-1 PM), or end of day (5-6 PM) in their timezone.
  • Avoid scheduling all posts at the same time -- spread them for better engagement.

7. Update Scheduled Post

Change the time, content, visibility, or images on a post that's already scheduled.

{
  "post_id": "post-456",
  "scheduledFor": "2026-02-18T12:30:00Z",
  "content": "Updated content for the scheduled post..."
}
ParameterRequiredDescription
post_id
YesID of the scheduled post
scheduledFor
NoNew ISO 8601 timestamp
content
NoUpdated post text
visibility
NoUpdated visibility
mediaUrls
NoUpdated image URLs (replaces existing)

8. Delete Scheduled Post

Cancel and remove a scheduled post. Only works on posts with status

scheduled
,
failed
, or
pending_approval
. Published posts cannot be deleted this way.

{
  "post_id": "post-456"
}
ParameterRequiredDescription
post_id
YesID of the scheduled post to delete

9. Publish Now

Immediately queue a scheduled post for publishing by rescheduling it to now. The post will be picked up by the scheduler within a few minutes. Only works on scheduled posts.

{
  "post_id": "post-456"
}
ParameterRequiredDescription
post_id
YesID of the scheduled post to publish immediately

10. Schedule Draft

Schedule an existing draft for LinkedIn publishing. Fetches the draft content and creates a new scheduled post. The original draft remains as a draft.

{
  "draft_id": "abc-123",
  "scheduledFor": "2026-02-17T08:00:00Z"
}
ParameterRequiredDescription
draft_id
YesID of the draft to schedule (use
get_drafts
to find IDs)
scheduledFor
YesISO 8601 timestamp for when to publish

11. Get Published Posts

View the user's published LinkedIn posts. Supports keyword search and pagination.

{
  "limit": 10,
  "search": "AI"
}
ParameterRequiredDescription
limit
NoNumber of posts to return (default: 20)
search
NoFilter posts by keyword (case-insensitive content search)
nextToken
NoCursor for pagination -- use the
nextToken
from a previous response

12. Get Scheduled Posts

View posts currently queued for future publishing. Supports status filtering, keyword search, and pagination.

{
  "limit": 10,
  "status": "scheduled"
}
ParameterRequiredDescription
limit
NoNumber of posts to return (default: 20)
status
NoFilter by status:
scheduled
(default),
failed
,
pending_approval
,
changes_requested
search
NoFilter posts by keyword (case-insensitive content search)
nextToken
NoCursor for pagination -- use the
nextToken
from a previous response

13. Add Comment to Post

Add a comment to a published LinkedIn post. Some post types (reshares, restricted posts) may reject comments -- this is a LinkedIn limitation.

{
  "post_id": "post-456",
  "comment_text": "Great insights! This resonates with what I've seen in enterprise sales."
}
ParameterRequiredDescription
post_id
YesThe
postId
of the published post (from
get_published_posts
)
comment_text
YesComment text (plain text only, max 1250 characters)

14. Get User Profile

Returns the user's name, email, and LinkedIn URL. No parameters required.

15. Get Voice Profile

Read the user's voice profile -- writing style patterns learned from their published posts. No parameters required.

Returns:

  • userInstructions
    -- guidelines the user has set (topics to avoid/emphasize, brand keywords, custom rules, writing samples)
  • generatedProfile
    -- LLM-learned patterns (tone dimensions, vocabulary preferences, hook styles, structure patterns, anti-patterns)
  • allowAutoUpdate
    -- whether the generated profile can be updated automatically
  • isActive
    -- whether the voice profile is active

Always read the voice profile before generating content. This is the key to writing posts that sound like the user, not like an AI.

16. Update Voice Profile

Update the voice profile with newly learned patterns after analyzing the user's posts.

{
  "generatedProfile": {
    "schema_version": "1.0",
    "tone": { "primary": "conversational-authoritative" },
    "vocabulary": { "signature_phrases": ["here's the thing", "let me break this down"] },
    "structure": { "hook_patterns": [{ "type": "bold-statement" }, { "type": "question" }] },
    "anti_patterns": { "never_do": ["use corporate jargon", "start with 'I'm excited to announce'"] }
  }
}
ParameterRequiredDescription
allowAutoUpdate
NoOnly change if user explicitly requests
isActive
NoToggle voice profile on/off
userInstructions
NoUser-controlled guidelines -- only modify if user explicitly asks
generatedProfile
NoLLM-learned patterns from analyzing posts

Important: Before updating

generatedProfile
, always check that
allowAutoUpdate
is
true
. If the user has locked their profile, do not update it.


17. Get Contacts

Browse saved LinkedIn contacts and profiles. Supports pagination.

{
  "search": "product manager",
  "limit": 20
}
ParameterRequiredDescription
limit
NoNumber of contacts (default: 20)
search
NoFilter by name, headline, or keyword
nextToken
NoCursor for pagination -- use the
nextToken
from a previous response

18. Get Lists

Browse the user's contact lists (curated groups of contacts).

{
  "search": "leads",
  "limit": 10
}
ParameterRequiredDescription
search
NoFilter lists by name
limit
NoNumber of lists (default: 20)

19. Get List Contacts

Get all contacts in a specific contact list. Use

get_lists
to find list IDs.

{
  "list_id": "list-123",
  "limit": 20
}
ParameterRequiredDescription
list_id
YesThe ID of the list to fetch contacts from
limit
NoNumber of contacts (default: 20)
nextToken
NoCursor for pagination -- use the
nextToken
from a previous response

20. Add Contact to List

Add an existing contact to a contact list. Use

get_contacts
to find profile IDs and
get_lists
to find list IDs.

{
  "profile_id": "profile-abc",
  "list_id": "list-123"
}
ParameterRequiredDescription
profile_id
YesThe
profileID
of the contact to add
list_id
YesThe ID of the list to add the contact to

21. Get Collections

Browse saved post collections (groups of bookmarked LinkedIn posts).

{
  "search": "inspiration",
  "limit": 10
}
ParameterRequiredDescription
search
NoFilter collections by name
limit
NoNumber of collections (default: 20)

22. Get Saved Posts

Read posts from a specific collection. Use

get_collections
first to find the collection ID.

{
  "collectionID": "col-789",
  "search": "storytelling",
  "limit": 10
}
ParameterRequiredDescription
collectionID
YesThe collection to fetch from
limit
NoNumber of posts (default: 20)
search
NoFilter posts by keyword

23. Get Templates

Browse post templates and content ideas saved in the user's library.

{
  "search": "product launch",
  "limit": 10
}
ParameterRequiredDescription
limit
NoNumber of templates (default: 20)
search
NoFilter by keyword
catalogID
NoFilter by specific catalog

24. Generate Image

Generate an AI image for a LinkedIn post using Google Gemini. Requires the user to have linked their Gemini API key in Reepl settings.

{
  "style": "infographic",
  "postContent": "3 ways AI is changing B2B sales in 2026..."
}
ParameterRequiredDescription
style
YesImage style (see table below)
postContent
NoPost content for context
customPrompt
If style is
custom
Your own image prompt

Available styles:

StyleOutput
infographic
Professional data visuals and charts
minimal-illustration
Clean line art illustrations
bold-text
Typography and quote cards
screenshot-social-proof
Mockup screenshots
comic-storyboard
Comic-style panels
realistic-portrait
Photorealistic scenes
diagram-flowchart
Diagrams and process flows
custom
Your own prompt (requires
customPrompt
)

Always show the generated image to the user for approval before publishing. Pass the returned URL as

mediaUrls
when calling
publish_to_linkedin
or
schedule_post
.


25. Generate Carousel Content

Generate AI slide content for a LinkedIn carousel. Supports plain text topics, YouTube URLs, and article URLs. Returns slide headlines and body text to pass into

create_carousel_draft
.

Note: the API adds a hook slide and CTA slide automatically, so the actual slide count will be

number_of_slides + 2
.

{
  "topic": "remote work productivity tips",
  "number_of_slides": 5
}
{
  "url": "https://youtube.com/watch?v=...",
  "number_of_slides": 6
}
ParameterRequiredDescription
topic
NoTopic or subject for the carousel (use for plain text topics)
url
NoYouTube or article URL to extract content from
number_of_slides
NoNumber of content slides to generate (1-10, default: 5)

26. List Carousel Drafts

List the user's carousel drafts saved in Reepl.

{
  "search": "productivity",
  "limit": 10
}
ParameterRequiredDescription
search
NoFilter drafts by title
limit
NoNumber of drafts to return (default: 20)

27. Get Carousel Draft

Fetch a single carousel draft by ID, including all slide content, theme, and styling.

{
  "draft_id": "carousel-abc"
}
ParameterRequiredDescription
draft_id
YesThe draft ID (use
list_carousel_drafts
to find IDs)

28. Create Carousel Draft

Save a new carousel draft in Reepl. Pass slides from

generate_carousel_content
or write your own. If no theme or colors are specified, your saved brand kit styling is applied automatically.

{
  "title": "5 Remote Work Tips",
  "slides": [
    { "headline": "Stop working from the couch", "body": "Your brain associates spaces with activities. Create a dedicated workspace." },
    { "headline": "Time-block your deep work", "body": "90-minute focus blocks beat 8 hours of fragmented attention every time." }
  ],
  "theme": "3"
}
ParameterRequiredDescription
title
YesTitle for this carousel draft
slides
YesArray of slides, each with a
headline
(required) and optional
body
theme
NoTheme preset ID (
'1'
through
'22'
). Leave unset to use brand kit default
title_font_size
NoFont size for slide titles:
lg
,
md
(default), or
sm
body_font_size
NoFont size for slide body text:
lg
,
md
(default), or
sm

29. Update Carousel Draft

Update an existing carousel draft. Only provide the fields you want to change -- unspecified fields are left as-is. Note: providing

slides
replaces ALL slides in the carousel.

{
  "draft_id": "carousel-abc",
  "title": "Updated Title",
  "slides": [
    { "headline": "New headline", "body": "New body text" }
  ]
}
ParameterRequiredDescription
draft_id
YesThe ID of the draft to update
title
NoNew title
slides
NoReplacement slides (replaces ALL existing slides)
theme
NoNew theme preset ID (
'1'
through
'22'
)
title_font_size
No
lg
,
md
, or
sm
body_font_size
No
lg
,
md
, or
sm

30. Delete Carousel Draft

Permanently delete a carousel draft. This cannot be undone.

{
  "draft_id": "carousel-abc"
}
ParameterRequiredDescription
draft_id
YesThe ID of the carousel draft to delete

31. Twitter/X: Create Post

Create or schedule a Twitter/X post or thread. Requires a Twitter account connected in Reepl Settings > Integrations and an active Premium subscription.

For a single tweet, pass an array with one item. For a thread, pass multiple items in order.

{
  "threadTweets": [
    { "index": 0, "text": "I spent 6 months studying how top creators grow on LinkedIn. Here's what actually works (thread):" },
    { "index": 1, "text": "1/ Consistency beats virality. Posting 3x/week for 6 months outperforms a single viral post every time." },
    { "index": 2, "text": "2/ Comments matter more than posts. Thoughtful replies on big accounts drive more followers than original posts." }
  ],
  "scheduledFor": "2026-03-15T14:00:00Z"
}
ParameterRequiredDescription
threadTweets
YesArray of tweet objects with
index
(0-based position) and
text
(max 280 chars each)
scheduledFor
NoISO 8601 timestamp. If omitted, post is saved as a draft (status: pending)
linkedPostId
NoThe
postId
of a LinkedIn post this thread was cross-posted from

Common Patterns

Pattern 1: Write a Post in the User's Voice

1. get_voice_profile          -- read their writing style
2. Ask user for topic          -- what do they want to write about?
3. Write draft (plain text!)   -- match their tone, hooks, vocabulary
4. Show draft, get feedback    -- iterate until they're happy
5. create_draft OR publish     -- save or go live

Pattern 2: Schedule a Week of Content

1. get_voice_profile           -- read writing style
2. get_templates               -- browse content ideas
3. get_saved_posts             -- browse inspiration from collections
4. Write 3-5 posts             -- vary topics, hooks, formats
5. schedule_post (x5)          -- spread across Mon-Fri at varied times

Pattern 3: Repurpose Saved Content

1. get_collections             -- find the right collection
2. get_saved_posts             -- browse posts in it
3. Pick a post, rewrite it     -- new angle, user's voice
4. create_draft or publish     -- save or go live

Pattern 4: Post with AI-Generated Image

1. Write the post content first
2. generate_image              -- use post content as context
3. Show the image to user      -- get approval
4. publish_to_linkedin         -- pass image URL in mediaUrls

Pattern 5: Analyze and Update Voice Profile

1. get_published_posts         -- fetch recent posts (limit: 20)
2. Analyze patterns            -- tone, hooks, vocabulary, structure
3. get_voice_profile           -- check if allowAutoUpdate is true
4. update_voice_profile        -- save learned patterns to generatedProfile

Pattern 6: Create a LinkedIn Carousel

1. Read carousel_guidelines prompt  -- understand content and styling rules
2. generate_carousel_content        -- provide topic or URL
3. Review slides with user          -- adjust if needed
4. create_carousel_draft            -- save with brand kit styling
5. Share the deep link              -- user fine-tunes in Reepl editor
6. update_carousel_draft            -- apply any requested edits

Pattern 7: Cross-Post to Twitter/X

1. Write or retrieve the LinkedIn post content
2. Adapt for Twitter format           -- split into 280-char chunks for threads
3. twitter_create_post                -- schedule or save as draft
4. Pass linkedPostId if cross-posting -- links the Twitter thread to the LinkedIn post

Pattern 8: Schedule a Draft

1. get_drafts                  -- find the draft to publish
2. Ask user for preferred time -- or suggest morning/lunch/evening slots
3. schedule_draft              -- pass draft_id and scheduledFor

Error Handling

ErrorCauseSolution
Session expired or invalid
OAuth token expiredRe-authenticate at https://mcp.reepl.io/oauth/authorize
Content exceeds 3000 character limit
Post too longShorten the content
draft_id is required
Missing draft IDCall
get_drafts
first to find the ID
collectionID is required
Missing collection IDCall
get_collections
first to find the ID
GEMINI_NOT_LINKED
No Gemini API keyUser must link key at https://app.reepl.io/settings/ai-models-api
Rate limit exceeded
Too many requestsWait a moment and retry
Resource not found
Invalid IDThe draft/post/collection may have been deleted
Couldn't comment on this post
Reshare or restricted postLinkedIn limitation, not a bug -- try a different post

Best Practices

  1. Always read the voice profile first. Before writing any content, call
    get_voice_profile
    to understand the user's writing style. Posts should sound like them, not like an AI.
  2. Plain text only. Never use markdown in post content. No
    **bold**
    , no
    *italic*
    , no
    # headings
    . LinkedIn renders these literally.
  3. Confirm before publishing. Always show the final content and get explicit confirmation before calling
    publish_to_linkedin
    ,
    schedule_post
    , or
    publish_now
    . These affect the user's real LinkedIn profile.
  4. Vary scheduling times. Don't default to 9 AM for every post. Ask the user, or suggest varied slots across mornings, lunch, and end of day.
  5. Never fabricate data. Don't invent engagement metrics, analytics, or post performance numbers. Only report what the API returns.
  6. Respect voice profile locks. If
    allowAutoUpdate
    is false, do not modify
    generatedProfile
    . The user has intentionally locked their voice profile.
  7. Use the library. Before writing from scratch, check templates and saved posts for inspiration. The user has curated these for a reason.
  8. Read carousel guidelines before creating carousels. Call the
    carousel_guidelines
    prompt to understand content rules and the slide structure before generating or saving carousel content.

See Also