postemi 1.0.0 → 1.1.0

package/PROVIDER_SETTINGS.md

@@ -3,15 +3,16 @@
 Every channel Postemi supports, and every field its `--settings` payload accepts.
 
 **The channels below are the whole list.** Postemi's server carries inherited
-code for many other providers — Reddit, Mastodon, Medium, Dev.to, Hashnode,
-WordPress, Lemmy, Nostr, VK, Tumblr, Dribbble, Farcaster and others.
-None of them are enabled or supported. Do not build a settings payload for one.
+code for many other providers: Reddit, Medium, Hashnode, Lemmy, Nostr, VK,
+Dribbble, Farcaster and others. None of them are enabled or supported. Do not
+build a settings payload for one.
 
 | Channel | `__type` | Has settings? | Status |
 |---|---|---|---|
 | X (Twitter) | `x` | yes | Publishing verified |
 | Facebook | `facebook` | yes, all optional | Publishing verified |
 | Instagram | `instagram` | yes | Publishing verified |
+| Instagram (no Facebook Page) | `instagram-standalone` | yes, same as Instagram | Live |
 | Threads | `threads` | **no** | Publishing verified |
 | Bluesky | `bluesky` | **no** | Publishing verified |
 | LinkedIn | `linkedin` | yes, all optional | Publishing verified |
@@ -20,7 +21,18 @@ None of them are enabled or supported. Do not build a settings payload for one.
 | Slack | `slack` | yes, `channel` required | Publishing verified |
 | YouTube | `youtube` | yes | Publishing verified |
 | TikTok | `tiktok` | yes | Publishing verified |
-| Pinterest | `pinterest` | yes, `board` required | BETA: pins visible only to their creator until Pinterest grants Standard access |
+| Pinterest | `pinterest` | yes, `board` required | Coming soon: cannot be connected until Pinterest approves Postemi's app |
+| Mastodon (mastodon.social) | `mastodon` | **no** | BETA |
+| Mastodon (any other server) | `mastodon-custom` | **no** | BETA |
+| Pixelfed | `pixelfed` | **no** | BETA |
+| WordPress | `wordpress` | yes, `title` and `type` required | BETA |
+| Tumblr | `tumblr` | yes, all optional | BETA |
+| Dev.to | `devto` | yes, `title` required | BETA |
+| Ghost | `ghost` | yes, `title` required | BETA |
+| Google Chat | `google-chat` | **no** | BETA |
+| Microsoft Teams | `microsoft-teams` | **no** | BETA |
+| Google Business Profile | `gmb` | yes, all optional | Coming soon, not schedulable yet |
+| LinkedIn Pages | `linkedin-page` | yes, same as LinkedIn | Coming soon, not schedulable yet |
 
 Source of truth for everything on this page:
 `libraries/nestjs-libraries/src/dtos/posts/providers-settings/*.ts` in the Postemi
@@ -314,8 +326,8 @@ postemi posts:create -c "Release notes are out" -s "2026-12-31T12:00:00Z" \
 
 ## Pinterest — `pinterest`
 
-**BETA.** Until Pinterest grants Postemi Standard access, a pin is visible only
-to the account that created it. Tell the user before you schedule one.
+**Coming soon.** Postemi customers cannot connect Pinterest until Pinterest
+approves Postemi's app. The settings below apply once it opens.
 
 | Field | Values |
 |---|---|
@@ -337,6 +349,169 @@ postemi posts:create -c "Autumn recipes" -m "$IMG" -s "2026-12-31T12:00:00Z" \
 
 ---
 
+## Instagram without a Facebook Page: `instagram-standalone`
+
+The same settings as `instagram` (`post_type` required, the rest optional).
+The `audioSearch` tool is not available on this channel: it exists only on
+`instagram`.
+
+```bash
+IMG=$(postemi upload photo.jpg | jq -r '.path')
+postemi posts:create -c "New menu" -s "2026-12-31T12:00:00Z" \
+  --settings '{"post_type":"post"}' -m "$IMG" -i "$IGS_ID"
+```
+
+---
+
+## Mastodon: `mastodon` and `mastodon-custom`
+
+**No settings.** Same as Threads. `mastodon` is an account on mastodon.social;
+`mastodon-custom` is an account on any other Mastodon server, chosen when the
+user connects it. A post is at most 500 characters on mastodon.social (other
+servers can set their own limit).
+
+```bash
+postemi posts:create -c "Post text" -s "2026-12-31T12:00:00Z" -i "$MASTODON_ID"
+```
+
+---
+
+## Pixelfed: `pixelfed`
+
+**No settings.** Pixelfed is a photo network on any server, chosen when the
+user connects it. Every post needs at least one picture and takes at most 4
+(JPEG, PNG or GIF; no video). The caption is at most 500 characters.
+
+```bash
+IMG=$(postemi upload photo.jpg | jq -r '.path')
+postemi posts:create -c "Morning light" -s "2026-12-31T12:00:00Z" -m "$IMG" -i "$PIXELFED_ID"
+```
+
+---
+
+## WordPress: `wordpress`
+
+The post's `-c` content becomes the article body (HTML).
+
+| Field | Required | Values |
+|---|---|---|
+| `title` | **yes** | at least 2 characters |
+| `type` | **yes** | a post type id from the `postTypes` tool, e.g. `posts` or `pages` |
+| `main_image` | no | A media object from `postemi upload` (the featured image) |
+| `categories` | no | array of category ids (numbers) from the `categoriesList` tool |
+| `tags` | no | array of tag ids (numbers) from the `tagsList` tool |
+| `status` | no | `publish` (default), `draft`, `pending`, `private` |
+
+```bash
+postemi integrations:trigger "$WP_ID" postTypes | jq '.output'
+postemi integrations:trigger "$WP_ID" categoriesList | jq '.output'
+postemi integrations:trigger "$WP_ID" tagsList | jq '.output'
+postemi posts:create -c "<p>Our autumn menu is here.</p>" -s "2026-12-31T12:00:00Z" \
+  --settings '{"title":"Autumn menu","type":"posts","categories":[3],"tags":[12,14]}' \
+  -i "$WP_ID"
+```
+
+---
+
+## Tumblr: `tumblr`
+
+All fields optional. The blog is chosen when the user connects the channel.
+
+| Field | Values |
+|---|---|
+| `title` | 1 to 4096 characters, shown as the heading of the post |
+| `link` | A URL, added to the post as a link block |
+| `sourceUrl` | A URL, the post's source |
+| `tags` | comma separated tags, at most 4096 characters |
+
+```bash
+postemi posts:create -c "Post text" -s "2026-12-31T12:00:00Z" \
+  --settings '{"title":"Autumn menu","tags":"food,autumn"}' -i "$TUMBLR_ID"
+```
+
+---
+
+## Dev.to: `devto`
+
+The post's `-c` content becomes the article body (Markdown). The article is
+published at the scheduled time.
+
+| Field | Required | Values |
+|---|---|---|
+| `title` | **yes** | at least 2 characters |
+| `main_image` | no | A media object from `postemi upload` (the cover image) |
+| `canonical` | no | A URL, the original of the article |
+| `organization` | no | an organization id from the `organizations` tool, as a string |
+| `tags` | no | up to 4 items of `{ "value": <number>, "label": "<name>" }` from the `tags` tool |
+
+```bash
+postemi integrations:trigger "$DEVTO_ID" tags | jq '.output[:5]'
+postemi integrations:trigger "$DEVTO_ID" organizations | jq '.output'
+postemi posts:create -c "## Why we built it..." -s "2026-12-31T12:00:00Z" \
+  --settings '{"title":"Shipping a CLI","tags":[{"value":8,"label":"javascript"}]}' \
+  -i "$DEVTO_ID"
+```
+
+---
+
+## Ghost: `ghost`
+
+The post's `-c` content becomes the article body (HTML).
+
+| Field | Required | Values |
+|---|---|---|
+| `title` | **yes** | 1 to 255 characters |
+| `status` | no | `published` (default, at the scheduled time) or `draft` (a Ghost draft) |
+| `tags` | no | comma separated tag names, at most 1000 characters |
+| `excerpt` | no | at most 300 characters |
+| `main_image` | no | A media object from `postemi upload` (the feature image) |
+
+```bash
+postemi posts:create -c "<p>Our autumn menu is here.</p>" -s "2026-12-31T12:00:00Z" \
+  --settings '{"title":"Autumn menu","tags":"menu,autumn","excerpt":"What is new this season."}' \
+  -i "$GHOST_ID"
+```
+
+---
+
+## Google Chat and Microsoft Teams: `google-chat`, `microsoft-teams`
+
+**No settings.** Same as Threads. The space (Google Chat) or the channel
+(Teams) is fixed by the webhook the user gives when connecting. A message is
+at most 4096 characters on Google Chat and 10000 on Teams.
+
+```bash
+postemi posts:create -c "Release notes are out" -s "2026-12-31T12:00:00Z" -i "$GCHAT_ID"
+```
+
+---
+
+## Google Business Profile: `gmb` (coming soon)
+
+**Not schedulable yet:** Google has not approved Postemi, so the user cannot
+connect it. For reference, the settings the server accepts, all optional:
+
+| Field | Values |
+|---|---|
+| `topicType` | `STANDARD`, `EVENT`, `OFFER` |
+| `callToActionType` | `NONE`, `BOOK`, `ORDER`, `SHOP`, `LEARN_MORE`, `SIGN_UP`, `GET_OFFER`, `CALL` |
+| `callToActionUrl` | A URL, checked when `callToActionType` is set |
+| `eventTitle` | string, for `EVENT` |
+| `eventStartDate`, `eventEndDate`, `eventStartTime`, `eventEndTime` | strings |
+| `offerCouponCode`, `offerTerms` | strings, for `OFFER` |
+| `offerRedeemUrl` | A URL |
+
+A post takes at most one image and no video.
+
+---
+
+## LinkedIn Pages: `linkedin-page` (coming soon)
+
+**Not schedulable yet:** LinkedIn has not approved Postemi for company pages.
+When it does, the settings are the same as `linkedin`.
+
+---
+
 ## Finding your integration ids
 
 ```bash
@@ -353,7 +528,8 @@ YT_ID=$(postemi integrations:list | jq -r '.[] | select(.identifier=="youtube")
 If a channel is not in `integrations:list`, the user cannot post to it. For
 Google Business Profile and LinkedIn company pages that is the expected state
 until those platforms approve the app (personal LinkedIn profiles work).
-Pinterest is live as a BETA channel. Say so rather than scheduling a post that will fail.
+The BETA channels are live. Say so rather than scheduling
+a post that will fail.
 
 ---
 

package/README.md

@@ -7,7 +7,10 @@ command-line tool. It uses the same public API as the web app: what you
 schedule here shows up in your Postemi calendar, and what you schedule there
 you can see here too.
 
-Channels: 20 platforms, including Facebook, Instagram, X, LinkedIn, TikTok, YouTube, Threads, Bluesky, Pinterest and Mastodon.
+Channels: 25+ platforms, including Facebook, Instagram, X, LinkedIn, TikTok, YouTube, Threads, Bluesky, Pinterest and Mastodon.
+
+Plan: the CLI, the API and MCP need the Pro plan or higher (Pro, Creator or
+Team). Basic has no API access.
 
 [`SKILL.md`](./SKILL.md) is the full command reference, written for AI agents.
 Show it to Claude, ChatGPT, Codex, OpenClaw or Hermes and they can use the
@@ -42,9 +45,10 @@ postemi auth:signup --email anna@example.com --code 123456 --accept-terms --work
 ```
 
 The person must agree to https://postemi.com/terms and
-https://postemi.com/privacy first. There is no free trial: next come
-`postemi billing:plans` and `postemi billing:subscribe`. You can also sign up
-at https://postemi.com/app/signup and then run `postemi auth:login`.
+https://postemi.com/privacy first. An account made with `postemi auth:signup`
+has no free trial: next come `postemi billing:plans` and
+`postemi billing:subscribe`. Signing up at https://postemi.com/app/signup
+instead starts a 7-day free trial; then run `postemi auth:login`.
 
 For a server, CI or an agent without a browser, use an API key from
 Settings, Developers in the web app:
@@ -62,9 +66,7 @@ export POSTEMI_API_KEY=your_api_key
 | `POSTEMI_AUTH_SERVER` | `https://api.postemi.com` | Where `auth:login` runs the device flow |
 | `POSTEMI_CLIENT_NAME` | `Postemi CLI` | Name shown on the approval page |
 
-Each `POSTEMI_*` variable falls back to its `POSTY_*` twin, so a machine set up
-for the Posty CLI keeps working. Stored credentials from `auth:login` take
-precedence over `POSTEMI_API_KEY`.
+Stored credentials from `auth:login` take precedence over `POSTEMI_API_KEY`.
 
 ## Quick start
 
@@ -81,6 +83,28 @@ postemi posts:create -c "Hello from the terminal" -m "$IMG" \
 Results are JSON on stdout; status lines and errors go to stderr, and every
 failure exits 1. Run `postemi <command> --help` for each command.
 
+## Agent skills (optional)
+
+The CLI can install its skills into the coding agents on your machine
+(Claude Code `~/.claude/skills`, Codex `~/.codex/skills` or
+`$CODEX_HOME/skills`, Cursor `~/.cursor/skills`, Grok Build
+`~/.grok/skills`). The core `postemi` skill comes with any of them; the other
+two are optional:
+
+```bash
+postemi skills list                    # core, writing, growth: installed where
+postemi skills add writing             # ideas, hooks, formatting, templates
+postemi skills add growth              # niche, cadence, 30-day plan
+postemi skills add all --agent claude --yes
+postemi skills remove growth
+```
+
+After `postemi auth:login` on a terminal the CLI asks once whether you want
+the writing and the growth skill (default No) and remembers the answers in
+`~/.postemi/config.json`. It never asks when an agent or a script runs it (no
+terminal, `--json`, or `CI` set); it prints one hint line instead, once.
+With several agents found it asks which; `--agent` and `--yes` skip that.
+
 ## More
 
 - [`SKILL.md`](./SKILL.md): every command, flag and rule
@@ -91,5 +115,59 @@ failure exits 1. Run `postemi <command> --help` for each command.
 - Help: https://postemi.com/help, support: norbert@postemi.com
 - Privacy: https://postemi.com/privacy, terms: https://postemi.com/terms
 
-License: AGPL-3.0. Source: https://github.com/norbertlevente/posty-agent
-(the same source builds the Posty CLI, `posty-cli`, for posty.hu).
+## Plugins for AI agents
+
+This repository also holds the Postemi plugins, in [`plugins/`](./plugins):
+
+| Folder | For | What it is |
+|---|---|---|
+| [`plugins/postemi-mcp`](./plugins/postemi-mcp) | Claude (chat, desktop, Code) | The hosted MCP server `https://mcp.postemi.com/mcp` plus a skill |
+| [`plugins/postemi-cli`](./plugins/postemi-cli) | Claude Code | This CLI's skill; the agent runs `postemi` commands |
+| [`plugins/postemi-chatgpt`](./plugins/postemi-chatgpt) | ChatGPT | The ChatGPT app package |
+| [`plugins/postemi-cursor`](./plugins/postemi-cursor) | Cursor | MCP server, skill and commands |
+| [`plugins/postemi-grok`](./plugins/postemi-grok) | Grok Build | MCP server, skill and commands |
+| [`plugins/postemi-growth`](./plugins/postemi-growth) | Claude Code, Cursor, Grok Build | Optional: the growth skill only |
+
+In Claude Code:
+
+```bash
+claude plugin marketplace add norbertlevente/postemi-agent
+claude plugin install postemi@postemi-agent        # MCP server
+claude plugin install postemi-cli@postemi-agent    # CLI skill
+```
+
+The skill on its own (for OpenClaw and other agents) is
+[`skills/postemi/SKILL.md`](./skills/postemi/SKILL.md).
+
+### Writing and growth skills
+
+Three more skills help the agent write the posts, not only schedule them:
+
+| Skill | What it teaches | In the plugins |
+|---|---|---|
+| [`skills/postemi-writing`](./skills/postemi-writing) | post ideas, hooks and headlines, opening lines, formatting, threads, each network's writing rules, a check before publishing | in every main plugin |
+| [`skills/postemi-templates`](./skills/postemi-templates) | the template and hook library of the Postemi composer, generated from the web app | in every main plugin, with writing |
+| [`skills/postemi-growth`](./skills/postemi-growth) | choosing networks and a first niche, a 30-day test, reading the numbers, cadence, 30 angles for one topic, repurposing, bios and profile links, a weekly review | optional: its own plugin, [`plugins/postemi-growth`](./plugins/postemi-growth) |
+
+```bash
+claude plugin install postemi-growth@postemi-agent   # the optional growth plugin
+```
+
+With the CLI, writing and growth are both optional; see below.
+
+## Development
+
+```bash
+pnpm install
+pnpm build        # dist/index.js
+pnpm test         # type check, build, unit tests (test/), scripts/check.mjs (manifests, skill copies, no other-brand text)
+node dist/index.js --help
+
+pnpm sync:templates ../postemi/src/lib/app/templates   # regenerate skills/postemi-templates/reference from the web app
+pnpm sync:skills                                       # copy writing and templates into the main plugins, growth into postemi-growth
+```
+
+Release steps: [`PUBLISHING.md`](./PUBLISHING.md). Changes: [`CHANGELOG.md`](./CHANGELOG.md).
+
+License: AGPL-3.0, see [`LICENSE`](./LICENSE).
+Source: https://github.com/norbertlevente/postemi-agent

package/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: postemi
-description: Postemi schedules and publishes social posts from the command line to 20 platforms, including Facebook, Instagram, X, LinkedIn, TikTok, YouTube, Threads, Bluesky, Pinterest and Mastodon.
+description: Postemi schedules and publishes social posts from the command line to 25+ platforms, including Facebook, Instagram, X, LinkedIn, TikTok, YouTube, Threads, Bluesky, Pinterest and Mastodon.
 homepage: https://postemi.com
 metadata: {"openclaw":{"emoji":"🌎","requires":{"bins":[],"env":[]}}}
 ---
@@ -33,36 +33,58 @@ MCP server, for chat clients without a terminal: https://mcp.postemi.com/mcp
 
 **Only these. Do not offer a user anything else, and do not try to post to it.**
 Postemi's server carries inherited code for many more providers; that code is not
-enabled and not supported.
-
-| Channel | `identifier` |
-|---|---|
-| X (Twitter) | `x` |
-| Facebook (Pages) | `facebook` |
-| Instagram | `instagram` |
-| LinkedIn (member feed) | `linkedin` |
-| TikTok | `tiktok` |
-| YouTube | `youtube` |
-| Threads | `threads` |
-| Bluesky | `bluesky` |
-| Telegram | `telegram` |
-| Discord | `discord` |
-| Slack | `slack` |
-| Pinterest (BETA) | `pinterest` |
-
-**Pinterest is a BETA channel.** Until Pinterest grants Postemi Standard access, a
-pin is visible only to the account that created it. Tell the user this before
-you schedule a pin. A pin needs a `board` id in `--settings`; get the ids with
-`postemi integrations:trigger <integration-id> boards` (see PROVIDER_SETTINGS.md).
+enabled and not supported. Postemi adds channels over time, so
+`integrations:list` (below) can show one that is not in this table yet.
+
+| Channel | `identifier` | Status |
+|---|---|---|
+| X (Twitter) | `x` | Live |
+| Facebook (Pages) | `facebook` | Live |
+| Instagram (business account through a Facebook Page) | `instagram` | Live |
+| Instagram (professional account, no Facebook Page) | `instagram-standalone` | Live |
+| LinkedIn (member feed) | `linkedin` | Live |
+| TikTok | `tiktok` | Live |
+| YouTube | `youtube` | Live |
+| Threads | `threads` | Live |
+| Bluesky | `bluesky` | Live |
+| Telegram | `telegram` | Live |
+| Discord | `discord` | Live |
+| Slack | `slack` | Live |
+| Pinterest | `pinterest` | Coming soon, not schedulable yet |
+| Mastodon (mastodon.social) | `mastodon` | BETA |
+| Mastodon (any other server) | `mastodon-custom` | BETA |
+| Pixelfed (any server) | `pixelfed` | BETA |
+| WordPress (your own site) | `wordpress` | BETA |
+| Tumblr | `tumblr` | BETA |
+| Dev.to | `devto` | BETA |
+| Ghost (your own site) | `ghost` | BETA |
+| Google Chat (a space, by webhook) | `google-chat` | BETA |
+| Microsoft Teams (a channel, by webhook) | `microsoft-teams` | BETA |
+| Google Business Profile | `gmb` | Coming soon, not schedulable yet |
+| LinkedIn Pages (company pages) | `linkedin-page` | Coming soon, not schedulable yet |
+
+**Pinterest is coming soon.** Postemi customers cannot connect it until Pinterest
+approves Postemi's app, so it never appears in `integrations:list`. Tell the user
+it is not available yet. (When it opens, a pin needs a `board` id in
+`--settings`; see PROVIDER_SETTINGS.md.)
+
+**The other BETA channels** connect and publish, but Postemi has not tried them
+with many real accounts yet. Say so when the user picks one. Most need
+settings (a title for WordPress, Dev.to and Ghost; a picture for Pixelfed);
+see PROVIDER_SETTINGS.md.
+
+**Google Business Profile and LinkedIn Pages are coming soon.** Those platforms
+have not approved Postemi yet, so the user cannot connect them. Do not schedule
+for them; personal LinkedIn profiles (`linkedin`) work today.
 
 **`integrations:list` is the truth.** The table says what Postemi supports; that
 command says what THIS user has actually connected. Check it before you
 schedule anything, and never post to an id that is not in its output.
 
-**Never assume another provider exists.** If a user asks for Mastodon, Reddit,
-Google Business Profile, Medium, Dev.to, WordPress, Tumblr, Farcaster or
-anything else, the answer is that Postemi does not offer it. Do not
-build a `--settings` payload for it.
+**Never assume another provider exists.** If a user asks for Reddit, Medium,
+Farcaster, Hashnode, Lemmy, Nostr, VK, a newsletter service or anything else
+that is not in the table, the answer is that Postemi does not offer it today.
+Do not build a `--settings` payload for it.
 
 ---
 
@@ -106,7 +128,8 @@ If not authenticated:
    You never see or handle a key.
 2. **No account yet:** `postemi auth:signup` creates one, see below. Only when
    the user asks you to create a Postemi account for them. They can also sign
-   up at https://postemi.com/app/signup and then run `postemi auth:login`.
+   up at https://postemi.com/app/signup, which starts a 7-day free trial, and
+   then run `postemi auth:login`.
 
 ### Creating an account for the user (no free trial)
 
@@ -518,9 +541,10 @@ postemi posts:create -c "Content" -s "2026-12-31T12:00:00Z" -m "$VIDEO_PATH" -i
 ### Pattern 1: Discover & Use Integration Tools
 
 **Most supported channels have no tools at all.** Of the channels in the table
-at the top of this file, four expose a tool: Instagram (`audioSearch`),
-Discord (`channels`), Slack (`channels`) and Pinterest (`boards`). X, Facebook, Threads, Bluesky,
-YouTube, LinkedIn, TikTok and Telegram expose none: `integrations:settings`
+at the top of this file, six expose a tool: Instagram (`audioSearch`),
+Discord (`channels`), Slack (`channels`), Pinterest (`boards`), WordPress
+(`postTypes`, `categoriesList`, `tagsList`) and Dev.to (`tags`,
+`organizations`). The others expose none: `integrations:settings`
 returns an empty `tools` array for them, and `integrations:trigger` on them
 returns `404 Tool not found`.
 
@@ -979,6 +1003,31 @@ State these plainly rather than attempting a workaround.
 
 ---
 
+## Optional skills: writing and growth
+
+Two more Postemi skills are optional. They are not installed unless the user
+chose them:
+
+| Skill | What it adds | Install |
+|---|---|---|
+| writing (`postemi-writing` + `postemi-templates`) | post ideas, hooks, formatting, each network's writing rules, the composer's templates | `postemi skills add writing` |
+| growth (`postemi-growth`) | choosing a niche, cadence per network, a 30-day plan, the weekly review | `postemi skills add growth` |
+
+```bash
+postemi skills list                          # core + optional, and where each is installed (JSON)
+postemi skills add writing --json            # into every agent found (Claude Code, Codex, Cursor, Grok Build)
+postemi skills add growth --agent claude --json
+postemi skills remove growth --json
+```
+
+When the user asks for help writing posts or planning content and
+`postemi skills list` shows the skill as missing, **offer** it: say what it
+adds and ask. Run `postemi skills add` only after the user says yes; never
+install it silently. Pass `--json` (or run without a terminal) so the CLI asks
+no questions; a new agent session loads the skills.
+
+---
+
 ## Supporting Resources
 
 **This file is the command reference.** Everything the CLI accepts is
@@ -1062,6 +1111,10 @@ postemi analytics:post <id> -d 30                 # Post analytics (30 days)
 postemi posts:missing <id>                         # List provider content
 postemi posts:connect <id> --release-id "<rid>"    # Connect content to post
 
+# Optional skills (ask the user first)
+postemi skills list                                # Core + optional skills, where installed
+postemi skills add writing|growth --json           # Install an optional skill
+
 # Help
 postemi --help                                     # Show help
 postemi posts:create --help                        # Command help