Skip to content

ericrisco/rsc-harness / skills/medium-publishing

medium-publishing

Verified

Use when a finished article has to land on Medium correctly — profile vs publication, cross-posting under a canonical link so your own site keeps the SEO credit, import-tool failures, the 5-tag cap, pseudo-Markdown gotchas. NOT writing or headlining the piece (that is `medium-writing`), NOT cadence or earnings (that is `medium-strategy`).

FileKindSize
SKILL.mdskill md9.8 KB
evals/README.mdmarkdown950 B
evals/cases.yamlconfig3.2 KB
references/cross-post-and-canonical.mdmarkdown3.9 KB
references/legacy-api.mdmarkdown3.3 KB

references/legacy-api.md

View on GitHub
# Legacy Medium API — pre-2025-token holders only

> **Closed to new integrations.** As of **2025-01-01** Medium issues no new integration tokens and accepts no new integrations. Only tokens minted before that date still authenticate. Do not attempt to register a new token — it will be refused. This reference is useful **only** if you already hold a pre-2025 token. For everyone else, the publishing path is the web editor + import tool (see `cross-post-and-canonical.md`).

## Auth

All requests use a Bearer integration token:

```
Authorization: Bearer <MEDIUM_INTEGRATION_TOKEN>
Content-Type: application/json
Accept: application/json
```

Base URL: `https://api.medium.com/v1`.

## Resolve the user id

You need your `userId` before posting. Get it from `/me`:

```bash
curl -s -H "Authorization: Bearer $MEDIUM_TOKEN" \
  https://api.medium.com/v1/me
```

```json
{
  "data": {
    "id": "5303d74c64f66366f00cb9b2a94f3251bf5",
    "username": "yourhandle",
    "name": "Your Name",
    "url": "https://medium.com/@yourhandle",
    "imageUrl": "https://cdn-images-1.medium.com/..."
  }
}
```

## Create a post on your profile

`POST /v1/users/{userId}/posts`

```bash
curl -s -X POST \
  -H "Authorization: Bearer $MEDIUM_TOKEN" \
  -H "Content-Type: application/json" \
  https://api.medium.com/v1/users/<userId>/posts \
  -d '{
    "title": "My title",
    "contentFormat": "markdown",
    "content": "# My title\n\nBody in markdown...",
    "canonicalUrl": "https://mysite.com/original-post",
    "tags": ["react", "javascript", "web-development"],
    "publishStatus": "draft",
    "license": "all-rights-reserved"
  }'
```

### Request fields

| Field | Type | Notes |
|---|---|---|
| `title` | string | Story title (also used for the SEO title) |
| `contentFormat` | string | `html` or `markdown`. Markdown here is more permissive than the web editor |
| `content` | string | The body, in the chosen format |
| `canonicalUrl` | string | Set to the **origin** URL for a cross-post — preserves your site's SEO credit |
| `tags` | string[] | Up to 5; extras are dropped |
| `publishStatus` | string | `public` \| `draft` \| `unlisted` |
| `license` | string | e.g. `all-rights-reserved`, `cc-40-by`, `public-domain` |
| `notifyFollowers` | boolean | Whether followers are notified |

### Response (success)

```json
{
  "data": {
    "id": "e6f36a",
    "title": "My title",
    "authorId": "5303d74c64f66366f00cb9b2a94f3251bf5",
    "url": "https://medium.com/@yourhandle/my-title-e6f36a",
    "canonicalUrl": "https://mysite.com/original-post",
    "publishStatus": "draft",
    "tags": ["react", "javascript", "web-development"],
    "license": "all-rights-reserved"
  }
}
```

## Create a post in a publication

`POST /v1/publications/{publicationId}/posts` — same body shape.

A `publishStatus: "draft"` under a publication remains **pending** an editor's action; it is not live until an editor publishes it, and you must be an accepted writer for that publication.

## Why automation plans usually fail in 2026

- New tokens: refused (closed since 2025-01-01).
- Make: the Medium app is legacy — only pre-existing connections work.
- n8n: Medium credentials still listed but cannot be newly configured.

If the user has no pre-2025 token, route them to the import-tool path. Do not build a pipeline that assumes a new token.
slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack."Stars: 198kUpdated Claude CodeCodexVerifiedInstall
ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read.Stars: 194kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report.Stars: 194kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt.Stars: 194kUpdated Claude CodeCodexVerifiedInstall