agentleFS
matthewdonsemail-labmatthewdonsemail-lab/log/skills/discordServers/SKILL.md

discordServers

Skill63 starsChanged yesterdayMITView on GitHub

What a Discord server holds (categories, text and announcement channels, forums and their posts, media channels, threads, voice and stage channels, messages and their attachments) and which Log tool lists or reads each one, live and fast, with no script over a saved dump. Use whenever the work is in a server rather than a DM or group DM.

The file

We split this skill into the rules it gives an agent

2 rules. About 0 are common, 2 are distinctive, and 0 are very specific to this project.

  • ≈0

    Common · estimate

    Many files like this have a rule of this kind.

  • ≈2

    Distinctive · estimate

    This author's own choices. Worth a look.

  • 0

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Distinctive:

    Never run a script over saved output: Every answer above is plain text made for reading.

    line 32
  2. Distinctive:

    Every request counts on the account's governor.

    line 37

≈ “Common” is an estimate: at least 1 in 5 of the 350,495 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

discordServers

A Discord server is not a group DM. A group DM is a private chat of a few people, listed by discordChats and kept whole in log.db. A server is someone else's space: it holds channels of several kinds, some of which hold posts or threads, and log.db keeps only the mentions of the account and replies to it from it. So a server is always read live from Discord, through the tools below, each one a request or a few.

What a server holds

ThingWhat it isHow it is namedListed byRead by
ServerThe whole space: an owner, mods, rules, membersits name, "pennyserver"discordServersdiscordChannels, discordSearch
CategoryA heading that groups channels; holds no messagesits name, shown above its channelsdiscordChannelsnothing to read
Text channelA room of messages in time order"<server> #<channel>"discordChannels (text)discordRead
Announcement channelA text channel only some can post in, others follow it"<server> #<channel>"discordChannels (announcement)discordRead
Forum channelHolds posts, never loose messages; each post is its own conversation with a title, tags and an opening message"<server> #<forum>"discordChannels (forum, with its tags)discordPosts lists its posts
Media channelA forum whose posts open with an image or video"<server> #<channel>"discordChannels (media)discordPosts
PostOne conversation inside a forum or media channel: a title, who opened it, tags, an opening message, then replies"<server> #<forum> > <post title>"discordPostsdiscordRead
ThreadA side conversation started from a message in a text channel"<server> #<channel> > <thread title>"discordPosts on the text channeldiscordRead
Voice or stage channelLive talk; holds no text the tools read"<server> #<channel>"discordChannels (voice, stage)nothing to read
MessageOne message in a channel, post or thread: its author, time, text, what it replies toits id, from a readdiscordRead, discordSearchdiscordRead around it
AttachmentAn image, video, file or voice note on a messageits namediscordReaddiscordRead saves images and transcribes voice notes; noMedia skips both

Finding things fast

  • Know what's there: discordServers, then discordChannels { server } shows every channel by category and kind in one request.
  • Find a conversation: discordSearch { server, query } searches every channel, post and thread at once with Discord's own search, and names where each hit is. Add channel to keep one channel and from to keep one person. Never read a channel back hundreds of messages to look for something search can find.
  • Work a forum: discordPosts { channel: "<server> #<forum>" } lists its posts newest activity first, with each one's title, author, tags, replies and opening message, so most posts are judged without opening them. Read the ones worth it with discordRead { channel: "<server> #<forum> > <post title>" }.
  • Skim a busy channel: discordRead with noMedia reads text only. Without it, every image is saved and every voice note transcribed first, which took most of a minute for 400 messages of "pennyserver #general".
  • Never run a script over saved output. Every answer above is plain text made for reading. When it isn't enough, the tool is missing a flag: add it to the tool, don't filter a dump.

Hard boundaries

  1. Reading sends nothing. Answering in a server is serverReply; every send keeps its gates (rules 8, 94, 137).
  2. Every request counts on the account's governor. A 429 or a refusal stops the run and the account pauses; nothing retries (rule 94).
  3. A server channel, post or thread is named, never passed by its id (rule 154).
  4. A server is its owner's room. Its rules hold: no selling or promoting where the owner said not to.

Code: python/discordApi/engine.py (servers_of, channels_of, posts_of, search_of), src/cli/discord/index.ts (discordServersCommand, discordChannelsCommand, discordPostsCommand, discordSearchCommand). Plays: forumPosts, serverSearch, serverReply.

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.