Post statuses, media, polls, and threads to Mastodon via the REST API.
npx skills add https://github.com/jcrabapple/hermes-skills --skill mastodon-jcrabapple
Please help me install this Agent Skill. Skill: mastodon Source: https://github.com/jcrabapple/hermes-skills/tree/main/mastodon Command: npx skills add https://github.com/jcrabapple/hermes-skills --skill mastodon-jcrabapple
mastodon_post.py CLI handles character normalization (URLs count as 23 chars), multipart uploads, and a preview mode before anything goes live. - OAuth Re-Authorization: A dedicated script re-registers the OAuth app to change the "via" client label, with documented scope requirements to avoid breaking admin tooling. - Use Case: Ask the agent to research a topic and post a summary to Mastodon; it drafts a plain-text post with hashtags and a source link, dry-runs it to verify the character count, posts it, and returns the live URL. ## Quick Start Post this message to my Mastodon account with two hashtags and confirm the live URL.High-intent search queries and answers about installing and using this skill.
Run the mastodon_post.py helper with --status followed by your text. It reads the bearer token from ~/.hermes/secrets/mastodon_token, posts to the instance API, and prints the live URL and status ID on success.
Upload the image first to the /api/v1/media endpoint with a description field, then reference the returned media ID in media_ids[] when creating the status. The helper script combines both steps via --media and --alt flags.
Mastodon counts every URL as exactly 23 characters regardless of actual length. The skill normalizes URLs to 23-character placeholders before counting, so long links do not inflate the total against the 1989-character limit.
Shell escaping breaks on newlines, emoji, dollar signs, and nested quotes in curl -F arguments. Use the Python helper script or a requests-based script instead of inline curl for anything beyond a single-line post.
Yes, pass scheduled_at as a UTC ISO 8601 datetime at least 5 minutes in the future when creating the status. The response contains scheduled_at instead of a URL, and the post appears only at the scheduled time.
The re-authorization script registers an app with only read, write, follow, and push scopes, overwriting the shared token. Admin cron jobs need admin:read and admin:write scopes, so re-authorize with the full scope set documented in the references.
framerslabAutomate Mastodon posting, replying, boosting, following, and analytics via ActivityPub.
LuminaVaultMonitor stocks, crypto, and news markets and send alerts to Discord, Telegram, or Slack.
browser-actExtracts structured Douyin video search results with author, stats, hashtags, and download URLs.
synapz-orgManage social media content via the Typefully API v2.