Skip to content
Skills Library
Marketing & content · Research

reddit-explore

/reddit-explore

Use when the user asks to search Reddit, browse subreddits, inspect posts, track discussions, or view Reddit user profiles. Read-only discovery and research.

Repository
cuecards ↗
Licence
MIT
Last repository change
25.10.2026

Assessment and security

100/ 100Class: good
Format25 / 25
Frontmatter with name and description, valid name, description up to 1,024 characters, name matching the folder.
Discoverability25 / 25
Description explains when to use the skill, has a reasonable length and uses third person.
Content35 / 35
At least 150 words and at most 500 lines, headings, step lists, examples or code.
Hygiene15 / 15
No placeholders such as TODO, no Windows paths, with a licence.
Riskno signals detected in the scan
Files in this package
2
Scripts
0
HTML comments
0
URLs in SKILL.md
2
Deprecation

No signals detected. Repository changed on 25.10.2026, without references to retired models or APIs.

Licence

MIT, open: use and modify while retaining author attribution.

What it does and when to use it

Use when the user asks to search Reddit, browse subreddits, inspect posts, track discussions, or view Reddit user profiles. Read-only discovery and research.

Original author description

Use when the user asks to search Reddit, browse subreddits, inspect posts, track discussions, or view Reddit user profiles. Read-only discovery and research.

How it works

  1. 🔒 Skill Boundary (Enforced)
  2. Intent Routing
  3. Constraints
  4. Example workflows
  5. Result Presentation
  6. Failure Handling
Original SKILL.md headings · 111 lines, 461 words
SKILL.md preview
---
name: reddit-explore
description: Use when the user asks to search Reddit, browse subreddits, inspect posts, track discussions, or view Reddit user profiles. Read-only discovery and research.
tags: [reddit, search, research]
capability: Perform read-only Reddit discovery across posts, subreddits, discussions, and profiles.
triggers:
  - search Reddit
  - browse subreddits
  - research Reddit posts
version: 1.0.0
metadata:
  openclaw:
    requires:
      bins:
        - python3
    emoji: "\U0001F50D"
    os:
      - darwin
      - linux
---

# Reddit Content Discovery

You are the "Reddit Discovery Assistant". Help users search, browse, and analyze Reddit content.

## 🔒 Skill Boundary (Enforced)

**All operations must go through `python scripts/cli.py` only:**

- **Only execution method**: Run `python scripts/cli.py <subcommand>`.
- **Ignore other projects**: Disregard PRAW, Reddit API, MCP tools, or other Reddit automation.
- **No external tools**: Do not call any non-project implementation.
- **Stop when done**: Report results, wait for user's next instruction.

**Allowed CLI subcommands:**

| Subcommand | Purpose |
|------------|---------|
| `home-feed` | Get home feed posts |
| `subreddit-feed` | Get posts from a subreddit |
| `search` | Search Reddit posts |
| `get-post-detail` | Get post content and comments |
| `user-profile` | Get user profile info |

---

## Intent Routing

1. User asks "search / find posts / search Reddit" → Search.
2. User asks "view post / read this post / post details" → Get post detail.
3. User asks "browse subreddit / what's on r/..." → Subreddit feed.
4. User asks "home feed / what's trending" → Home feed.
5. User asks "check user / view profile" → User profile.

## Constraints

- **Control query frequency**: Avoid rapid successive searches. Keep intervals between operations.
- All operations require a logged-in Chrome browser.
- Results should be presented in structured format with key fields highlighted.
- CLI output is JSON.

## Example workflows

### Home Feed

```bash
python scripts/cli.py home-feed
```

### Subreddit Feed

```bash
# Hot posts (default)
python scripts/cli.py subreddit-feed --subreddit python

# Sort by new
python scripts/cli.py subreddit-feed --subreddit python --sort new

# Top posts
python scripts/cli.py subreddit-feed --subreddit python --sort top
```

Sort options: `hot`, `new`, `top`, `rising`

### Search Posts

```bash
# Basic search
python scripts/cli.py search --query "machine learning tutorial"

# With sorting and time filter
python scripts/cli.py search --query "best Python IDE" --sort top --time year
```

| Parameter | Options |
|-----------|---------|
| `--sort` | relevance, hot, top, new, comments |
| `--time` | hour, day, week, month, year, all |

### Get Post Detail

```bash
python scripts/cli.py get-post-detail \
  --post-url "https://www.reddit.com/r/Python/comments/abc123/title/"

# Load all comments (scroll to load more)
python scripts/cli.py get-post-detail \
  --post-url "https://www.reddit.com/r/Python/comments/abc123/title/" \
  --load-all-comments
```

### User Profile

```bash
python scripts/cli.py user-profile --username spez
```

## Result Presentation

1. **Post lists**: Show title, subreddit, author, score, comment count.
2. **Post detail**: Full text content plus top comments.
3. **User profile**: Username, karma, description, recent posts.
4. **Data tables**: Use markdown tables for key metrics.

## Failure Handling

- **Not logged in**: Prompt user to log in (see reddit-auth).
- **No results**: Suggest different keywords or broader search.
- **Post not accessible**: May be deleted, removed, or in a private subreddit.
- **User not found**: Account may be deleted or suspended.
Files in this package (2)
  • SKILL.md 4 KB
  • skills-reddit-v1.9.zip 456 KB

Versions

The database has no other skills named reddit-explore.

Database snapshot: 13.11.2026 · package version 41fee8845610 (SHA-256 digest of the entire package)

Downloads in the last 30 days: 0 · ranking

Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.

Similar skills

  • 100reddit-research
    Search discussions, track communities, analyze posts, and discover trends on Reddit through SandBase. Use when asked for Reddit research, community analysis, trending topics, discussion monitoring, content discovery, or audience insight beyond customer-focused research.
  • 100reddit-readonly
    Browse and search Reddit in read-only mode using public JSON endpoints. Use when the user asks to browse subreddits, search for posts by topic, inspect comment threads, or build a shortlist of links to review and reply to manually.
  • 90reddit-context
    When the user wants to set up or update the shared Reddit marketing context every other skill in this repo reads first: the product, the buyer, the questions buyers ask AI assistants, competitors, target subreddits, and the disclosure line. Also use when the user mentions 'set…
  • 100reddit
    Browse, search, post, and moderate Reddit. Read-only works without auth; posting/moderation requires OAuth setup. Use when user mentions Reddit, wants to search subreddits, read threads, or post on Reddit. Triggers on 'reddit', 'subreddit', 'реддит'.
  • 100reddit-research
    Search and analyze Reddit discussions for market research, product feedback, and community insights using Xpoz. Use when asked to "search Reddit", "what does Reddit think about X", "Reddit feedback on X", "subreddit analysis", or "Reddit market research".
  • 100reddit
    Reddit integration for browsing subreddits, searching content, analyzing user profiles, and fetching post details with comment threads. Supports anonymous, app-only, and authenticated modes with tiered rate limits. Use when browsing Reddit, searching posts, or analysing user/subreddit activity.

Feedback and reports

Your message goes to Bartosz Sokoliński. An email address is needed only for a reply. See the privacy policy.