← Back to Skills Marketplace
youpele52

Equity Research

by youpele52 · GitHub ↗ · v0.1.1
cross-platform ✓ Security Clean
451
Downloads
0
Stars
1
Active Installs
2
Versions
Install in OpenClaw
/install equity-research
Description
Run a full equity research report on a stock by executing three local scripts with uv run. Read this skill file for exact commands. Do NOT use sessions_spawn...
README (SKILL.md)

Skill: Equity Research

When to use

  • The user wants a full breakdown or deep dive on a stock.
  • The user wants to make a buy/sell/hold decision and needs all signals in one place.
  • The user asks "tell me everything about [ticker]" or "give me a full report on [company]".
  • The user wants comprehensive equity research combining price, fundamentals, and market sentiment.

When NOT to use

  • The user only wants the current price or daily movement → use stock-price-checker-pro
  • The user only wants fundamentals (P/E, EPS, margins) → use stock-fundamentals
  • The user only wants recent news headlines → use market-news-brief

Commands

This skill orchestrates three sub-skills. Run all three commands for the same ticker, then synthesize the results into a unified report.

Step 1 — Current price, ranges, and upcoming events

uv run /root/.openclaw/workspace/skills/stock-price-checker-pro/src/main.py \x3CTICKER>

Step 2 — Fundamentals (valuation, profitability, balance sheet)

uv run /root/.openclaw/workspace/skills/stock-fundamentals/src/main.py \x3CTICKER>

Step 3 — Broad market news and sentiment

# For US-listed stocks
uv run /root/.openclaw/workspace/skills/market-news-brief/src/main.py US

# For German/European stocks (e.g. RHM.DE, SAP.DE, ASML.AS)
uv run /root/.openclaw/workspace/skills/market-news-brief/src/main.py EUROPE

# For Japanese stocks (e.g. 7203.T)
uv run /root/.openclaw/workspace/skills/market-news-brief/src/main.py JAPAN

# For Korean stocks (e.g. 005930.KS)
uv run /root/.openclaw/workspace/skills/market-news-brief/src/main.py SOUTH_KOREA

⚠️ market-news-brief takes a market scope word (US, EUROPE, ASIA, GLOBAL, UK, GERMANY, NETHERLANDS, JAPAN, SOUTH_KOREA). Do NOT pass a bare company ticker like AAPL or RHM.DE — it will error. Use US for US-listed equities, EUROPE for European stocks, GLOBAL for a worldwide macro backdrop.

Full example — Apple (US)

uv run /root/.openclaw/workspace/skills/stock-price-checker-pro/src/main.py AAPL
uv run /root/.openclaw/workspace/skills/stock-fundamentals/src/main.py AAPL
uv run /root/.openclaw/workspace/skills/market-news-brief/src/main.py US

Full example — Rheinmetall (Germany)

uv run /root/.openclaw/workspace/skills/stock-price-checker-pro/src/main.py RHM.DE
uv run /root/.openclaw/workspace/skills/stock-fundamentals/src/main.py RHM.DE
uv run /root/.openclaw/workspace/skills/market-news-brief/src/main.py EUROPE

Full example — NVIDIA (US)

uv run /root/.openclaw/workspace/skills/stock-price-checker-pro/src/main.py NVDA
uv run /root/.openclaw/workspace/skills/stock-fundamentals/src/main.py NVDA
uv run /root/.openclaw/workspace/skills/market-news-brief/src/main.py US

Report Structure

After running all three commands, synthesize the results into a structured report:

  1. Price Snapshot — current price, daily change, volume, 52W range, upcoming events
  2. Fundamentals Summary — valuation multiples, profitability margins, debt profile, analyst target
  3. Market Context — macro tone for the relevant region, dominant themes, key headlines
  4. Overall Take — a brief synthesized assessment combining all three signals (bullish / neutral / bearish and why)

Notes

  • Always run all three sub-skills before writing the report — partial data leads to incomplete conclusions.
  • Each sub-skill uses uv run internally — no manual pip install or environment setup needed.
  • Do NOT attempt to fetch any of this data via web search or curl — always use the commands above.
  • Do NOT use the .sh wrapper scripts — call uv run src/main.py directly as shown in the examples.
  • uv run reads the inline # /// script dependency block in each main.py and auto-installs yfinance — no pip or venv setup needed.
  • Ticker symbols must be valid Yahoo Finance tickers. See TOOLS.md for the full ticker format reference by exchange.
Usage Guidance
This skill is coherent: it simply runs three local scripts and synthesizes their outputs. Before installing, verify that the 'uv' binary will run in your environment and that the three referenced scripts exist at the exact paths shown and come from trusted sources. Because the skill executes local code, review the contents of /root/.openclaw/workspace/skills/stock-price-checker-pro/src/main.py, .../stock-fundamentals/src/main.py, and .../market-news-brief/src/main.py (or test in a sandbox) to ensure they don't perform unexpected network access, credential reads, or destructive operations. Also note the absolute /root paths may not be valid in your deployment; if the files aren't present, the commands will fail. The lack of scanner findings only means there was no code to analyze in this package — it doesn't guarantee safety of the referenced scripts.
Capability Analysis
Type: OpenClaw Skill Name: equity-research Version: 0.1.1 The equity-research skill bundle is a markdown-based orchestrator that provides instructions for an AI agent to run three specific local Python scripts (stock-price-checker-pro, stock-fundamentals, and market-news-brief) using 'uv run'. The instructions in SKILL.md are clearly aligned with the stated purpose of generating financial reports and do not contain any evidence of malicious intent, data exfiltration, or unauthorized system access. While the use of shell commands and absolute paths (/root/.openclaw/workspace/...) involves inherent risks common to agentic workflows, there are no signs of intentional exploitation or harmful prompt injection.
Capability Assessment
Purpose & Capability
The name/description (equity research) matches the runtime actions: the SKILL.md explicitly orchestrates three local sub-skill scripts (price, fundamentals, market news) using the 'uv' binary. Requiring 'uv' and no other credentials or env vars is proportional to an orchestrator that only runs local scripts.
Instruction Scope
The instructions are narrowly scoped to running three specific local commands and synthesizing outputs. They reference absolute paths under /root/.openclaw/workspace/skills/* and explicitly forbid web search/sessions_spawn. Because the skill executes other local scripts, its safety depends on those scripts' contents: if any referenced main.py is malicious or altered, the orchestrator will run that code. The absolute /root paths assume a specific runtime layout and may fail or be sensitive in different deployments.
Install Mechanism
No install spec (instruction-only) so nothing is downloaded or written by this skill itself. This minimizes installation risk. The SKILL.md mentions that 'uv run' will auto-install Python packages referenced by the scripts; that behavior is external to this skill and is expected for running other skills' scripts.
Credentials
No environment variables, credentials, or external config paths are requested. That is proportionate for a simple orchestrator whose job is to invoke local scripts.
Persistence & Privilege
The skill is not always-enabled and does not request any special persistent presence or privileges. It does not modify other skills' configs according to the provided metadata.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install equity-research
  3. After installation, invoke the skill by name or use /equity-research
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v0.1.1
**Major rewrite and clarity upgrade for the equity research skill—now with explicit CLI command orchestration.** - Adds precise `uv run` commands to orchestrate the three companion skills for each report. - Clarifies when to use (and not to use) this orchestrator skill versus its sub-skills. - Details proper usage for `market-news-brief`, specifying which region keyword to pass for global coverage. - Provides example command sequences for US, German, Japanese, and Korean stocks. - Introduces a four-section unified report structure for clear, actionable output. - Removes references to sessions or web search; strictly enforces command-line scripted data gathering.
v0.1.0
- Initial release of the equity-research orchestration skill. - Combines stock price, company fundamentals, and market news into a streamlined equity research workflow. - Requires the companion skills: `stock-price-checker-pro`, `stock-fundamentals`, and `market-news-brief`. - Provides a single concise research-style output that merges company-specific and broader market factors. - Not a standalone data-fetching skill—relies on pre-installed finance skills for full functionality.
Metadata
Slug equity-research
Version 0.1.1
License
All-time Installs 1
Active Installs 1
Total Versions 2
Frequently Asked Questions

What is Equity Research?

Run a full equity research report on a stock by executing three local scripts with uv run. Read this skill file for exact commands. Do NOT use sessions_spawn... It is an AI Agent Skill for Claude Code / OpenClaw, with 451 downloads so far.

How do I install Equity Research?

Run "/install equity-research" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Equity Research free?

Yes, Equity Research is completely free (open-source). You can download, install and use it at no cost.

Which platforms does Equity Research support?

Equity Research is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Equity Research?

It is built and maintained by youpele52 (@youpele52); the current version is v0.1.1.

💬 Comments