Skip to main content
skill CX Codex

linkedin · acedatacloud — Claude Code skill: posts and installation

Publishes text and link posts to a personal LinkedIn feed through the Posts API. It asks for confirmation before sending.

Apache-2.0 215 installs ★ 17 updated 2026-10-25

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add AceDataCloud/Skills --skill linkedin -a claude-code
Open on GitHub

What linkedin does

This skill gets the member identifier from the OpenID userinfo endpoint, builds the author URN, and sends a post through LinkedIn’s Posts API. A URL stays inside the post text, so LinkedIn can generate its link preview. After creation, the skill reports the post URN or resulting URL.

The workflow uses Bash with curl and jq. It needs LINKEDIN_TOKEN, the w_member_social permission, and a current LinkedIn-Version header. Without w_member_social, posting to the personal feed will fail. Company Page publishing is outside this skill.

What it helps with

  • publish text to a personal LinkedIn feed
  • share an article link as a LinkedIn post
  • retrieve the URN of a created post
  • inspect an API error after publishing

Example prompts for the agent

  • Publish this text to my personal LinkedIn feed, but show it to me for confirmation first: “A short update about our API testing work.”
  • Post the link https://studio.acedata.cloud to LinkedIn and ask me to confirm the final copy before sending.
  • Publish this LinkedIn update and return the URL of the created post.

How to install linkedin

1Skills CLI (Vercel)

npx skills add AceDataCloud/Skills --skill linkedin -a claude-code

2Manually: put the files in place

~/.claude/skills/linkedin/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/linkedin/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about linkedin

How do I install linkedin in Claude Code?

Run npx skills add AceDataCloud/Skills --skill linkedin -a claude-code. Then check ~/.claude/skills/linkedin/SKILL.md.

What does linkedin do?

It publishes text and link posts to the user’s personal LinkedIn feed through the Posts API, then reports the created post’s identifier or URL.

What does linkedin need to publish?

It needs LINKEDIN_TOKEN, the w_member_social permission, plus curl and jq. The skill targets a member’s own feed, not company Pages.

Source text

SKILL.md · Apache-2.0
---
name: linkedin
description: Publish text / link posts to your LinkedIn personal feed via the LinkedIn Posts API. Use when the user mentions LinkedIn, sharing or posting an update to LinkedIn, or cross-posting an article / link to their LinkedIn feed.
when_to_use: |
  Trigger when the user wants to publish a text or link share to their
  own LinkedIn feed. Posting is public on their profile — confirm the
  text (and link, if any) before publishing. Requires the
  w_member_social scope (granted by the connector at install).
connections: [linkedin]
allowed_tools: [Bash]
license: Apache-2.0
metadata:
  author: acedatacloud
  version: "1.0"
---

Call the **LinkedIn API** with `curl + jq`. The user's bearer token is in
`$LINKEDIN_TOKEN`; every call needs `Authorization: Bearer $LINKEDIN_TOKEN`.

LinkedIn posts must be authored by the member's URN. Get the member id from the
OpenID userinfo endpoint, then build `urn:li:person:{sub}`.

```bash
SUB=$(curl -sS -H "Authorization: Bearer $LINKEDIN_TOKEN" \
  "https://api.linkedin.com/v2/userinfo" | jq -r .sub)
AUTHOR="urn:li:person:$SUB"
echo "$AUTHOR"
```

Errors are JSON with `message` / `serviceErrorCode` — show them verbatim.
`401` → token expired (tokens last ~60 days), re-connect the LinkedIn connector.

## Publish a post (Posts API)

**Confirm the text with the user first.** Use the versioned Posts API; set the
`LinkedIn-Version` header to a recent `YYYYMM` (LinkedIn requires a valid recent
version — if you get `426`/version errors, bump to the current month).

```bash
jq -n --arg a "$AUTHOR" --arg t "My update text. Check out https://studio.acedata.cloud" \
  '{author:$a, commentary:$t, visibility:"PUBLIC",
    distribution:{feedDistribution:"MAIN_FEED", targetEntities:[], thirdPartyDistributionChannels:[]},
    lifecycleState:"PUBLISHED", isReshareDisabledByAuthor:false}' \
| curl -sS -X POST "https://api.linkedin.com/rest/posts" \
    -H "Authorization: Bearer $LINKEDIN_TOKEN" \
    -H "Content-Type: application/json" \
    -H "LinkedIn-Version: 202401" \
    -H "X-Restli-Protocol-Version: 2.0.0" \
    -d @- -D - -o /dev/null | tr -d '\r' | awk '/^[Xx]-[Rr]estli-[Ii]d:|^[Ll]ocation:/{print}'
```

A successful create returns `201` with the post URN in the `x-restli-id`
(or `Location`) response header — report that URN / the resulting post URL.

> Link posts: put the URL inline in `commentary` (LinkedIn auto-unfurls it).
> Rich article attachments need the assets/images API — out of scope for a
> simple text/link share; keep links inline.

## Fallback: legacy ugcPosts

If the versioned endpoint is unavailable for the app, the older
`POST https://api.linkedin.com/v2/ugcPosts` with a
`specificContent."com.linkedin.ugc.ShareContent"` body also works with
`w_member_social`. Prefer `/rest/posts` above.

## Gotchas

- **Author URN** must match the token's member (`urn:li:person:{sub}`) — you
  can't post as someone else.
- `w_member_social` only allows posting to the **member's own feed**; company
  Page posts need `w_organization_social` + an admin role (not in this connector).
- The `LinkedIn-Version` header is mandatory for `/rest/*`; a stale value
  returns a version error — bump to the current `YYYYMM`.


## Record the output

After you successfully publish and obtain the live result URL, call the built-in
`publish_artifact` tool ONCE so the user can track this deliverable in **My Outputs**:

```
publish_artifact(kind="article", channel="linkedin", title="<title>", url="<the REAL returned URL>", status="delivered")
```

Use the real returned URL — never fabricate one. Call it once per published item,
only after delivery is confirmed; skip it (or use `status="failed"`) if publishing failed.
See `_shared/artifacts.md`.

© acedatacloud · Apache-2.0 · AceDataCloud/Skills

Similar skills

All skills for Marketing and content →

linkedin by other authors comes first.

linkedin membrane Skill to interact with LinkedIn via Membrane: create and manage posts, comments, and reactions; fetch profiles and organizations without worrying about authentication. Requires a Membrane account (free tier available) and network access. CX Codex +1 211installs linkedin manojbajaj95 Audit a LinkedIn profile, review engagement, or draft posts with this skill. It helps turn profile findings and content ideas into actionable next steps. CX Codex +1 145installs linkedin Linked-API Executes LinkedIn operations using a CLI and the Linked API cloud browser. Use it to search people, inspect companies, and gather profile details. CX Codex +1 ★ 113repo stars LinkedIn Automation Claude Office Skills LinkedIn Automation — a skill that maps out LinkedIn publishing, lead generation, message sequences and analytics for your agent. Useful when B2B outreach runs from the terminal. CX Codex +1 5,400installs linkedin-post publora Publishes and schedules LinkedIn posts through the Publora MCP server: text, an image grid, video or PDF. Handy when the content is ready and you would rather not open the web UI. CX Codex +1 ★ 71repo stars linkedin-marketing sergebulaev The linkedin-marketing skill plans, drafts, reviews, and publishes LinkedIn posts and comments. Use it for content planning, replies, and audience analysis. CX Codex +1 2,100installs linkedin-posts kostja94 linkedin-posts is a Claude Code skill that drafts and revises LinkedIn content. It activates for requests about posts, articles, newsletters, and other LinkedIn formats. CX Codex +1 3,700installs linkedin-writer ognjengt linkedin-writer — a skill for Claude Code, Cursor, Codex and other platforms that drafts two LinkedIn posts in different formats, matched to the author's voice. Format is chosen automatically from the topic type. CX Codex +1 1,400installs linkedin-company-pages social-media-skills A skill for LinkedIn company-page strategy: it designs an employee advocacy program and drafts page posts. Useful when the page gets no engagement. CX Codex +1 1,200installs

From the same set67

The whole set →

Project sponsors

Companies that keep this analytics open