Skip to content
Back to search

social-skills

MarketplaceWorks with Claude CodeGitHub

Claude Code plugins for social media posting, eBay listings, and email management

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/isaacrowntree--claude-social-skills/badge.svg)](/listings/isaacrowntree--claude-social-skills)

HTML

<a href="/listings/isaacrowntree--claude-social-skills"><img src="/api/listings/isaacrowntree--claude-social-skills/badge.svg" alt="findsafeskills safety rating" /></a>

Install

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

git clone https://github.com/isaacrowntree/claude-social-skills && cd claude-social-skills
./scripts/setup.sh      # bun install, `social` on PATH, fetch + pin specs, link skills into ~/.claude/skills
social auth status      # what each platform still needs

Or as a Claude Code plugin: `/plugin marketplace add isaacrowntree/claude-social-skills`.

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

.claude-plugin/marketplace.json · Manifest · 12 lines
  1. {
  2. "name": "social-skills",
  3. "owner": { "name": "Isaac Rowntree" },
  4. "metadata": { "description": "One Bun CLI, `social`, for X, Bluesky, Mastodon, Reddit, Facebook, Instagram, Threads, YouTube, eBay and himalaya email, built from each platform's live API description. One skill per platform, generated from the CLI so the docs cannot drift." },
  5. "plugins": [
  6. { "name": "social", "source": "./", "description": "The `social` CLI and every platform skill", "version": "2.0.0", "keywords": ["social-media", "x", "twitter", "bluesky", "mastodon", "reddit", "facebook", "instagram", "threads", "youtube", "ebay", "email", "himalaya"], "category": "social-media", "skills": [
  7. "./skills/social-x", "./skills/social-bluesky", "./skills/social-mastodon", "./skills/social-reddit",
  8. "./skills/social-facebook", "./skills/social-instagram", "./skills/social-threads",
  9. "./skills/social-youtube", "./skills/social-ebay", "./skills/social-email"
  10. ] }
  11. ]
  12. }
README.md · README · 137 lines
  1. # social
  2. One command-line tool for X, Bluesky, Mastodon, Reddit, Facebook, Instagram, Threads, YouTube, Pinterest, Discord, eBay, Etsy and email, built from each platform's published API description and run directly by [Bun](https://bun.sh). No build step, no MCP server: a `social` binary on your PATH and one Claude Code skill per platform, generated from the binary so the docs cannot drift from what it does.
  3. ```bash
  4. social x post "hello" # curated commands for what you do daily
  5. social pinterest ops create pin # search a platform's generated operations
  6. social pinterest describe pins/create # parameters, body fields, scopes
  7. social discord call create_message -p channel_id=1 -f content=hi # call any of them by id
  8. social ebay call fulfillment.getOrders -p limit=5 # eBay: every REST and GraphQL operation
  9. social email trace <id> # SPF/DKIM/DMARC verdict and the Received chain
  10. social specs pull # fetch + regenerate from the live specs (never committed)
  11. social --dry-run bluesky post "test" # print the request, send nothing
  12. ```
  13. ## Install
  14. ```bash
  15. git clone https://github.com/isaacrowntree/claude-social-skills && cd claude-social-skills
  16. ./scripts/setup.sh # bun install, `social` on PATH, fetch + pin specs, link skills into ~/.claude/skills
  17. social auth status # what each platform still needs
  18. ```
  19. Or as a Claude Code plugin: `/plugin marketplace add isaacrowntree/claude-social-skills`.
  20. ## Credentials
  21. Every platform reads its keys from, in order: the environment, `~/.config/social/.env`, the OS keyring. `social auth set <platform> <KEY> <value>` writes to the keyring when one exists. Platforms with a browser flow use `social auth login <platform>`.
  22. | platform | what you need | flow |
  23. |---|---|---|
  24. | x | `TWITTER_API_KEY`, `TWITTER_API_SECRET`, `TWITTER_ACCESS_TOKEN`, `TWITTER_ACCESS_TOKEN_SECRET`; `TWITTER_BEARER_TOKEN` alone for reads | paste from the developer portal |
  25. | bluesky | `BLUESKY_HANDLE`, `BLUESKY_APP_PASSWORD` | app password, no redirect |
  26. | mastodon | `MASTODON_INSTANCE`, `MASTODON_ACCESS_TOKEN` | paste, or `auth login` (paste-the-code flow, no redirect server) |
  27. | reddit | `REDDIT_CLIENT_ID`, `REDDIT_CLIENT_SECRET`, plus username/password (2FA off) or `auth login` | Reddit requires app approval since Nov 2025 |
  28. | facebook | `FB_PAGE_ID`, `FB_PAGE_ACCESS_TOKEN` | long-lived page token from the Graph API Explorer |
  29. | instagram | `IG_USER_ID`, `IG_ACCESS_TOKEN` | same |
  30. | threads | `THREADS_USER_ID`, `THREADS_ACCESS_TOKEN` | Threads tester + token exchange |
  31. | youtube | `GOOGLE_CLIENT_ID`, `GOOGLE_CLIENT_SECRET` then `auth login` | OAuth with PKCE on a loopback port |
  32. | pinterest | `PINTEREST_CLIENT_ID`, `PINTEREST_CLIENT_SECRET` (an app at developers.pinterest.com; business account), redirect URI `https://localhost:8085/callback`, then `auth login`; `PINTEREST_SANDBOX=1` while the app has trial access | OAuth in the browser, refreshed automatically |
  33. | discord | `DISCORD_BOT_TOKEN` (developer portal → your app → Bot), and invite the bot to your server | bot token, no redirect |
  34. | etsy | `ETSY_KEYSTRING`, `ETSY_SHARED_SECRET` (etsy.com/developers/your-apps) for public reads; callback URL `https://localhost:8086/callback` then `auth login` for your shop | OAuth with PKCE; access 1 h, refresh 90 days |
  35. | ebay | `EBAY_CLIENT_ID`, `EBAY_CLIENT_SECRET`, `EBAY_RUNAME` (accept URL `https://localhost:8888/callback`, OAuth enabled), then `auth login` once; `EBAY_AUTH_TOKEN` only for the legacy `ebay trading` passthrough | OAuth in the browser, refresh token lasts ~18 months |
  36. | email | none here; `himalaya account configure` | wraps the installed himalaya CLI (v2.1.0) |
  37. `social doctor` makes one cheap authenticated read per configured platform.
  38. ## How it is built
  39. - **Specs, pinned, never committed.** `src/core/specs.ts` lists every platform that publishes a machine-readable description: X (official OpenAPI 3), Bluesky (its OpenAPI rendering of the lexicons), Mastodon (community OpenAPI tracking 4.7), YouTube (Google Discovery), Pinterest (its v5 OpenAPI on GitHub), Discord (its official OpenAPI on GitHub), Etsy (Open API v3), and eBay (29 REST OpenAPI documents plus one GraphQL schema). `social specs pull [platform]` (or `bun run gen`) fetches them, checks each against its SHA-256 in `spec-pins.json`, and generates code. A spec that fails to download leaves the previous generated code in place rather than a partial one. `bun run verify-gen` fails in CI when upstream publishes something new; `bun run gen` pins new specs and `--update` re-pins changed ones (`social specs pull` never writes pins). Meta and Reddit publish no fetchable spec; those wrappers cite the doc page for each call in a comment.
  40. - **Generated operations, every platform with a spec.** `src/core/openapi.ts` turns an OpenAPI or Google Discovery document into an operation index (`src/platforms/<name>/ops.gen.json`) and gives the platform `ops` (ranked search over ids, summaries, descriptions and field names), `describe` and `call`. Calls go through the platform's own authenticated client, so retries, token refresh and `--dry-run` all apply. X, Mastodon, Bluesky and YouTube get this on top of their curated commands; Pinterest, Discord and Etsy are nothing but this plus their auth. Tokens only go to the platform's own hosts.
  41. - **eBay adds GraphQL.** `src/platforms/ebay/build-index.ts` indexes 29 REST specs and the GraphQL schema behind eBay's modernized APIs (Listing, offers, orders, returns). GraphQL documents and variables are checked against the schema before sending, and default selections leave out fields the sign-in can't read. The few places eBay's specs are wrong about hosts or auth are one documented table (`FIXES`).
  42. - **Shared sign-in.** `src/core/oauth.ts` serves the OAuth redirect on localhost (https with a throwaway certificate when the redirect URI is https), checks `state`, and shuts down without cutting off the "Authorised" page; eBay, Pinterest and Etsy use it.
  43. - **One HTTP layer** (`src/core/http.ts`): retries on 502/503/504 for idempotent methods, one wait on 429, typed `ApiError` with the response body, and `--dry-run`. Every platform is a thin config over it.
  44. - **One contract** (`src/core/platform.ts`): a platform is an authenticated client plus its commands: generated ones where a spec exists, curated ones for what you do daily. `social api <platform> <path>` remains the escape hatch for anything outside a spec.
  45. - **Docs from the binary.** `bun run gen-skills` writes `skills/social-<platform>/SKILL.md` from the registered commands and their flags; `--verify` fails CI on drift.
  46. - **Tests without the network.** `bun test` runs every curated command, and the generated runtime, against a local fake that asserts the exact method, path, query, headers and body. `social doctor` and the smoke job in CI are the only things that touch real servers.
  47. ## Verified against the real servers
  48. Generated operations (2026-10-28): Bluesky `app.bsky.actor.getProfile` and Mastodon `getInstanceV2` without credentials; Pinterest, Discord and Etsy answer their documented auth errors (Etsy wants `x-api-key: keystring:shared_secret` on every request, its token endpoint included). Pinterest, Discord and Etsy have not been called with real credentials yet.
  49. eBay's generated APIs (2026-10-28): Identity, Fulfillment, Finances, Message, Taxonomy, Metadata, Post-Order and Account reads; GraphQL `sellerListingSearch`, `sellerListings`, `sellerNegotiationHistory`; `media.createImageFromFile` (a real upload); `gql.createListing` in VALIDATE mode through to `CreateListingValidationSuccess`; then, on the account owner's say-so, `gql.updateListing` (price, free postage, Best Offer thresholds, title), `gql.endListing`, `marketing.createCampaign` + `bulkCreateAdsByListingId`, and `negotiation.sendOfferToInterestedBuyers` (which needs no `sell.negotiation` scope, and refuses `allowCounterOffer: true`). Trading's `UploadSiteHostedPictures` now answers 404, so picture upload is the Media API.
  50. What was exercised live with real credentials, read-only (2026-09-18): eBay `GetUser`, `GetMyeBaySelling`, `GetMyMessages`, `GetBestOffers`, `GetItem`, `VerifyAddFixedPriceItem`; himalaya `account list`, `mailbox list`, `envelope list`, `envelope search`, `message read`, `attachment list` on three accounts. What the servers said that the docs do not:
  51. - eBay retired `GetCategories`, `GetCategorySpecifics`, `GetSuggestedCategories`, `GetCategoryFeatures` and `GeteBayOfficialTime` (HTTP 410). Category and item-specifics lookups now use the Commerce Taxonomy API with an app-only token.
  52. - X returns `402 credits depleted` for an app with no API credits; the auth path is correct but nothing can be read or written until the account has credit.
  53. - Mastodon: mastodon.social answers the public timeline with 422 without a token; other instances answer 200.
  54. - Reddit: logged-out JSON is blocked by network security for some IPs regardless of User-Agent, and any API access now needs explicit approval.
  55. - Meta: the Graph API is on v26.0 (the old scripts used v24.0); header-based auth failures are 401, query-string ones are 400.
  56. - Bluesky: an expired access token is a 400 `ExpiredToken`, not a 401; bad credentials are `AuthenticationRequired`, which the OpenAPI does not list.
  57. - himalaya v2.1.0 rejects eight flags the previous skill documented for v1.2.0, and reading no longer marks a message seen.
  58. Not exercised live for lack of credentials on the build machine: any authenticated call on Bluesky, Mastodon, Reddit, Facebook, Instagram, Threads, YouTube, Pinterest, Discord and Etsy, and anything outside eBay that publishes, sends, moves or deletes. Each of those is covered by the local fake only.
  59. ## Commands
  60. ```
  61. Commands:
  62. x X (Twitter) API v2: post, reply, delete, read
  63. your timeline, upload media
  64. ebay eBay: every REST and GraphQL operation eBay
  65. publishes (listings, orders, offers,
  66. messages, returns, media, finances…),
  67. generated from its specs
  68. mastodon Mastodon (any instance): post, reply, delete,
  69. upload media, home timeline, notifications,
  70. profiles
  71. facebook Facebook Page via the Graph API: post text,
  72. links and photos, read and delete your Page's
  73. posts
  74. instagram Instagram Business/Creator via the Graph API:
  75. publish images and reels from public URLs,
  76. list your media
  77. threads Threads API: post text or an image, read your
  78. posts and profile
  79. youtube YouTube Data API v3: your channel, uploads,
  80. video details, comments, upload and delete
  81. videos
  82. bluesky Bluesky (AT Protocol): post, reply, delete,
  83. timeline, profiles; any XRPC method via
  84. `social api bluesky`
  85. reddit Reddit: post, comment, delete, inbox, home
  86. feed and subreddit listings, plus any Data
  87. API path
  88. email Email through the himalaya CLI: list, read,
  89. search, trace headers, send, reply, move,
  90. flag, delete
  91. pinterest Pinterest API v5: every operation (pins,
  92. boards, sections, media, analytics, ads…),
  93. generated from Pinterest's OpenAPI
  94. description
  95. discord Discord: every HTTP API operation (messages,
  96. channels, servers, threads, webhooks,
  97. members…) as a bot, generated from Discord's
  98. OpenAPI description
  99. etsy Etsy Open API v3: every operation (shop,
  100. listings, images, inventory, orders/receipts,
  101. shipping…), generated from Etsy's OpenAPI
  102. description
  103. api [options] <platform> <path> Call any endpoint of a platform directly,
  104. with its auth applied
  105. auth Store credentials for a platform (keyring, or
  106. ~/.config/social/.env)
  107. doctor [options] make one cheap authenticated call per
  108. configured platform and report
  109. specs pull and regenerate the API specs the CLI is
  110. built from (not committed to git)
  111. help [command] display help for command
  112. ```
  113. Each platform has its own `social <platform> --help` and a `skills/social-<platform>/SKILL.md` with every command and flag; generated platforms list their API groups and recipes there too.
  114. ## Licence
  115. MIT.

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.