Agent skill

Discord CLI

Discord CLI with YAML-first structured output for AI agents — fetch chat history, search messages, sync channels, and AI analysis

Apache-2.0Auto-check passedAI & LLM Engineering

Install Discord CLI

skills CLI

$ npx skills add jackwener/discord-cli --skill discord-cli -a claude-code

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

GitHub CLI

$ gh skill install jackwener/discord-cli discord-cli --agent claude-code

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

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

Paste into Claude Code

Install the "discord-cli" agent skill from https://github.com/jackwener/discord-cli/tree/main into .claude/skills/discord-cli/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "discord-cli", then confirm the skill loads.

Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add jackwener/discord-cli --skill discord-cli -a codex

Project install goes to .agents/skills/; add -g for ~/.codex/skills/.

GitHub CLI

$ gh skill install jackwener/discord-cli discord-cli --agent codex

Project scope by default (.agents/skills/); add --scope user for a personal install.

Codex skills documentation · loads skills from .agents/skills/

Paste into Codex

Install the "discord-cli" agent skill from https://github.com/jackwener/discord-cli/tree/main into .agents/skills/discord-cli/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "discord-cli", then confirm the skill loads.

Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add jackwener/discord-cli --skill discord-cli -a cursor

Project install goes to .agents/skills/; add -g for ~/.cursor/skills/.

GitHub CLI

$ gh skill install jackwener/discord-cli discord-cli --agent cursor

Project scope by default (.agents/skills/); add --scope user for a personal install.

Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/

Paste into Cursor

Install the "discord-cli" agent skill from https://github.com/jackwener/discord-cli/tree/main into .cursor/skills/discord-cli/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "discord-cli", then confirm the skill loads.

Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add jackwener/discord-cli --skill discord-cli -a gemini-cli

Project install goes to .agents/skills/; add -g for ~/.gemini/skills/.

GitHub CLI

$ gh skill install jackwener/discord-cli discord-cli --agent gemini-cli

Project scope by default (.agents/skills/); add --scope user for a personal install.

Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/

Paste into Gemini CLI

Install the "discord-cli" agent skill from https://github.com/jackwener/discord-cli/tree/main into .gemini/skills/discord-cli/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "discord-cli", then confirm the skill loads.

Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

GitHub CLI

$ gh skill install jackwener/discord-cli discord-cli

Installs for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).

skills CLI

$ npx skills add jackwener/discord-cli --skill discord-cli -a github-copilot

Project install goes to .agents/skills/; add -g for ~/.copilot/skills/.

GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/

Paste into GitHub Copilot

Install the "discord-cli" agent skill from https://github.com/jackwener/discord-cli/tree/main into .github/skills/discord-cli/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "discord-cli", then confirm the skill loads.

GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add jackwener/discord-cli --skill discord-cli -a opencode

OpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.

GitHub CLI

$ gh skill install jackwener/discord-cli discord-cli --agent opencode

Project scope by default (.agents/skills/); add --scope user for a personal install.

OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/

Paste into OpenCode

Install the "discord-cli" agent skill from https://github.com/jackwener/discord-cli/tree/main into .opencode/skills/discord-cli/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "discord-cli", then confirm the skill loads.

OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

Facts

Skill name: discord-cli
GitHub stars: 133
Token cost: ~972 tokens
SKILL.md length: 181 words
Files: 34
Skills in repo: 1
Repo updated: Mar 14, 2026
First seen: Oct 7, 2026
Licence: Apache-2.0

At a glance

Discord CLI with YAML-first structured output for AI agents — fetch chat history, search messages, sync channels, and AI analysis

Works in 6 steps: Prefer --yaml for structured output… → Use -n to keep result sets small and… → Use -o with export to save large… → …
Tasks that involve Structured output and tool calling
SKILL.md covers Agent Defaults, Prerequisites, Commands and Workflow: Before Using, plus 3 more sections
Runs Python scripts from its folder; calls uv

What it does

Discord CLI is an agent skill from jackwener/discord-cli. Discord CLI with YAML-first structured output for AI agents — fetch chat history, search messages, sync channels, and AI analysis

Its SKILL.md is about 970 tokens, which your agent loads only when the skill is triggered. The skill folder holds 38 other files (for example `.github/ISSUE_TEMPLATE/bug_report.yml`, `.github/ISSUE_TEMPLATE/feature_request.yml` and `.github/workflows/ci.yml`).

It sits in AI & LLM Engineering, covering Structured output and tool calling. It works with Discord. The repository describes itself as: A CLI for Discord — local-first sync, search, export, and AI analysis via SQLite. The licence is Apache-2.0.

When your agent uses it

Tasks that involve Structured output and tool calling

Example prompts

“/discord-cli”

Requirements

Python 3

Workflow steps

6 steps, taken from the first numbered list in SKILL.md.

Prefer --yaml for structured output unless a strict JSON parser is required.
Use -n to keep result sets small and token-efficient.
Use -o with export to save large datasets to a file.
Prefer specific queries over broad ones. Example: use discord search "keyword" -c general --yaml instead of scanning all channels.
Non-TTY stdout defaults to YAML automatically. Use OUTPUT=yaml|json|rich|auto to override.
All machine-readable output uses the envelope documented in SCHEMA.md.

What it can do on your machine

Read from SKILL.md and the folder at commit ce32e6b. 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
Ships script files (Python, from the files we listed), which the agent can run.
Shell commands in SKILL.md call:
- uv
From the folder's file list and the shell code blocks in SKILL.md.
Network
No URLs in SKILL.md. Its commands use uv, which can reach the network depending on how they are called.
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 CLI loads about 972 tokens when it runs. Until then it costs about 35 tokens; SKILL.md has 181 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it: ~35
When it runs · the whole SKILL.md, loaded when a task matches: ~972

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 jackwener/discord-cli at commit ce32e6b, republished under its Apache-2.0 licence (© jackwener). 181 words, ~972 tokens.

Download SKILL.mdSave it as .claude/skills/discord-cli/SKILL.md (or your agent's skills folder). This skill also uses 33 other files; get the full folder from GitHub.

name: discord-cli
description: Discord CLI with YAML-first structured output for AI agents — fetch chat history, search messages, sync channels, and AI analysis
author: jackwener
version: 0.2.8
tags: discord, chat, sync, ai-analysis, cli

discord-cli Skill

CLI tool for Discord — fetch chat history, search messages, sync channels, AI analysis.

Agent Defaults

When you need machine-readable output:

Prefer --yaml for structured output unless a strict JSON parser is required.
Use -n to keep result sets small and token-efficient.
Use -o <file> with export to save large datasets to a file.
Prefer specific queries over broad ones. Example: use discord search "keyword" -c general --yaml instead of scanning all channels.
Non-TTY stdout defaults to YAML automatically. Use OUTPUT=yaml|json|rich|auto to override.
All machine-readable output uses the envelope documented in SCHEMA.md.

Prerequisites

Python 3.10+

bash

# Install
uv tool install kabi-discord-cli
# Or: pipx install kabi-discord-cli

# Upgrade to latest (recommended to avoid API errors)
uv tool upgrade kabi-discord-cli
# Or: pipx upgrade kabi-discord-cli

Token configured via discord auth --save

Commands

Auth & Account

bash

discord auth --save          # Auto-extract & save token
discord status               # Check token validity (exit 0 = valid)
discord status --yaml        # Structured auth status
discord whoami               # User profile
discord whoami --yaml        # Structured profile

Servers & Channels

bash

discord dc guilds            # List servers
discord dc guilds --yaml     # YAML output
discord dc channels <GUILD>  # List text channels
discord dc info <GUILD>      # Server details
discord dc members <GUILD>   # List members

Fetching Messages

bash

discord dc history <CHANNEL_ID> -n 1000   # Fetch history
discord dc sync <CHANNEL_ID>              # Incremental sync
discord dc sync-all                       # Sync all known channels
discord dc tail <CHANNEL_ID> -n 20        # Follow new messages live
discord dc search <GUILD> "keyword"       # Native Discord search

Querying Stored Messages

bash

discord search "keyword"                  # Search local DB
discord search "keyword" -c general       # Filter by channel
discord stats                             # Per-channel stats
discord today                             # Today's messages
discord today -c general --yaml           # Filter + YAML
discord top                               # Most active senders
discord top --hours 24                    # Last 24h only
discord timeline                          # Activity chart
discord timeline --by hour               # Hourly granularity

Data

bash

discord export <CHANNEL> -f json -o out.json   # Export
discord purge <CHANNEL> -y                     # Delete stored

Workflow: Before Using

bash

# Always run this first to ensure token is valid
discord auth --save          # Auto-extract token from browser (if needed)
discord status               # Verify token works

Workflow: Daily Sync

bash

# 1. First time: fetch history for channels you care about
discord dc guilds --yaml
discord dc channels <guild_id> --yaml
discord dc history <channel_id> -n 2000

# 2. Daily: incremental sync
discord dc sync-all

# 3. Read today's messages (structured output for agents)
discord today --yaml

Notes

Uses Discord user token (not bot token) for read-only access
Rate limits are handled automatically with retry
Messages stored in SQLite at ~/Library/Application Support/discord-cli/messages.db

Safety Notes

Do not ask users to share raw token values in chat logs.
Prefer auto-extraction via discord auth --save over manual token input.
Token is stored locally and never uploaded.

Files

SKILL.md and 33 other files in the repository root of jackwener/discord-cli.

SKILL.md
.env.example
.github/ISSUE_TEMPLATE/bug_report.yml
.github/ISSUE_TEMPLATE/feature_request.yml
.github/workflows/ci.yml
.github/workflows/publish.yml
.gitignore
CHANGELOG.md
CONTRIBUTING.md
LICENSE
README.md
README_CN.md
SCHEMA.md
pyproject.toml
src/discord_cli/__init__.py
src/discord_cli/auth.py
… and 18 more

Open the folder on GitHubat commit ce32e6b

Compare with similar skills

Discord CLI 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 CLI compared with similar skills
Skill	Stars	Used in	Tokens	Auto-check	Licence	Repo updated
Discord CLI this skilljackwener/discord-cli	133	—	~972	Automated safety check: Pass	Apache-2.0	6 mo ago
Planning With Filesjarrodwatts/claude-code-config	1.1k	5 repos	~967	Automated safety check: Pass	None	8 mo ago
Tool Use Data Synthesissunny-glow/Auto-BenchMax	1.3k	—	~3.3k	Automated safety check: Pass	None	2 mo ago
Agent Harness ConstructionKartikLabhshetwar/mind-mentor	147	7 repos	~500	Automated safety check: Pass	Apache-2.0	4 mo ago
Prompt Engineering Patternswshobson/agents	40k	—	~1.3k	Automated safety check: Pass	MIT	2 days ago
Model Benchmarkstheopenco/llmgateway	1.7k	—	~1.1k	Automated safety check: Notes	Custom licence	today

Similar skills

Planning With Files
jarrodwatts/claude-code-config
Transforms workflow to use Manus-style persistent markdown files for planning, progress tracking, and knowledge storage.
1.1k GitHub starsUsed in 5 repos~967 tokens
AI & LLM EngineeringAuto-check passed
Tool Use Data Synthesis
sunny-glow/Auto-BenchMax
Synthesize training data for ANY tool-use / agentic benchmark, in ANY repo.
1.3k GitHub stars~3.3k tokensUpdated 2 mo ago
AI & LLM EngineeringAuto-check passed
Agent Harness Construction
KartikLabhshetwar/mind-mentor
Design and optimize AI agent action spaces, tool definitions, and observation formatting for higher completion rates.
147 GitHub starsUsed in 7 repos~500 tokens
AI & LLM EngineeringAuto-check passed
Prompt Engineering Patterns
wshobson/agents
Reference for designing and tuning production LLM prompts: few-shot examples, chain-of-thought, structured outputs, templates and system prompts.
40k GitHub stars~1.3k tokensUpdated 2 days ago
AI & LLM EngineeringAuto-check passed
Model Benchmarks
theopenco/llmgateway
Run and report repository model or provider-mapping benchmarks.
1.7k GitHub stars~1.1k tokensUpdated today
AI & LLM EngineeringAuto-check: notes
Agent Prompt Quality Bar
mastra-ai/mastra
Universal quality bar and final audit rubric for any agent system prompt.
29k GitHub stars~2k tokensUpdated today
AI & LLM EngineeringAuto-check passed

Works with

Discord

Questions about Discord CLI

What does Discord CLI do?

Discord CLI with YAML-first structured output for AI agents — fetch chat history, search messages, sync channels, and AI analysis. Discord CLI is an agent skill from jackwener/discord-cli.

When should I use Discord CLI?

Discord CLI fits situations like: tasks that involve Structured output and tool calling.

How do I install Discord CLI in Claude Code?

Run `npx skills add jackwener/discord-cli --skill discord-cli -a claude-code`. Or copy the skill folder (the jackwener/discord-cli repository) into .claude/skills/discord-cli in your project. Claude Code loads it when a task matches its description.

How do I install Discord CLI in Codex?

Run `npx skills add jackwener/discord-cli --skill discord-cli -a codex`. Or copy the skill folder (the jackwener/discord-cli repository) into .agents/skills/discord-cli in your project. Codex loads it when a task matches its description.

Can I use Discord CLI 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 jackwener/discord-cli --skill discord-cli -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-cli, .gemini/skills/discord-cli, .github/skills/discord-cli and .opencode/skills/discord-cli in your project.

What does Discord CLI need to run?

Going by SKILL.md and its folder, Discord CLI needs Python for the scripts in its folder and the command-line tools its instructions call (uv). Our summary lists: Python 3.

Does Discord CLI access the network?

SKILL.md contains no URLs. Its commands use uv, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Discord CLI 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 CLI use?

Discord CLI is published under the Apache-2.0 licence (from the LICENSE file in the skill folder). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Discord CLI use?

About 972 tokens (SKILL.md is roughly 3.9k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Discord CLI?

Skills that share tags, products or a category with Discord CLI: Planning With Files (jarrodwatts/claude-code-config, 1.1k stars), Tool Use Data Synthesis (sunny-glow/Auto-BenchMax, 1.3k stars), Agent Harness Construction (KartikLabhshetwar/mind-mentor, 147 stars) and Prompt Engineering Patterns (wshobson/agents, 40k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Discord CLI?

jackwener (a GitHub user) maintains it in jackwener/discord-cli, which has 133 GitHub stars. The repository was last updated on March 14, 2026.

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

Install Discord CLI

Facts

At a glance

What it does

When your agent uses it

Example prompts

Requirements

Workflow steps

What it can do on your machine

Tool permissions

Runs code

Network

Credentials

Context cost

Safety

SKILL.md

discord-cli Skill

Agent Defaults

Prerequisites

Commands

Auth & Account

Servers & Channels

Fetching Messages

Querying Stored Messages

Data

Workflow: Before Using

Workflow: Daily Sync

Notes

Safety Notes

Files

Compare with similar skills

Similar skills

Planning With Files

Tool Use Data Synthesis

Agent Harness Construction

Prompt Engineering Patterns

Model Benchmarks

Agent Prompt Quality Bar

Related

Questions about Discord CLI