How do I install the Minipostiz Mastodon Setup skill?

Run npx skillmds@latest add javimosch/minipostiz-mastodon-setup-2 in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Minipostiz Mastodon Setup safe to use?

This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: CAUTION, Skill Scanner: PASS. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Minipostiz Mastodon Setup?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Minipostiz Mastodon Setup free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Minipostiz Mastodon Setup?

javimosch (@javimosch) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Minipostiz Mastodon Setup by javimosch

Name: Minipostiz Mastodon Setup
Author: javimosch

File contents

minipostiz-cli — Mastodon Setup

Mastodon is federated — your instance URL matters. Each instance has its own API.

What you need

Credential	Flag
Instance URL	`--instanceUrl` (e.g. `https://mastodon.social`)
Access Token	`--accessToken`

Step 1 — Create an Application on your instance

Log in to your Mastodon instance (e.g. https://mastodon.social)
Go to Preferences → Development → New application
Fill in:
- Application name: minipostiz
- Website: any URL
- Redirect URI: leave as urn:ietf:wg:oauth:2.0:oob
- Scopes: check write:statuses and write:media (uncheck everything else)
Click Submit
Click the app name → copy Your access token

The access token shown on the app page is already authorized for your account — no OAuth flow needed.

Step 2 — Store in minipostiz-cli

minipostiz auth --platform mastodon \
  --instanceUrl "https://mastodon.social" \
  --accessToken "YOUR_ACCESS_TOKEN"

# Or via supercli
sc minipostiz auth set-mastodon \
  --instanceUrl "https://mastodon.social" \
  --accessToken "YOUR_ACCESS_TOKEN"

Replace mastodon.social with your actual instance domain.

Step 3 — Test

minipostiz auth verify --platform mastodon
minipostiz publish --platform mastodon --message "Hello from minipostiz-cli"

Visibility options

Store a default visibility by adding it to auth:

minipostiz auth --platform mastodon \
  --instanceUrl "https://mastodon.social" \
  --accessToken "TOKEN" \
  --visibility "unlisted"   # public | unlisted | private | direct

Troubleshooting

Error	Cause	Fix
`401 Unauthorized`	Invalid token	Regenerate token in Preferences → Development
`422 Unprocessable`	Missing `write:statuses` scope	Recreate app with correct scopes
`Connection refused`	Wrong instance URL	Verify URL includes `https://` and no trailing slash issues

Token lifetime

Mastodon access tokens do not expire unless the application is deleted or access is revoked.

---name: minipostiz-mastodon-setup-2description: Mastodon API setup for minipostiz-cli — create application, get access token, store instance URL + token---# minipostiz-cli — Mastodon SetupMastodon is federated — your instance URL matters. Each instance has its own API.## What you need| Credential | Flag ||------------|------|| Instance URL | `--instanceUrl` (e.g. `https://mastodon.social`) || Access Token | `--accessToken` |---## Step 1 — Create an Application on your instance1. Log in to your Mastodon instance (e.g. https://mastodon.social)2. Go to **Preferences** → **Development** → **New application**3. Fill in: - Application name: `minipostiz` - Website: any URL - Redirect URI: leave as `urn:ietf:wg:oauth:2.0:oob` - Scopes: check **`write:statuses`** and **`write:media`** (uncheck everything else)4. Click **Submit**5. Click the app name → copy **Your access token**> The access token shown on the app page is already authorized for your account — no OAuth flow needed.---## Step 2 — Store in minipostiz-cli```bashminipostiz auth --platform mastodon \ --instanceUrl "https://mastodon.social" \ --accessToken "YOUR_ACCESS_TOKEN"# Or via superclisc minipostiz auth set-mastodon \ --instanceUrl "https://mastodon.social" \ --accessToken "YOUR_ACCESS_TOKEN"```Replace `mastodon.social` with your actual instance domain.---## Step 3 — Test```bashminipostiz auth verify --platform mastodonminipostiz publish --platform mastodon --message "Hello from minipostiz-cli"```---## Visibility optionsStore a default visibility by adding it to auth:```bashminipostiz auth --platform mastodon \ --instanceUrl "https://mastodon.social" \ --accessToken "TOKEN" \ --visibility "unlisted" # public | unlisted | private | direct```---## Troubleshooting| Error | Cause | Fix ||-------|-------|-----|| `401 Unauthorized` | Invalid token | Regenerate token in Preferences → Development || `422 Unprocessable` | Missing `write:statuses` scope | Recreate app with correct scopes || `Connection refused` | Wrong instance URL | Verify URL includes `https://` and no trailing slash issues |## Token lifetimeMastodon access tokens **do not expire** unless the application is deleted or access is revoked.

Frequently asked questions

Minipostiz Mastodon Setup