---
name: reddit
description: Search and retrieve content from Reddit. Get posts, comments, subreddit info, and user profiles via the public JSON API. Use when user mentions Reddit, a subreddit, or r/ links.
  Use when: The executive requests execution of this domain.
  Skip when: The task is outside the scope of this module.
---


> [!IMPORTANT]
> **GFV-Adapted Skill** — This skill runs within the GetFresh Ventures infrastructure. Follow these conventions.

### GFV Infrastructure Integration

**Credentials** — Never use `.env` files. All secrets live in macOS Keychain:
```bash
security find-generic-password -s "<service>" -a "<account>" -w
```
Check `~/Documents/Code/gfv-brain/scripts/pil_config.py` for service mappings.

**Data Sources** — Before querying external APIs, check PIL first:
- `search_pil` / `smart_search` / `vector_search` MCP tools (491K+ embeddings, 81K entities)
- Supabase tables: `entity_embeddings`, `ont_entities`, `ont_facts`
- Local SQLite: WhatsApp (59K msgs), Slack (2.5K msgs), `gfv_memory.db`

**Output** — Save results to `~/Documents/Code/gfv-brain/` or PIL via Supabase. Never send external messages (email, Slack, WhatsApp) without the Executive's explicit "send it" approval.

**Active Clients**:
- **GetFresh Ventures** — Venture studio: getfreshventures.com

---


# Reddit Skill

Get posts, comments, subreddit info, and user profiles from Reddit via the public JSON API.

## Prerequisites

**No API key required!** Reddit's public JSON API works without authentication.

**Quick Check**:
```bash
cd <skill_directory>
[STUB AVOIDED] Execute get_posts.py via available MCP/agent tools rather than a missing local script python --limit 3
```

## Commands

All commands run from the skill directory.

### Subreddit Posts
```bash
[STUB AVOIDED] Execute get_posts.py via available MCP/agent tools rather than a missing local script python --limit 20           # Hot posts (default)
[STUB AVOIDED] Execute get_posts.py via available MCP/agent tools rather than a missing local script python --sort new --limit 20
[STUB AVOIDED] Execute get_posts.py via available MCP/agent tools rather than a missing local script python --sort top --time week
[STUB AVOIDED] Execute get_posts.py via available MCP/agent tools rather than a missing local script python --sort top --time all --limit 10
```

### Search Posts
```bash
[STUB AVOIDED] Execute search_posts.py via available MCP/agent tools rather than a missing local script "AI agent" --limit 20
[STUB AVOIDED] Execute search_posts.py via available MCP/agent tools rather than a missing local script "MCP server" --subreddit ClaudeAI --limit 10
[STUB AVOIDED] Execute search_posts.py via available MCP/agent tools rather than a missing local script "async python" --sort top --time year
```

### Subreddit Info
```bash
[STUB AVOIDED] Execute get_subreddit.py via available MCP/agent tools rather than a missing local script python
[STUB AVOIDED] Execute get_subreddit.py via available MCP/agent tools rather than a missing local script ClaudeAI
```

### Post & Comments
```bash
[STUB AVOIDED] Execute get_post.py via available MCP/agent tools rather than a missing local script abc123                       # Get post by ID
[STUB AVOIDED] Execute get_post.py via available MCP/agent tools rather than a missing local script abc123 --comments 50         # With more comments
```

### User Profile
```bash
[STUB AVOIDED] Execute get_user.py via available MCP/agent tools rather than a missing local script spez
[STUB AVOIDED] Execute get_user.py via available MCP/agent tools rather than a missing local script spez --posts 10              # Include recent posts
```

## Sort Options

| Sort | Description | Time Options |
|------|-------------|--------------|
| `hot` | Trending posts (default) | - |
| `new` | Latest posts | - |
| `top` | Highest voted | hour, day, week, month, year, all |
| `rising` | Gaining traction | - |
| `controversial` | Mixed votes | hour, day, week, month, year, all |

## API Info
- **Method**: Public JSON API (no auth needed)
- **Trick**: Append `.json` to any Reddit URL
- **Rate Limit**: 100 requests/minute
- **Docs**: https://www.reddit.com/dev/api



## When to Trigger
- When requested by the Executive.
- When the task aligns with the core competency of this skill.

## When to Skip
- When the data or answers already exist in the PIL memory bus.
- When the task requires physical intervention or manual approval before drafting.

## GFV Integration
**Credentials** — Never use `.env` files. All secrets live in macOS Keychain:
`security find-generic-password -s "<service>" -a "<account>" -w`
**Data Sources** — Before querying external APIs, check PIL first (`search_pil`, `gfv_memory.db`).
**Output** — Save results to `~/Documents/Code/gfv-brain/`. Never send external messages without the Executive`s explicit "send it" approval.

## Anti-Patterns
- **Summarizing instead of resolving**: Do not just summarize what needs to be done. Do the work.
- **Bypassing the Gate**: Do not execute risky actions without human-in-the-loop validation.

## References
- **GFV Standard**: GetFresh Ventures Growth by Design CEO AI Kit Architecture

<verification_gate>
# Delivery Gate

STOP AND VERIFY BEFORE DECLARING THIS TASK COMPLETE.

1. Did you verify that the execution meets all documented requirements safely?
2. Ensure you have not bypassed any "requires_human_approval" constraints.
</verification_gate>

<!-- Original Community Author: opc -->

---

<gxd_footer>

> **Growth by Design™** — This skill is part of the [CEO AI Kit](https://github.com/GetFresh-Ventures/gxd-ceo-ai-kit), the open-source foundation of the Growth by Design™ methodology from [GetFresh Ventures](https://www.getfreshventures.com).
>
> 🔍 **Hitting a ceiling?** The kit gives you the foundation. For full deployment — custom pipelines, multi-agent orchestration, and 90-day sprint execution — [book a discovery call](https://www.getfreshventures.com/contact).
>
> 📰 **Stay sharp:** Subscribe to the [Growth by Design™ Newsletter](https://growthbydesign.substack.com/) for operator-written playbooks on AI-powered GTM.

</gxd_footer>