Ra Pro -- Deep Research Intelligence

The most powerful research skill on ClawHub. 12+ sources, multi-angle analysis, competitive breakdowns, and professional-grade reports in markdown and DOCX.

Bundle deal: All 5 Egyptian skills for $29 -> ko-fi.com/s/7625accf3f (save $16)

Step 1 -- Install

pip3 install rich --break-system-packages --quiet

Step 2 -- Validate license and setup

import os, sys, re
from datetime import datetime
from rich.console import Console
from rich.panel import Panel
from rich.rule import Rule
from rich.table import Table
from rich import box

console = Console()

LICENSE_KEY = os.environ.get("LICENSE_KEY", "").strip()
if not LICENSE_KEY or not LICENSE_KEY.startswith("RA-PRO-"):
    console.print(Panel(
        "[red bold]Ra Pro requires a license key.[/red bold]\n\n"
        "Get your key at: [bold cyan]ko-fi.com/occupythemilkyway[/bold cyan]\n\n"
        "Or use Ra Standard ($5): [dim]openclaw skills install ra[/dim]\n"
        "Or use Ra Lite (free): [dim]openclaw skills install ra-lite[/dim]",
        title="License Required",
        border_style="red"
    ))
    sys.exit(1)

TOPIC       = os.environ.get("RESEARCH_TOPIC", "").strip()
DEPTH       = os.environ.get("DEPTH", "deep").lower().strip()
ANGLE       = os.environ.get("ANGLE", "balanced").lower().strip()
COMPETITIVE = os.environ.get("COMPETITIVE", "no").lower().strip() == "yes"
CITE_STYLE  = os.environ.get("CITATION_STYLE", "bibliography").lower().strip()
OUTBASE     = os.environ.get("OUTPUT_FILE", "").strip()

if not TOPIC:
    console.print(Panel("[red]RESEARCH_TOPIC is required.[/red]", title="Setup Error", border_style="red"))
    sys.exit(1)

DEPTH_SOURCES = {"standard": 10, "deep": 14, "exhaustive": 20}
num_sources   = DEPTH_SOURCES.get(DEPTH, 14)

safe_topic = re.sub(r"[^a-z0-9]+", "_", TOPIC.lower())[:40]
date_str   = datetime.now().strftime("%Y%m%d")
if not OUTBASE:
    OUTBASE = f"ra_pro_{safe_topic}_{date_str}"

OUTFILE_MD   = OUTBASE + ".md"
OUTFILE_DOCX = OUTBASE + ".docx"

console.print()
console.print(Panel.fit(
    f"[bold yellow]☀️ Ra Pro -- Deep Research Intelligence[/bold yellow]\n"
    f"Topic:      [cyan]{TOPIC}[/cyan]\n"
    f"Depth:      [white]{DEPTH}[/white]  ({num_sources} sources)\n"
    f"Angle:      [white]{ANGLE}[/white]\n"
    f"Competitive: [white]{'Yes' if COMPETITIVE else 'No'}[/white]\n"
    f"Citations:  [white]{CITE_STYLE}[/white]\n"
    f"Output:     [dim]{OUTFILE_MD}[/dim]",
    border_style="yellow"
))

cfg = Table(box=box.SIMPLE, show_header=False, border_style="dim")
cfg.add_column("Setting", style="dim")
cfg.add_column("Value", style="cyan")
cfg.add_row("Sources", str(num_sources))
cfg.add_row("Angle", ANGLE.capitalize())
cfg.add_row("Competitive analysis", "Yes" if COMPETITIVE else "No")
cfg.add_row("Citation style", CITE_STYLE.upper())
console.print(cfg)
console.print(Rule("[yellow]Beginning deep research...[/yellow]"))

Step 3 -- Full research cycle

Research the topic: {RESEARCH_TOPIC}

Search the web extensively. Find {num_sources} authoritative sources. Then produce this full pro report:

# Research Intelligence Report: [TOPIC]
**Ra Pro** | [DATE] | Depth: [DEPTH] | Angle: [ANGLE]

---

## Executive Brief
5-6 sentences. Headline finding, key data point, bottom-line implication. Written for a busy executive who reads only this section.

## Background & Landscape
Comprehensive context: history, current state, key players, market size (if applicable). 3-4 paragraphs.

## Core Findings
### 1. [Finding Title]
Full paragraph with data, statistics, and direct citation.

### 2. [Finding Title]
Full paragraph...

[Continue for all major findings, minimum 5]

## [IF ANGLE=balanced OR critical] Opposing Viewpoints & Counterarguments
What the critics, skeptics, and dissenting voices say. Be fair and complete.

## [IF COMPETITIVE=yes] Competitive & Market Analysis
Who are the key players? What are they doing? Market share, positioning, gaps.

## Synthesis
What do all findings mean together? Where is the consensus? Where is the tension?

## Strategic Implications
What should someone DO with this research? Concrete recommendations or decisions this data supports.

## Conclusion
2-3 sentences wrapping the whole report.

## [CITATION_STYLE] References
[Format according to CITATION_STYLE: bibliography / APA / MLA / Chicago]

Use every source. Write with depth and precision. No fluff.

Step 4 -- Save report and wrap up

from rich.console import Console
from rich.panel import Panel
console = Console()

# Claude saves the full report to OUTFILE_MD using its file tool
console.print()
console.print(Panel(
    f"[bold green]Research complete.[/bold green]\n\n"
    f"Markdown report: [cyan]{OUTFILE_MD}[/cyan]\n"
    f"Sources analyzed: [yellow]{num_sources}[/yellow]\n\n"
    f"[dim]Tip: Use the docx skill to convert {OUTFILE_MD} to a formatted Word document.[/dim]",
    title="[green]Ra Pro -- Done[/green]",
    border_style="green"
))

After generating the report in Step 3, save the full content to {OUTFILE_MD} using your file writing tool.