Skip to content
Back to search

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.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/kevalshingala4--realitycheck-30d/badge.svg)](/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

i

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
  1. ---
  2. name: my-30days-research
  3. 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
  4. ---
  5. # 30-Day Multi-Source Community Research & Idea Mining Engine
  6. This skill equips an AI agent to research any topic across three authentic developer communities from the past 30 days:
  7. 1. **Hacker News:** High-signal discussions, founder perspectives, and technical debates.
  8. 2. **DEV Community:** Real developer tutorials, architecture writeups, and experiences.
  9. 3. **GitHub:** Trending open-source tools and repositories ranked by stars.
  10. It then uses Google's free Gemini Flash model to synthesize the findings into either:
  11. - **`--mode brief` (Default):** The **Hype vs. Reality** filter (The Promise, The Reality Check, The Verdict, and Trending Code).
  12. - **`--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).
  13. Every run updates an interactive, dark-mode visual magazine at `briefs/index.html` and saves a timestamped Markdown report.
  14. ---
  15. ## When to Use This Skill
  16. Activate this skill when:
  17. - The user asks: *"What are people saying about [topic] in the last 30 days?"*
  18. - The user asks: *"What problems or tool ideas exist in [topic] right now?"* (`--mode ideas`)
  19. - Researching recent community sentiment, tool releases, or alternatives to a framework.
  20. - Investigating real-world friction and gotchas before adopting a technology.
  21. ---
  22. ## How to Run the Tool
  23. Execute the Python research script from the project root:
  24. ### 1. The Hype vs. Reality Brief (Default)
  25. ```bash
  26. python research.py "<topic>"
  27. # or explicitly:
  28. python research.py "<topic>" --mode brief
  29. ```
  30. ### 2. The Unbuilt Opportunities Detector
  31. ```bash
  32. python research.py "<topic>" --mode ideas
  33. ```
  34. ### Example Invocations:
  35. ```bash
  36. python research.py "AI agents" --mode ideas
  37. python research.py "Local LLMs" --mode brief
  38. python research.py "Rust web frameworks"
  39. ```
  40. ---
  41. ## Interactive Local Magazine Dashboard
  42. After running any search, open the generated HTML dashboard in any browser:
  43. ```text
  44. briefs/index.html
  45. ```
  46. Features:
  47. - **Dark Mode UI:** Modern, clean magazine layout.
  48. - **Sidebar Archive:** Browse, search, and filter all past research briefs.
  49. - **One-Click Copy:** Easily copy the formatted markdown for notes or reports.
  50. - **Direct Citations:** Clickable links to every underlying discussion thread and repository.
  51. ---
  52. ## Prerequisites (100% Free)
  53. 1. **Python 3.10+** (uses standard libraries and `curl_cffi`).
  54. 2. **Google Gemini API Key:**
  55. - Grab a free key at [Google AI Studio](https://aistudio.google.com/).
  56. - Place it inside `.env`:
  57. ```env
  58. GEMINI_API_KEY=your_key_here
  59. ```
README.md · README · 95 lines
  1. # RealityCheck 30D
  2. 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.
  3. Powered by free community data sources and Google's free Gemini Flash model.
  4. ---
  5. <img width="1336" height="585" alt="image" src="https://github.com/user-attachments/assets/db6300ac-4e6b-43df-93ae-e41ba82d36c1" />
  6. ## Why RealityCheck?
  7. Traditional search results are frequently saturated with search-engine-optimized posts and promotional articles. RealityCheck bypasses that noise by directly querying active practitioner communities:
  8. * **Hacker News:** Real discussions, founder feedback, and architecture debates.
  9. * **DEV Community:** Authentic developer writeups, tutorials, and practical hurdles.
  10. * **GitHub:** Community-starred repositories and new open-source releases.
  11. ---
  12. ## Key Capabilities
  13. ### 1. The Hype vs. Reality Filter (`--mode brief`)
  14. Generates an objective summary split into:
  15. * **The Promise:** What the community is genuinely excited about.
  16. * **The Reality Check:** Production gotchas, limitations, bundle regressions, and complaints.
  17. * **The Verdict:** An honest evaluation of whether the tech is production-ready today.
  18. * **Every takeaway is backed by direct URLs** to the source discussions.
  19. ### 2. The Unbuilt Opportunities Detector (`--mode ideas`)
  20. Analyzes real complaints and friction points in the community to surface **3 concrete tool or micro-SaaS opportunities**, complete with:
  21. * Target audience
  22. * The specific problem being solved
  23. * Community evidence links
  24. * A realistic blueprint to build the first version in a weekend
  25. ### 3. Smart Query & Version Cascade
  26. 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.
  27. ### 4. Local Visual Magazine Dashboard
  28. 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.
  29. ---
  30. ## Getting Started
  31. ### Prerequisites
  32. * Python 3.10 or newer
  33. * A free Google Gemini API key from [Google AI Studio](https://aistudio.google.com/) (no credit card required)
  34. ### Installation
  35. 1. **Clone the repository:**
  36. ```bash
  37. git clone https://github.com/your-username/realitycheck-30d.git
  38. cd realitycheck-30d
  39. ```
  40. 2. **Install dependencies:**
  41. ```bash
  42. pip install curl_cffi
  43. ```
  44. 3. **Configure your free API key:**
  45. ```bash
  46. cp .env.example .env
  47. ```
  48. Open `.env` and add your key:
  49. ```env
  50. GEMINI_API_KEY=your_actual_key_here
  51. ```
  52. ---
  53. ## Usage
  54. ```bash
  55. # Generate a Hype vs. Reality brief (default)
  56. python research.py "AI agents"
  57. python research.py "Next.js 15" --mode brief
  58. # Discover unbuilt micro-SaaS opportunities
  59. python research.py "AI agents" --mode ideas
  60. python research.py "Local LLMs" --mode ideas
  61. ```
  62. ### Viewing Your Dashboard
  63. Open `briefs/index.html` in your web browser to browse your past research briefs in an offline-ready dark-mode interface.
  64. ---
  65. ## License
  66. Released under the [MIT License](LICENSE).

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.