Agent skill

Reddit Skill

by artwist-polyakov in artwist-polyakov/polyakov-claude-skills

Reddit: чтение постов и комментариев без ключей через веб-инструмент агента, RSS и публичный JSON; API для пользователей, сабреддитов и поиска.

MITAuto-check: notesBackend & APIs

Install Reddit Skill

skills CLI

$ npx skills add artwist-polyakov/polyakov-claude-skills --skill reddit-skill -a claude-code

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

GitHub CLI

$ gh skill install artwist-polyakov/polyakov-claude-skills reddit-skill --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/artwist-polyakov/polyakov-claude-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/plugins/reddit-skill/skills/reddit-skill .claude/skills/reddit-skill && 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/

Paste into Claude Code

Install the "reddit-skill" agent skill from https://github.com/artwist-polyakov/polyakov-claude-skills/tree/main/plugins/reddit-skill/skills/reddit-skill into .claude/skills/reddit-skill/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "reddit-skill", 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.

$skill-installer

$skill-installer install https://github.com/artwist-polyakov/polyakov-claude-skills/tree/main/plugins/reddit-skill/skills/reddit-skill

Type this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.

skills CLI

$ npx skills add artwist-polyakov/polyakov-claude-skills --skill reddit-skill -a codex

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

GitHub CLI

$ gh skill install artwist-polyakov/polyakov-claude-skills reddit-skill --agent codex

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

Manual copy

$ git clone --depth 1 https://github.com/artwist-polyakov/polyakov-claude-skills.git skills-src && mkdir -p .agents/skills && cp -r skills-src/plugins/reddit-skill/skills/reddit-skill .agents/skills/reddit-skill && rm -rf skills-src

Use ~/.agents/skills/ instead of .agents/skills for a personal install.

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

Paste into Codex

Install the "reddit-skill" agent skill from https://github.com/artwist-polyakov/polyakov-claude-skills/tree/main/plugins/reddit-skill/skills/reddit-skill into .agents/skills/reddit-skill/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "reddit-skill", 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 artwist-polyakov/polyakov-claude-skills --skill reddit-skill -a cursor

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

GitHub CLI

$ gh skill install artwist-polyakov/polyakov-claude-skills reddit-skill --agent cursor

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

Manual copy

$ git clone --depth 1 https://github.com/artwist-polyakov/polyakov-claude-skills.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/plugins/reddit-skill/skills/reddit-skill .cursor/skills/reddit-skill && rm -rf skills-src

Use ~/.cursor/skills/ instead of .cursor/skills for a personal install.

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

Paste into Cursor

Install the "reddit-skill" agent skill from https://github.com/artwist-polyakov/polyakov-claude-skills/tree/main/plugins/reddit-skill/skills/reddit-skill into .cursor/skills/reddit-skill/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "reddit-skill", 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.

gemini skills install

$ gemini skills install https://github.com/artwist-polyakov/polyakov-claude-skills.git --path plugins/reddit-skill/skills/reddit-skill

--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.

skills CLI

$ npx skills add artwist-polyakov/polyakov-claude-skills --skill reddit-skill -a gemini-cli

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

GitHub CLI

$ gh skill install artwist-polyakov/polyakov-claude-skills reddit-skill --agent gemini-cli

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

Manual copy

$ git clone --depth 1 https://github.com/artwist-polyakov/polyakov-claude-skills.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/plugins/reddit-skill/skills/reddit-skill .gemini/skills/reddit-skill && rm -rf skills-src

Use ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.

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

Paste into Gemini CLI

Install the "reddit-skill" agent skill from https://github.com/artwist-polyakov/polyakov-claude-skills/tree/main/plugins/reddit-skill/skills/reddit-skill into .gemini/skills/reddit-skill/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "reddit-skill", 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 artwist-polyakov/polyakov-claude-skills reddit-skill

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 artwist-polyakov/polyakov-claude-skills --skill reddit-skill -a github-copilot

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

Manual copy

$ git clone --depth 1 https://github.com/artwist-polyakov/polyakov-claude-skills.git skills-src && mkdir -p .github/skills && cp -r skills-src/plugins/reddit-skill/skills/reddit-skill .github/skills/reddit-skill && rm -rf skills-src

Use ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.

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

Paste into GitHub Copilot

Install the "reddit-skill" agent skill from https://github.com/artwist-polyakov/polyakov-claude-skills/tree/main/plugins/reddit-skill/skills/reddit-skill into .github/skills/reddit-skill/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "reddit-skill", 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 artwist-polyakov/polyakov-claude-skills --skill reddit-skill -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 artwist-polyakov/polyakov-claude-skills reddit-skill --agent opencode

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

Manual copy

$ git clone --depth 1 https://github.com/artwist-polyakov/polyakov-claude-skills.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/plugins/reddit-skill/skills/reddit-skill .opencode/skills/reddit-skill && rm -rf skills-src

Use ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.

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

Paste into OpenCode

Install the "reddit-skill" agent skill from https://github.com/artwist-polyakov/polyakov-claude-skills/tree/main/plugins/reddit-skill/skills/reddit-skill into .opencode/skills/reddit-skill/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "reddit-skill", 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: reddit-skill
GitHub stars: 206
Token cost: ~3.1k tokens
SKILL.md length: 1,142 words
Files: 33 (incl. scripts)
Skills in repo: 21
Repo updated: Oct 8, 2026
First seen: Oct 7, 2026
Licence: MIT

At a glance

Works in 5 steps: Cache-first — токен, юзеры, сабреддиты,… → Context window hygiene — stdout ≤ 30… → Выбор режима — REDDIT_RSS_MODE=1… → …
Tasks that involve OAuth and OpenID Connect
SKILL.md covers Выбор способа чтения, Настройка скриптов, Поведение скриптов and Использование скриптов, plus 7 more sections
Runs Shell and Python scripts from its folder; calls sh and rg; reaches reddit.com; needs REDDIT_PASSWORD and REDDIT_CLIENT_SECRET

What it does

Reddit Skill is an agent skill from artwist-polyakov/polyakov-claude-skills. Reddit: чтение постов и комментариев без ключей через веб-инструмент агента, RSS и публичный JSON; API для пользователей, сабреддитов и поиска. OAuth2, кеш, автоматический переход на RSS при отказе авторизации, опциональные write-операции с двойным предохранителем (REDDITENABLEWRITE=1 + --confirm). Triggers: reddit, reddit api, reddit subreddit, reddit user, reddit post, reddit search, парсинг reddit, посты reddit, комментарии reddit, реддит.

Its SKILL.md is about 3.1k tokens, which your agent loads only when the skill is triggered. The skill folder holds 35 other files, including scripts (for example `config/README.md`, `scripts/auth_check.sh` and `scripts/comment_reply.sh`).

It sits in Backend & APIs, covering OAuth and OpenID Connect. It works with Reddit. The repository describes itself as: Набор скиллов для Claude. The licence is MIT.

When your agent uses it

Tasks that involve OAuth and OpenID Connect

Example prompts

“/reddit-skill”

Requirements

Python 3
A Bash shell
A credential in REDDIT_CLIENT_SECRET

Workflow steps

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

Cache-first — токен, юзеры, сабреддиты, листинги кешируются по детерминированному ключу.
Context window hygiene — stdout ≤ 30 строк, полный JSON в cache/listings/.json.
Выбор режима — REDDIT_RSS_MODE=1 включает RSS. Без ключей поддерживаемые команды чтения также используют RSS. С ключами выбирается user…
Двойная защита write — два уровня
Rate-limit от заголовков — читаем x-ratelimit-remaining, x-ratelimit-reset, Retry-After. На 429 один retry если ожидание ≤ 60s.

What it can do on your machine

Read from SKILL.md and the folder at commit 8bbeead. 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 12 files in scripts/ (Shell and Python, from the files we listed), which the agent can run.
Shell commands in SKILL.md call:
- sh
- rg
From the folder's file list and the shell code blocks in SKILL.md.
Network
Hosts in commands or code, which the agent is likely to contact:
- reddit.com
Also links to:
- github.com
From URLs in SKILL.md, links to its own repository left out.
Credentials
Names these keys or tokens, usually read from environment variables:
- REDDIT_PASSWORD
- REDDIT_CLIENT_SECRET
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Reddit Skill loads about 3.1k tokens when it runs. Until then it costs about 115 tokens; SKILL.md has 1,142 words of instructions outside code blocks.

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

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: notes

The automated check noted patterns worth knowing about, such as sudo or a known installer.

NoteMentions a .env fileSKILL.md:25

сохранённым списком. Не ищи подписки в `.env` или аккаунте и не подключай

NoteMentions a .env fileSKILL.md:40

Список подписок хранится отдельно от `.env`; наличие или исправность ключей

NoteMentions a .env fileSKILL.md:62

IT_RSS_MODE=1` можно сохранить в `config/.env`. При передаче через окружение

NoteMentions a .env fileSKILL.md:63

скрипт не читает `.env`. Для списка из `config/subscriptions.txt` передавай каждый

NoteMentions a .env fileSKILL.md:69

eddit.com/prefs/apps и заполнить `config/.env`:

NoteMentions a .env fileSKILL.md:85

- Без `REDDIT_ENABLE_WRITE=1` в `.env` write-скрипты **отказывают сразу** с понятной ошибкой (никакого dry-run — это

NoteMentions a .env fileSKILL.md:102

- Убедись, что в `.env` есть `REDDIT_USERNAME`+`REDDIT_PASSWORD`+`REDDIT_ENABLE_WRITE=1`

NoteMentions a .env fileSKILL.md:169

-confirm` *и* `REDDIT_ENABLE_WRITE=1` в `.env`.

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); the scripts in this folder are not scanned.

SKILL.md

The full file from artwist-polyakov/polyakov-claude-skills at commit 8bbeead, republished under its MIT licence (© artwist-polyakov). 1,142 words, ~3,139 tokens.

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

name: reddit-skill
description: Reddit: чтение постов и комментариев без ключей через веб-инструмент агента, RSS и публичный JSON; API для пользователей, сабреддитов и поиска. OAuth2, кеш, автоматический переход на RSS при отказе авторизации, опциональные write-операции с двойным предохранителем (REDDIT_ENABLE_WRITE=1 + --confirm). Triggers: reddit, reddit api, reddit subreddit, reddit user, reddit post, reddit search, парсинг reddit, посты reddit, комментарии reddit, реддит.

reddit-skill

Чтение публичных списков через RSS, постов и комментариев через .json без ключей, а также прямой доступ к Reddit API через OAuth2 без PRAW. Порт MCP-сервера Arindam200/reddit-mcp на shell-скрипты по образцу yandex-metrika / yandex-search-api.

Выбор способа чтения

Для публичного чтения по пользовательским подпискам, в том числе RSS-мониторинга, бери список из config/subscriptions.txt: одно название сабреддита на строку, без r/. Сабреддиты, явно заданные в запросе, имеют приоритет над сохранённым списком. Не ищи подписки в .env или аккаунте и не подключай браузерную сессию для получения этого списка. Если файл отсутствует или пуст, уточни сабреддиты у пользователя.

Если пользователь не указал способ, для публичного чтения сначала используй доступный встроенный инструмент чтения URL (fetch, WebFetch, open или аналог). Открывай конкретный адрес; результаты поиска сами по себе не заменяют содержимое:

Пост и комментарии: используй адрес с .json; для обычной ссылки добавь .json к пути поста перед параметрами запроса, например https://www.reddit.com/r/Python/comments/abc123/title/.json?limit=100&raw_json=1.
Список постов: если инструмент поддерживает XML/Atom, открой RSS-ленту, например https://www.reddit.com/r/Python/top.rss?t=day&limit=25.

Для этого способа не запускай auth_check.sh и не запрашивай ключи приложения. Список подписок хранится отдельно от .env; наличие или исправность ключей не является условием публичного чтения. При повторном мониторинге запрашивай свежие данные, если инструмент это позволяет; иначе укажи ограничение свежести.

Если инструмента нет, он не поддерживает формат, не вернул нужное содержимое или задача требует скрипта и локального кеша, используй команды ниже. Для чтения без ключей передавай REDDIT_RSS_MODE=1. Ошибка одного способа не доказывает недоступность другого.

Веб-инструмент может возвращать сокращённый текст вместо исходного JSON или RSS. Не выдавай такой ответ за полный файл и не обещай все комментарии: учитывай усечение, параметр limit и элементы more. Локальный кеш описан ниже только для скриптов; при чтении веб-инструментом не сообщай о сохранении файла, если он не был сохранён.

Настройка скриптов

Для мониторинга постов ключи приложения не нужны. Включить RSS явно:

bash

REDDIT_RSS_MODE=1 sh scripts/subreddit_top.sh --subreddit singularity --time day --limit 25

REDDIT_RSS_MODE=1 можно сохранить в config/.env. При передаче через окружение скрипт не читает .env. Для списка из config/subscriptions.txt передавай каждый сабреддит явно через --subreddit: скрипты сами список подписок не загружают. Для RSS есть стандартный User-Agent; его можно заменить через REDDIT_USER_AGENT.

Для полного доступа через API зарегистрировать script-app на https://www.reddit.com/prefs/apps и заполнить config/.env:

REDDIT_CLIENT_ID, REDDIT_CLIENT_SECRET
REDDIT_USER_AGENT (обязателен по правилам Reddit)

Подробная инструкция: config/README.md.

Для write/me дополнительно:

REDDIT_USERNAME, REDDIT_PASSWORD — владелец script-app (без 2FA)
REDDIT_ENABLE_WRITE=1 + --confirm на каждой write-команде

Поведение скриптов

Cache-first — токен, юзеры, сабреддиты, листинги кешируются по детерминированному ключу.
Context window hygiene — stdout ≤ 30 строк, полный JSON в cache/listings/<hash>.json.
Выбор режима — REDDIT_RSS_MODE=1 включает RSS. Без ключей поддерживаемые команды чтения также используют RSS. С ключами выбирается user mode при наличии REDDIT_USERNAME+REDDIT_PASSWORD, иначе app-only. При отказе авторизации чтение постов автоматически переходит на RSS в текущем запуске; настройки на диске не меняются.
Двойная защита write — два уровня:
- Без REDDIT_ENABLE_WRITE=1 в .env write-скрипты отказывают сразу с понятной ошибкой (никакого dry-run — это «ворота» уровня окружения).
- С REDDIT_ENABLE_WRITE=1, но без --confirm — dry-run: печатают что бы сделали, но не отправляют запрос.
- Только при REDDIT_ENABLE_WRITE=1 и --confirm команда реально идёт на Reddit.
Rate-limit от заголовков — читаем x-ratelimit-remaining, x-ratelimit-reset, Retry-After. На 429 один retry если ожидание ≤ 60s.

Использование скриптов

Проверка доступа

Если выбран скрипт, запускай нужную команду чтения сразу. Если нужно проверить доступ отдельно:
bash
```
sh scripts/auth_check.sh
```
Успех: OK: RSS feed works, OK: app-only token works или OK: user token works. Для RSS не запрашивай файл с ключами и не требуй регистрации приложения.
Если нужна write-операция:
- Убедись, что в .env есть REDDIT_USERNAME+REDDIT_PASSWORD+REDDIT_ENABLE_WRITE=1 (без REDDIT_ENABLE_WRITE=1 команда сразу падает с ошибкой — это намеренно)
- Сначала запусти команду без --confirm — увидишь dry-run
- Только после ревью пользователя — добавляй --confirm
Имя сабреддита/юзера можно передавать с префиксом или без: r/python ≡ python, u/spez ≡ spez.

Show full SKILL.md (565 more words)Show less

Возможности RSS

RSS поддерживают subreddit_top.sh, search.sh, user_posts.sh и auth_check.sh. Параметры поиска, сортировки, периода и количества передаются в публичную ленту. submission.sh в этом же режиме читает https://www.reddit.com/comments/{id}.json без токена. Можно передать обычную ссылку поста, ссылку с .json или ID. --include-comments у топа загружает посты и комментарии через тот же публичный JSON. Остальные команды требуют API.

Сохраняются доступные в ленте заголовок, ссылка, дата, автор, сабреддит и текст. JSON имеет привычную структуру Listing и признак source: "rss". score и num_comments равны null, в кратком выводе — ?: RSS этих чисел не даёт. Не оценивай по ним популярность поста. Текст ограничен содержимым самой ленты.

Публичный .json сохраняется как массив [Listing поста, Listing комментариев], каждый с source: "public-json"; оценки и другие поля берутся из ответа Reddit. Полный полученный текст и вложенные ответы доступны в кеше, на экран выводится краткая сводка. Не обещай все комментарии: ответ ограничен --limit-comments / --comments-per-post и может содержать more. Скилл не разворачивает more дополнительными запросами; submission.sh сообщает, если нашёл его в дереве.

Автоматический переход срабатывает при отказе выдачи токена (HTTP 400/401/403 или OAuth-ошибка авторизации), API 403 либо повторном API 401 после обновления токена. Сетевые ошибки, 429 и 5xx не означают нерабочий ключ и не включают RSS. Если RSS или публичный JSON также недоступен, команда возвращает явную ошибку. При ошибке загрузки комментариев уже полученный список постов остаётся в кеше.

Scripts

Auth & identity

Script	Endpoint	Mode	Description
`auth_check.sh`	`GET /r/all/new?limit=1` или `.rss`	any	Проверка API или RSS
`me.sh`	`GET /api/v1/me`	user only	Личный профиль (карма, имя)

Read

Script	Endpoint	Description
`user_info.sh --username U`	`/user/{u}/about`	Профиль юзера
`user_posts.sh --username U`	`/user/{u}/submitted`	Посты юзера
`user_comments.sh --username U`	`/user/{u}/comments`	Комментарии юзера
`subreddit_info.sh --subreddit S`	`/r/{s}/about`	Метаданные сабреддита
`subreddit_stats.sh --subreddit S`	`/r/{s}/about` + `/about/rules` + `/about/moderators`	Расширенные метрики + правила + модераторы
`subreddit_popular.sh`	`/subreddits/popular`	Популярные сабреддиты (Reddit «trending»)
`subreddit_top.sh --subreddit S`	`/r/{s}/top` (+ `/comments/{id}` per-post при `--include-comments`)	Топ-посты сабреддита; опционально с комментариями к каждому
`search.sh --query "..."`	`/search` или `/r/{s}/search`	Поиск по Reddit (опц. `--subreddit`)
`submission.sh --id I` или `--url U`	`/comments/{id}` или `/comments/{id}.json`	Пост + комментарии; работает без ключей

Общие read-флаги: --limit N, --no-cache, --time T (где применимо), --sort S (где применимо).

Write (опасные — двойной предохранитель)

Script	Endpoint	Description
`post_create.sh --subreddit S --title T (--content C \| --url U)`	`POST /api/submit`	Опубликовать пост
`comment_reply.sh --parent-id ID --content C`	`POST /api/comment`	Ответить на пост (`t3_`) или комментарий (`t1_`)
`subreddit_subscribe.sh --subreddit S [--unsubscribe]`	`POST /api/subscribe`	Подписка / отписка

Все write-команды требуют --confirm и REDDIT_ENABLE_WRITE=1 в .env. Поведение:

REDDIT_ENABLE_WRITE не установлен → отказ с ошибкой (envelope-уровень).
REDDIT_ENABLE_WRITE=1, но без --confirm → dry-run (печать, без сети).
Оба условия выполнены → реальный POST.

Кеш скриптов

cache/
├── token.json                  # OAuth access token + expires_at
├── users/<username>.json       # /user/{u}/about
├── subreddits/<sub>.json       # /r/{sub}/about
├── subreddits/<sub>.rules.json
├── subreddits/<sub>.moderators.json
├── listings/<hash>.json        # листинги (search, top, posts, comments, popular)
├── top_with_comments/<hash>/   # копии постов с комментариями в подпапках api/ и rss/
└── me.json                     # /api/v1/me

Ключи кеша публичного чтения отделены от API. При неудачном обновлении поста или списка прежний файл сохраняется. Для свежих публикаций при повторном мониторинге передавай --no-cache.

Поиск по кешу: grep -r "term" cache/ или rg "term" cache/.

Examples

bash

# 1) Profile of a user
sh scripts/user_info.sh --username spez

# 2) Top posts in r/Python this week
sh scripts/subreddit_top.sh --subreddit python --time week --limit 25

# 3) Search "machine learning" in r/learnprogramming, sorted by new
sh scripts/search.sh --query "machine learning" --subreddit learnprogramming \
    --sort new --time month --limit 20

# 4) Пост и комментарии через публичный JSON без ключей
REDDIT_RSS_MODE=1 sh scripts/submission.sh \
    --url "https://www.reddit.com/r/Python/comments/abc123/some_title/" \
    --limit-comments 50

# 5) DRY-RUN of a comment reply (requires REDDIT_ENABLE_WRITE=1; without --confirm only prints)
REDDIT_ENABLE_WRITE=1 sh scripts/comment_reply.sh \
    --parent-id t3_abc123 --content "Looks great!"

# 6) Real reply (after dry-run review)
REDDIT_ENABLE_WRITE=1 sh scripts/comment_reply.sh \
    --parent-id t3_abc123 --content "Looks great!" --confirm

# 7) Топ с комментариями (один дополнительный API или JSON запрос на пост)
sh scripts/subreddit_top.sh --subreddit Python --time week --limit 5 \
    --include-comments --comments-per-post 25

Rate limits

Reddit OAuth: ~60 req/min для app-only, ~600/10min для user-mode (зависит от истории аккаунта). Скилл читает Reddit-специфичные заголовки x-ratelimit-* и стандартный Retry-After. На 429 делает один retry если ожидание ≤ 60s, иначе fail с понятной ошибкой.

Tests

bash

sh scripts/tests/run.sh

No-network, проверяют:

парсинг submission URL → id
детерминированность cache_key
корректность авто-выбора режима auth
что write-команды без REDDIT_ENABLE_WRITE или без --confirm ничего не отправляют
разбор Atom, публичный JSON, чтение без ключей, переход с API и разделение кеша

Differences from upstream

Оригинальный reddit-mcp использует PRAW + Python и зашит как MCP-сервер. Здесь публичное чтение начинается с доступного веб-инструмента агента; shell-скрипты используют curl и кеш в директории скилла. Анализ постов и обсуждений выполняет агент по полученным данным.

Документация

Files

SKILL.md and 32 other files (scripts) in plugins/reddit-skill/skills/reddit-skill of artwist-polyakov/polyakov-claude-skills.

SKILL.md
.gitignore
cache/.gitkeep
config/.env.example
config/README.md
config/subscriptions.txt
scripts/auth_check.sh
scripts/comment_reply.sh
scripts/common.sh
scripts/me.sh
scripts/post_create.sh
scripts/rss_to_listing.py
scripts/search.sh
scripts/submission.sh
scripts/subreddit_info.sh
scripts/subreddit_popular.sh
scripts/subreddit_stats.sh
scripts/subreddit_subscribe.sh
… and 15 more

Open the folder on GitHubat commit 8bbeead

Compare with similar skills

Reddit Skill 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.

Reddit Skill compared with similar skills
Skill	Stars	Used in	Tokens	Auto-check	Licence	Repo updated
Reddit Skill this skillartwist-polyakov/polyakov-claude-skills	206	—	~3.1k	Automated safety check: Notes	MIT	yesterday
Redditsundial-org/awesome-openclaw-skills	663	1 repos	~715	Automated safety check: Pass	None	7 mo ago
Glim MCPaeonfun/aeon	767	—	~1.3k	Automated safety check: Warn	MIT	yesterday
Fortify Developmentcoollabsio/coolify	63k	4 repos	~1.9k	Automated safety check: Pass	MIT	today
OmniRoute Provider Managementdiegosouzapw/OmniRoute	74k	—	~2.4k	Automated safety check: Pass	MIT	today
Antipattern Preventiondoorkeeper-gem/doorkeeper	5.5k	—	~1.1k	Automated safety check: Pass	MIT	2 days ago

Similar skills

Reddit
sundial-org/awesome-openclaw-skills
Browse, search, post, and moderate Reddit. An agent skill from sundial-org/awesome-openclaw-skills.
663 GitHub starsUsed in 1 repo~715 tokens
Backend & APIsAuto-check passed
Glim MCP
aeonfun/aeon
Live-data research via the glim.sh MCP - web search, full page extraction, X/Twitter, Reddit, GitHub, Amazon, and YouTube transcripts - synthesized into a cited digest.
767 GitHub stars~1.3k tokensUpdated yesterday
Knowledge ManagementAuto-check: warnings
Fortify Development
coollabsio/coolify
ACTIVATE when the user works on authentication in Laravel. An agent skill from coollabsio/coolify.
63k GitHub starsUsed in 4 repos~1.9k tokens
Backend & APIsAuto-check passed
OmniRoute Provider Management
diegosouzapw/OmniRoute
Manages AI provider connections, API keys, OAuth flows and connection tests through OmniRoute's REST API across its 327-provider catalog.
74k GitHub stars~2.4k tokensUpdated today
Backend & APIsAuto-check passed
Antipattern Prevention
doorkeeper-gem/doorkeeper
Avoid common Ruby and Rails antipatterns that degrade maintainability and performance.
5.5k GitHub stars~1.1k tokensUpdated 2 days ago
Backend & APIsAuto-check passed
Cognito
itsmostafa/aws-agent-skills
AWS Cognito user authentication and authorization service. An agent skill from itsmostafa/aws-agent-skills.
1.2k GitHub starsUsed in 1 repo~2.3k tokens
Backend & APIsAuto-check passed

More from artwist-polyakov/polyakov-claude-skills

All 21 skills in this repo

Agent Deck Sessions
artwist-polyakov/polyakov-claude-skills
Launches, monitors and collects results from child AI agent sessions with the agent-deck terminal session manager.
206 GitHub stars~965 tokensUpdated yesterday
Auto-check passed
Crawl4AI SEO Site Crawler
artwist-polyakov/polyakov-claude-skills
Crawls a site with Crawl4AI to audit titles, meta tags, H1s, canonicals, navigation and internal links, and to compare landing pages and competitor sites.
206 GitHub stars~1.7k tokensUpdated yesterday
Auto-check passed
GitHub Pages Publisher
artwist-polyakov/polyakov-claude-skills
Publishes already-built static pages to a GitHub Pages repo under a year, year-month and slug folder layout, optimizes large images and returns the public URL.
206 GitHub stars~1.2k tokensUpdated yesterday
Auto-check passed
Perplexity Search and Research
artwist-polyakov/polyakov-claude-skills
Shell scripts for web search and research through the Perplexity API: raw results, cited answers, background deep research and page fetching, with results cached on disk.
206 GitHub stars~2.5k tokensUpdated yesterday
Auto-check: notes
Sourcecraft Publisher
artwist-polyakov/polyakov-claude-skills
Publish static page artifacts to SourceCraft Sites (Yandex infrastructure, works in Russia), with advisory image optimization and an original-image path.
206 GitHub stars~990 tokensUpdated yesterday
Auto-check: notes
X/Twitter Research via Grok
artwist-polyakov/polyakov-claude-skills
Searches X/Twitter through the xAI Grok API to build digests, trend reports and thread analysis, meant to surface post ideas for a Telegram channel.
206 GitHub stars~1.8k tokensUpdated yesterday
Auto-check: notes

Works with

Questions about Reddit Skill

What does Reddit Skill do?

Reddit: чтение постов и комментариев без ключей через веб-инструмент агента, RSS и публичный JSON; API для пользователей, сабреддитов и поиска. Reddit Skill is an agent skill from artwist-polyakov/polyakov-claude-skills. Reddit: чтение постов и комментариев без ключей через веб-инструмент агента, RSS и публичный JSON; API для пользователей, сабреддитов и поиска.

When should I use Reddit Skill?

Reddit Skill fits situations like: tasks that involve OAuth and OpenID Connect.

How do I install Reddit Skill in Claude Code?

Run `npx skills add artwist-polyakov/polyakov-claude-skills --skill reddit-skill -a claude-code`. Or copy the skill folder (plugins/reddit-skill/skills/reddit-skill in artwist-polyakov/polyakov-claude-skills) into .claude/skills/reddit-skill in your project. Claude Code loads it when a task matches its description.

How do I install Reddit Skill in Codex?

Run `npx skills add artwist-polyakov/polyakov-claude-skills --skill reddit-skill -a codex`. Or copy the skill folder (plugins/reddit-skill/skills/reddit-skill in artwist-polyakov/polyakov-claude-skills) into .agents/skills/reddit-skill in your project. Codex loads it when a task matches its description.

Can I use Reddit Skill 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 artwist-polyakov/polyakov-claude-skills --skill reddit-skill -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/reddit-skill, .gemini/skills/reddit-skill, .github/skills/reddit-skill and .opencode/skills/reddit-skill in your project.

What does Reddit Skill need to run?

Going by SKILL.md and its folder, Reddit Skill needs a shell and Python for the scripts in its folder, the command-line tools its instructions call (sh and rg) and credentials named REDDIT_PASSWORD and REDDIT_CLIENT_SECRET. Our summary lists: Python 3; A Bash shell; A credential in REDDIT_CLIENT_SECRET.

Does Reddit Skill access the network?

SKILL.md names 2 domains. In commands or code: reddit.com; the agent is likely to contact it when it follows the instructions. As links in the text: github.com. This is read from the text; nothing was executed.

Is Reddit Skill safe to install?

Our automated static check of SKILL.md found notes only (mentions a .env file), nothing it rates as a warning. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Reddit Skill use?

Reddit Skill 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 Reddit Skill use?

About 3.1k tokens (SKILL.md is roughly 13k 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 Reddit Skill?

Skills that share tags, products or a category with Reddit Skill: Reddit (sundial-org/awesome-openclaw-skills, 663 stars), Glim MCP (aeonfun/aeon, 767 stars), Fortify Development (coollabsio/coolify, 63k stars) and OmniRoute Provider Management (diegosouzapw/OmniRoute, 74k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Reddit Skill?

artwist-polyakov (a GitHub user) maintains it in artwist-polyakov/polyakov-claude-skills, which has 206 GitHub stars. The repository holds 21 skills in this directory. The repository was last updated on October 8, 2026.

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

Install Reddit Skill

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

reddit-skill

Выбор способа чтения

Настройка скриптов

Поведение скриптов

Использование скриптов

Проверка доступа

Возможности RSS

Scripts

Auth & identity

Read

Write (опасные — двойной предохранитель)

Кеш скриптов

Examples

Rate limits

Tests

Differences from upstream

Документация

Files

Compare with similar skills

Similar skills

More from artwist-polyakov/polyakov-claude-skills

Related

Questions about Reddit Skill