my-30days-research
Research any topic across Hacker News, GitHub, and DEV Community over the last 30 days and synthesize a cited brief or detect unbuilt micro-SaaS opportunities
Safety scan
A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.
Badge for your README
Markdown
[](/listings/kevalshingala4--realitycheck-30d)HTML
<a href="/listings/kevalshingala4--realitycheck-30d"><img src="/api/listings/kevalshingala4--realitycheck-30d/badge.svg" alt="findsafeskills safety rating" /></a>Install
Install instructions from the README
As written by the repo's author. findsafeskills has not verified these steps.
Prerequisites
* Python 3.10 or newer * A free Google Gemini API key from [Google AI Studio](https://aistudio.google.com/) (no credit card required)
Installation
1. **Clone the repository:**
git clone https://github.com/your-username/realitycheck-30d.git cd realitycheck-30d
2. **Install dependencies:**
pip install curl_cffi
3. **Configure your free API key:**
cp .env.example .env
Open `.env` and add your key:
GEMINI_API_KEY=your_actual_key_here
---
What was scanned
The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.
SKILL.md · Manifest · 78 lines
- ---
- name: my-30days-research
- description: Research any topic across Hacker News, GitHub, and DEV Community over the last 30 days and synthesize a cited brief or detect unbuilt micro-SaaS opportunities
- ---
- # 30-Day Multi-Source Community Research & Idea Mining Engine
- This skill equips an AI agent to research any topic across three authentic developer communities from the past 30 days:
- 1. **Hacker News:** High-signal discussions, founder perspectives, and technical debates.
- 2. **DEV Community:** Real developer tutorials, architecture writeups, and experiences.
- 3. **GitHub:** Trending open-source tools and repositories ranked by stars.
- It then uses Google's free Gemini Flash model to synthesize the findings into either:
- - **`--mode brief` (Default):** The **Hype vs. Reality** filter (The Promise, The Reality Check, The Verdict, and Trending Code).
- - **`--mode ideas`:** The **Unbuilt Opportunities** detector (mining real developer complaints to formulate 3 concrete micro-SaaS or tool ideas with target users and weekend MVPs).
- Every run updates an interactive, dark-mode visual magazine at `briefs/index.html` and saves a timestamped Markdown report.
- ---
- ## When to Use This Skill
- Activate this skill when:
- - The user asks: *"What are people saying about [topic] in the last 30 days?"*
- - The user asks: *"What problems or tool ideas exist in [topic] right now?"* (`--mode ideas`)
- - Researching recent community sentiment, tool releases, or alternatives to a framework.
- - Investigating real-world friction and gotchas before adopting a technology.
- ---
- ## How to Run the Tool
- Execute the Python research script from the project root:
- ### 1. The Hype vs. Reality Brief (Default)
- ```bash
- python research.py "<topic>"
- # or explicitly:
- python research.py "<topic>" --mode brief
- ```
- ### 2. The Unbuilt Opportunities Detector
- ```bash
- python research.py "<topic>" --mode ideas
- ```
- ### Example Invocations:
- ```bash
- python research.py "AI agents" --mode ideas
- python research.py "Local LLMs" --mode brief
- python research.py "Rust web frameworks"
- ```
- ---
- ## Interactive Local Magazine Dashboard
- After running any search, open the generated HTML dashboard in any browser:
- ```text
- briefs/index.html
- ```
- Features:
- - **Dark Mode UI:** Modern, clean magazine layout.
- - **Sidebar Archive:** Browse, search, and filter all past research briefs.
- - **One-Click Copy:** Easily copy the formatted markdown for notes or reports.
- - **Direct Citations:** Clickable links to every underlying discussion thread and repository.
- ---
- ## Prerequisites (100% Free)
- 1. **Python 3.10+** (uses standard libraries and `curl_cffi`).
- 2. **Google Gemini API Key:**
- - Grab a free key at [Google AI Studio](https://aistudio.google.com/).
- - Place it inside `.env`:
- ```env
- GEMINI_API_KEY=your_key_here
- ```
README.md · README · 95 lines
- # RealityCheck 30D
- An open-source research engine that skips marketing hype and uncovers what developers are genuinely building, debating, and struggling with across the live community web over the past 30 days.
- Powered by free community data sources and Google's free Gemini Flash model.
- ---
- <img width="1336" height="585" alt="image" src="https://github.com/user-attachments/assets/db6300ac-4e6b-43df-93ae-e41ba82d36c1" />
- ## Why RealityCheck?
- Traditional search results are frequently saturated with search-engine-optimized posts and promotional articles. RealityCheck bypasses that noise by directly querying active practitioner communities:
- * **Hacker News:** Real discussions, founder feedback, and architecture debates.
- * **DEV Community:** Authentic developer writeups, tutorials, and practical hurdles.
- * **GitHub:** Community-starred repositories and new open-source releases.
- ---
- ## Key Capabilities
- ### 1. The Hype vs. Reality Filter (`--mode brief`)
- Generates an objective summary split into:
- * **The Promise:** What the community is genuinely excited about.
- * **The Reality Check:** Production gotchas, limitations, bundle regressions, and complaints.
- * **The Verdict:** An honest evaluation of whether the tech is production-ready today.
- * **Every takeaway is backed by direct URLs** to the source discussions.
- ### 2. The Unbuilt Opportunities Detector (`--mode ideas`)
- Analyzes real complaints and friction points in the community to surface **3 concrete tool or micro-SaaS opportunities**, complete with:
- * Target audience
- * The specific problem being solved
- * Community evidence links
- * A realistic blueprint to build the first version in a weekend
- ### 3. Smart Query & Version Cascade
- Searching for specific version numbers (like `Next.js 15` or `Python 3.14`) often returns zero results on strict platform tags. RealityCheck automatically creates a smart fallback cascade (e.g. `Next.js 15` -> `Next.js` -> `nextjs`) so your searches never return empty.
- ### 4. Local Visual Magazine Dashboard
- Every search automatically archives a Markdown report and updates an interactive, self-contained local web magazine at `briefs/index.html`. It includes a search filter, past reports sidebar, and a one-click copy button.
- ---
- ## Getting Started
- ### Prerequisites
- * Python 3.10 or newer
- * A free Google Gemini API key from [Google AI Studio](https://aistudio.google.com/) (no credit card required)
- ### Installation
- 1. **Clone the repository:**
- ```bash
- git clone https://github.com/your-username/realitycheck-30d.git
- cd realitycheck-30d
- ```
- 2. **Install dependencies:**
- ```bash
- pip install curl_cffi
- ```
- 3. **Configure your free API key:**
- ```bash
- cp .env.example .env
- ```
- Open `.env` and add your key:
- ```env
- GEMINI_API_KEY=your_actual_key_here
- ```
- ---
- ## Usage
- ```bash
- # Generate a Hype vs. Reality brief (default)
- python research.py "AI agents"
- python research.py "Next.js 15" --mode brief
- # Discover unbuilt micro-SaaS opportunities
- python research.py "AI agents" --mode ideas
- python research.py "Local LLMs" --mode ideas
- ```
- ### Viewing Your Dashboard
- Open `briefs/index.html` in your web browser to browse your past research briefs in an offline-ready dark-mode interface.
- ---
- ## License
- Released under the [MIT License](LICENSE).
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.