mcpbeat

Mastodon Style

vercel-labs/mastodon-style

Use when drafting or editing a post (toot) for Mastodon / the fediverse.

2k tokens
context cost
the whole folder, loaded on every use
4
files
instructions only
0
copies elsewhere
how many repositories repackaged it
359
stars on the repo
on the repository, not the skill itself

Install

one command, takes just this skill from the repository
npx skills add https://github.com/vercel-labs/marketing-team-eve-template --skill mastodon-style

What comes with it

5 016 bytes besides the instruction
references/banned-words.json
references/best-practices.md
references/post-specs.md

The instruction itself

3 sections, as written by the author

Mastodon voice & style

When writing or editing a post for Mastodon:

  • Fediverse culture is earnest and community-first, with no ads and no algorithm pushing reach. Write like a member of the community, not a brand broadcasting to it: lead with value or a real question, never announcement-speak or growth-hacking.
  • ~500 characters (the common default; some instances allow more). No need to fill it.
  • Link directly to the source. Every link counts as a flat 23 characters, so don't use a shortener; Mastodon's docs discourage it.
  • Add alt text to every image. It's a strong, near-universal accessibility norm, not a nicety.
  • Use a content warning (CW) for sensitive, spoiler, or long content so it collapses behind a short label; it's considerate, not censorship, and doubles as a subject line.
  • Topical hashtags drive discovery: public posts surface in search mainly via their tags (full-text search is opt-in). Use a few relevant ones in CamelCase (e.g. #WebDev) so screen readers parse the words; a handful, not a wall, and never numbers only.
  • The feed is chronological, so write each post to stand on its own.

Structure

  • Open: the honest hook or the question, line one.
  • Body: the substance, plainly.
  • Close: the takeaway or a genuine invitation, then a few CamelCase hashtags.

References

  • references/best-practices.md: researched tactics as a checklist, with sources.
  • references/post-specs.md: hard constraints (character limit, links, CW, alt text, hashtags).
  • references/banned-words.json: the words to avoid. The lint_against_style tool checks a draft against this list (surface mastodon), so run the tool rather than reading the file.

General prose quality (AI-tell phrases to avoid, plain-English word swaps) is covered by the writing-quality skill; apply it to every draft alongside this one.

How to use it

Copy the folder

Take vercel-labs/mastodon-style from the repository into ~/.claude/skills for personal use, or into .claude/skills inside a project.

Check the name does not clash

The agent identifies a skill by the name field in its header. Two skills with the same name cannot sit side by side — one of them will be ignored.