Agent skill

Discord Reader

by himself65 in himself65/finance-skills

Read Discord for financial research through opencli connected to the Discord desktop app: servers, channels, members, recent messages in the active channel, and message search.

MITAuto-check passedBusiness, Finance & HR

Install Discord Reader

skills CLI
$ npx skills add himself65/finance-skills --skill discord-reader -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install himself65/finance-skills discord-reader --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/himself65/finance-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/plugins/social-readers/skills/discord-reader .claude/skills/discord-reader && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
discord-reader
GitHub stars
3.4k
Token cost
~1.8k tokens
SKILL.md length
679 words
Files
3 (incl. references)
Skills in repo
22
Repo updated
First seen
Licence
MIT

At a glance

Read Discord for financial research through opencli connected to the Discord desktop app: servers, channels, members, recent messages in the active channel, and message search.

  • Works in 5 steps: Ensure opencli Is Installed and Discord… → Identify What the User Needs → Execute the Command → …
  • The user wants to check their Discord
  • SKILL.md covers Step 1: Ensure opencli Is…, Step 2: Identify What the User…, Step 3: Execute the Command and Step 4: Present the Results, plus 3 more sections
  • Calls npm

What it does

Discord Reader is an agent skill from himself65/finance-skills. Read Discord for financial research through opencli connected to the Discord desktop app: servers, channels, members, recent messages in the active channel, and message search. Use this skill whenever the user wants to check their Discord, list servers or channels, read or search messages in trading, crypto, or market communities, or gauge what a Discord community is saying about a ticker or coin. Read-only: it cannot send, react to, edit, or delete messages.

Its SKILL.md is about 1.8k tokens, which your agent loads only when the skill is triggered. The skill folder holds 3 other files, including reference files (for example `README.md` and `references/commands.md`).

It sits in Business, Finance & HR, covering Trading and backtesting. It works with Discord and React. The repository describes itself as: A collection of skills for AI financial analysis. The licence is MIT.

When your agent uses it

  • The user wants to check their Discord
  • Search messages in trading
  • Market communities
  • Gauge what a Discord community is saying about a ticker

Example prompts

  • “/discord-reader”

Requirements

  • Node.js

Workflow steps

5 steps, taken from the step headings in SKILL.md.

  1. Ensure opencli Is Installed and Discord Is Ready
  2. Identify What the User Needs
  3. Execute the Command
  4. Present the Results
  5. Diagnostics

What it can do on your machine

Read from SKILL.md and the folder at commit 01fc7b4. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • npm

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Links to these hosts (documentation or services it may open):

    • github.com

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Discord Reader loads about 1.8k tokens when it runs, and up to ~3.4k if it reads all its reference files. Until then it costs about 120 tokens; SKILL.md has 679 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~120
When it runs · the whole SKILL.md, loaded when a task matches
~1.8k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~3.4k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from himself65/finance-skills at commit 01fc7b4, republished under its MIT licence (© himself65). 679 words, ~1,836 tokens.

Download SKILL.mdSave it as .claude/skills/discord-reader/SKILL.md (or your agent's skills folder). This skill also uses 2 other files; get the full folder from GitHub.
name
discord-reader
description
Read Discord for financial research through opencli connected to the Discord desktop app: servers, channels, members, recent messages in the active channel, and message search. Use this skill whenever the user wants to check their Discord, list servers or channels, read or search messages in trading, crypto, or market communities, or gauge what a Discord community is saying about a ticker or coin. Read-only: it cannot send, react to, edit, or delete messages.

Discord Skill (Read-Only)

Reads Discord for financial research using opencli, a universal CLI tool that bridges desktop apps and web services to the terminal via Chrome DevTools Protocol (CDP).

This skill is read-only. It is designed for financial research: searching trading server discussions, monitoring crypto/market groups, tracking sentiment in financial communities, and reading messages. It does NOT support sending messages, reacting, editing, deleting, or any write operations.

Important: opencli connects to the Discord desktop app via CDP — no bot account or token extraction needed. Just have Discord Desktop running.


Step 1: Ensure opencli Is Installed and Discord Is Ready

Current environment status:

!`(command -v opencli && opencli discord-app status 2>&1 | head -5 && echo "READY" || echo "SETUP_NEEDED") 2>/dev/null || echo "NOT_INSTALLED"`

If the status above shows READY, skip to Step 2. If NOT_INSTALLED, install first:

bash
# Install opencli globally
npm install -g @jackwener/opencli

If SETUP_NEEDED, guide the user through setup:

Setup

opencli requires Node.js >= 20. It connects to Discord Desktop via CDP (Chrome DevTools Protocol) — no Browser Bridge extension is needed for the Discord adapter. Two things are required:

  1. Start Discord with remote debugging enabled:
bash
# macOS
/Applications/Discord.app/Contents/MacOS/Discord --remote-debugging-port=9232 &

# Linux
discord --remote-debugging-port=9232 &
  1. Set the CDP endpoint environment variable:
bash
export OPENCLI_CDP_ENDPOINT="http://127.0.0.1:9232"

Add this to your shell profile (.zshrc / .bashrc) so it persists across sessions.

  1. Verify connectivity:
bash
opencli discord-app status
Common setup issues
SymptomFix
CDP connection refusedEnsure Discord is running with --remote-debugging-port=9232
OPENCLI_CDP_ENDPOINT not setRun export OPENCLI_CDP_ENDPOINT="http://127.0.0.1:9232"
status shows disconnectedRestart Discord with the CDP flag and retry
Discord not on expected portCheck that no other app is using port 9232, or use a different port
Tip: create a shell alias
bash
alias discord-cdp='/Applications/Discord.app/Contents/MacOS/Discord --remote-debugging-port=9232 &'

Step 2: Identify What the User Needs

Match the user's request to one of the read commands below, then use the corresponding command from references/commands.md.

User RequestCommandKey Flags
Connection checkopencli discord-app status—
List serversopencli discord-app servers-f json
List channelsopencli discord-app channels-f json
List online membersopencli discord-app members-f json
Read recent messagesopencli discord-app readN (count), -f json
Search messagesopencli discord-app search "QUERY"-f json

Note: opencli operates on the currently active server and channel in Discord. To read from a different channel, the user must navigate to it in the Discord app first, or use the channels command to identify what's available.


Step 3: Execute the Command

General pattern
bash
# Use -f json or -f yaml for structured output
opencli discord-app servers -f json
opencli discord-app channels -f json

# Read recent messages from the active channel
opencli discord-app read 50 -f json

# Search for financial topics in the active channel
opencli discord-app search "AAPL earnings" -f json
opencli discord-app search "BTC pump" -f json
Key rules
  1. Check connection first — run opencli discord-app status before any other command
  2. Use -f json or -f yaml for structured output when processing data programmatically
  3. Navigate in Discord first — opencli reads from the currently active server/channel in the Discord app
  4. Start with small reads — use opencli discord-app read 20 unless the user asks for more
  5. Use search for keywords — opencli discord-app search uses Discord's built-in search (Cmd+F / Ctrl+F)
  6. Read-only — opencli also exposes discord-app send and discord-app delete; don't invoke them, and don't send messages, react, edit, delete, or manage server settings.
Show full SKILL.md (224 more words)Show less
Output format flag (-f)
FormatFlagBest for
Table-f table (default)Human-readable terminal output
JSON-f jsonProgrammatic processing, LLM context
YAML-f yamlStructured output, readable
Markdown-f mdDocumentation, reports
CSV-f csvSpreadsheet export
Typical workflow for reading a server
bash
# 1. Verify connection
opencli discord-app status

# 2. List servers to confirm you're in the right one
opencli discord-app servers -f json

# 3. List channels in the current server
opencli discord-app channels -f json

# 4. Read recent messages (navigate to target channel in Discord first)
opencli discord-app read 50 -f json

# 5. Search for topics of interest
opencli discord-app search "price target" -f json

Step 4: Present the Results

Lead with what matters for the user's research question rather than a raw dump. Attribute each message (username, timestamp, content), group search results by theme, and note the bullish or bearish lean and where views are consensus or contrarian. Show server and channel listings as a table of names and types. Keep CDP endpoints and session details private.


Step 5: Diagnostics

If something isn't working, check:

  1. Is Discord running with CDP?
bash
# Check if the port is open
lsof -i :9232
  1. Is the environment variable set?
bash
echo $OPENCLI_CDP_ENDPOINT
  1. Can opencli connect?
bash
opencli discord-app status

If all checks fail, restart Discord with the CDP flag:

bash
/Applications/Discord.app/Contents/MacOS/Discord --remote-debugging-port=9232 &
export OPENCLI_CDP_ENDPOINT="http://127.0.0.1:9232"
opencli discord-app status

Error Reference

ErrorCauseFix
CDP connection refusedDiscord not running with CDP or wrong portStart Discord with --remote-debugging-port=9232
OPENCLI_CDP_ENDPOINT not setMissing environment variableexport OPENCLI_CDP_ENDPOINT="http://127.0.0.1:9232"
No active channelNot viewing any channel in DiscordNavigate to a channel in the Discord app
Rate limitedToo many requestsWait a few minutes, then retry

Reference Files

  • references/commands.md — Complete read command reference with all flags and usage examples

Read the reference file when you need exact command syntax or detailed flag descriptions.

© himself65, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 2 other files (references) in plugins/social-readers/skills/discord-reader of himself65/finance-skills.

  • SKILL.md
  • README.md
  • references/commands.md

Open the folder on GitHubat commit 01fc7b4

Compare with similar skills

Discord Reader next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Discord Reader compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Discord Reader this skillhimself65/finance-skills3.4k—~1.8kAutomated safety check: PassMIT
Opencatz Swarm Tradingmuratmula/ai-robinhood-chain1341 repos~1.4kAutomated safety check: PassMIT
Social Media IntelligenceHKUDS/Vibe-Trading35k—~10kAutomated safety check: NotesMIT
Tushare Datazillionare/zillionare3182 repos~2.3kAutomated safety check: PassNone
Tradingview MCPatilaahmettaner/tradingview-mcp4.9k—~1.3kAutomated safety check: PassMIT
Digital Oraclekomako-workshop/digital-oracle867—~5.9kAutomated safety check: PassMIT

Similar skills

  • Opencatz Swarm Trading

    muratmula/ai-robinhood-chain

    Autonomous multi-agent crypto trading skill for Robinhood Chain EVM DEX tokens and NFTs using 3-layer Swarm Consensus, Discord Command Center, and Position Management.

    134 GitHub starsUsed in 1 repo~1.4k tokens
    Business, Finance & HRAuto-check passed
  • Social Media Intelligence

    HKUDS/Vibe-Trading

    Social media intelligence: financial signal extraction from Twitter/X, Telegram, Discord, and Reddit for sentiment-driven trading strategies.

    35k GitHub stars~10k tokensUpdated yesterday
    Business, Finance & HRAuto-check: notes
  • Tushare Data

    zillionare/zillionare

    面向中文自然语言的 Tushare 数据研究技能。用于把“看看这只股票最近怎么样”“帮我查财报趋势”“最近哪个板块最强”“北向资金在买什么”“给我导出一份行情数据”这类请求,转成可执行的数据获取、清洗、对比、筛选、导出与简要分析流程。适用于 A 股、指数、ETF/基金、财务、估值、资金流、公告新闻、板块概念与宏观数据等研究场景。

    318 GitHub starsUsed in 2 repos~2.3k tokens
    Business, Finance & HRAuto-check passed
  • Tradingview MCP

    atilaahmettaner/tradingview-mcp

    AI Trading Intelligence — live prices, 30+ technical indicators, backtesting (6 strategies), walk-forward overfitting detection, trade logs, equity curves, licensed news sentiment (Marketaux), and…

    4.9k GitHub stars~1.3k tokensUpdated yesterday
    Business, Finance & HRAuto-check passed
  • Digital Oracle

    komako-workshop/digital-oracle

    Answer prediction questions using market trading data, not opinions.

    867 GitHub stars~5.9k tokensUpdated 2 mo ago
    Business, Finance & HRAuto-check passed
  • Polyclaw

    chainstacklabs/polyclaw

    Trade on Polymarket via split + CLOB execution. An agent skill from chainstacklabs/polyclaw.

    360 GitHub starsUsed in 1 repo~2k tokens
    Business, Finance & HRAuto-check passed

More from himself65/finance-skills

All 22 skills in this repo
  • Company Valuation

    himself65/finance-skills

    Estimate a public company's intrinsic value with DCF, relative (peer multiple), and sum-of-the-parts (SOTP) methods, then blend them into an implied share price with upside/downside vs the market…

    3.4k GitHub stars~3.3k tokensUpdated 2 days ago
    Auto-check passed
  • Earnings Preview

    himself65/finance-skills

    Build a pre-earnings briefing for a stock from Yahoo Finance data (yfinance): the upcoming report date and timing, consensus EPS and revenue estimates with their range, the beat/miss track record…

    3.4k GitHub stars~1.4k tokensUpdated 2 days ago
    Auto-check passed
  • Earnings Recap

    himself65/finance-skills

    Analyze a company's most recent (or a specified past) earnings report from Yahoo Finance data (yfinance): actual vs estimated EPS, surprise size, revenue and margin trends, and the stock's price…

    3.4k GitHub stars~1.7k tokensUpdated 2 days ago
    Auto-check passed
  • Estimate Analysis

    himself65/finance-skills

    Analyze sell-side analyst estimates and how they are changing, using Yahoo Finance data (yfinance): EPS and revenue consensus by period, estimate ranges and dispersion, revision trends over…

    3.4k GitHub stars~1.8k tokensUpdated 2 days ago
    Auto-check passed
  • Fintel Data

    himself65/finance-skills

    Query Fintel (fintel.io) institutional market data through its REST API or official MCP server.

    3.4k GitHub stars~2.2k tokensUpdated 2 days ago
    Auto-check: notes
  • Generative UI

    himself65/finance-skills

    Design system and templates for Claude's built-in generative UI — the showwidget tool that renders interactive HTML/SVG widgets inline in claude.ai conversations.

    3.4k GitHub stars~3.1k tokensUpdated 2 days ago
    Auto-check passed

Works with

Questions about Discord Reader

What does Discord Reader do?

Read Discord for financial research through opencli connected to the Discord desktop app: servers, channels, members, recent messages in the active channel, and message search. Discord Reader is an agent skill from himself65/finance-skills. Read Discord for financial research through opencli connected to the Discord desktop app: servers, channels, members, recent messages in the active channel, and message search.

When should I use Discord Reader?

Discord Reader fits situations like: the user wants to check their Discord; search messages in trading; market communities; gauge what a Discord community is saying about a ticker.

How do I install Discord Reader in Claude Code?

Run `npx skills add himself65/finance-skills --skill discord-reader -a claude-code`. Or copy the skill folder (plugins/social-readers/skills/discord-reader in himself65/finance-skills) into .claude/skills/discord-reader in your project. Claude Code loads it when a task matches its description.

How do I install Discord Reader in Codex?

Run `npx skills add himself65/finance-skills --skill discord-reader -a codex`. Or copy the skill folder (plugins/social-readers/skills/discord-reader in himself65/finance-skills) into .agents/skills/discord-reader in your project. Codex loads it when a task matches its description.

Can I use Discord Reader in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add himself65/finance-skills --skill discord-reader -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/discord-reader, .gemini/skills/discord-reader, .github/skills/discord-reader and .opencode/skills/discord-reader in your project.

What does Discord Reader need to run?

Going by SKILL.md and its folder, Discord Reader needs the command-line tools its instructions call (npm). Our summary lists: Node.js.

Does Discord Reader access the network?

SKILL.md names 1 domain. As links in the text: github.com. This is read from the text; nothing was executed.

Is Discord Reader safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Discord Reader use?

Discord Reader is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Discord Reader use?

About 1.8k tokens (SKILL.md is roughly 7.3k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 1.6k tokens, read only when the agent opens those files.

What are the alternatives to Discord Reader?

Skills that share tags, products or a category with Discord Reader: Opencatz Swarm Trading (muratmula/ai-robinhood-chain, 134 stars), Social Media Intelligence (HKUDS/Vibe-Trading, 35k stars), Tushare Data (zillionare/zillionare, 318 stars) and Tradingview MCP (atilaahmettaner/tradingview-mcp, 4.9k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Discord Reader?

himself65 (a GitHub user) maintains it in himself65/finance-skills, which has 3,382 GitHub stars. The repository holds 22 skills in this directory. The repository was last updated on October 5, 2026.

Source: himself65/finance-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.