Mini Mod

Mini Mod is a lightweight moderation tool that helps you manage your Bluesky feeds directly from within the app—by replying to posts.

With Mini Mod, you don’t need to open any special tools or dashboards. Instead, you simply reply to a post with a specific instruction, and Mini Mod takes care of the rest.

We’ve outlined some basic information below to help you get started. The best way to learn Mini Mod is to jump in and try it—start with a simple rule and build from there!

---

How Mini Mod Works

Mini Mod works by watching for your replies to posts captured in your feed. When it sees one, it checks if that reply matches a rule you’ve set up. If it does, it takes an action like removing the post or adding it to a different feed.

Each rule is made up of:

• A name (for your reference)
• One or more conditions (what needs to be true for the rule to trigger)
• An event (what action to take if the conditions are met)

All Mini Mod rules are written in YAML and are attached to a specific feed. You don’t need to write code to use Mini Mod—just follow the simple format and you’ll be up and running in no time.

---

Example Mini Mod Rule

Here’s a basic rule that lets you add a post to a feed just by replying to it with a certain instruction:

feed_identifier: 🐦

rules:
  - name: Add post to feed
    conditions:
      all:
        - fact: matches_feed_identifier
          operator: equal
          value: true
    event:
      type: add

  - name: Remove post from feed
    conditions:
      all:
        - fact: instruction
          operator: equal
          value: x
    event:
      type: remove

What This Rule Does

• The Add rule checks if a post has the 🐦 emoji feed identifier and adds it to the feed.
• The Remove rule watches for replies where the text is exactly x and removes the post that was replied to.

---

Common Instructions

Here are some ideas for commands you might want to use in Mini Mod:

Instruction	What You Could Use It For
x	Remove the post from your feed
+	Add the post to your feed
flag	Mark a post for later review
!	Highlight or pin a notable post

You can define any instruction text you want—Mini Mod just needs to know what to look for in your replies.

---

Supported Events

These are the actions Mini Mod can take when a rule is triggered:

• add: Adds a post to your feed.
• remove: Removes a post from your feed.
• hide: Hides a post (it’s still technically in your feed but won’t show).
• log: Records the action in the logs for your review.
• require-approval: Marks a post for manual follow-up.
• pin / unpin Pins or unpins a post in your feed.
• create-post Send a Bluesky post on your behalf to the user. You can include @user in your post to mention the user in question

---

Tips for Success

• Be consistent: Choose short, memorable instructions so they’re easy to type.
• Start simple: One or two rules are enough to get going. You can always add more.
• Use emojis: Emojis can be handy instructions—just make sure to match them exactly in your conditions.
• Test with logs: Use the log event first to test your rule before enabling more destructive actions like remove.

---

Want more?

---

Want to expand beyond Mini Mod? Try Auto Moderator—a full-featured moderation engine for advanced filtering and feed control.