Agent skill

Research Report Interpretation

by byteseek in byteseek/Mira

Interpret sell-side, institutional, expert, or investor research by extracting claims, assumptions, valuation drivers, verification needs, and thesis impact.

Apache-2.0Auto-check passedBusiness, Finance & HR

Install Research Report Interpretation

skills CLI
$ npx skills add byteseek/Mira --skill research-report-interpretation -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install byteseek/Mira research-report-interpretation --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/byteseek/Mira.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/research-report-interpretation .claude/skills/research-report-interpretation && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
research-report-interpretation
GitHub stars
275
Token cost
~3k tokens
SKILL.md length
1,354 words
Files
1
Skills in repo
10
Repo updated
First seen
Licence
Apache-2.0

At a glance

Interpret sell-side, institutional, expert, or investor research by extracting claims, assumptions, valuation drivers, verification needs, and thesis impact.

  • Works in 8 steps: Report Metadata And Source Posture → Thesis Of The Report → Claim Extraction → …
  • Tasks that involve Essays and academic help
  • SKILL.md covers Use When, Required Inputs, Required Source Types and Ingestion And Permission Gate, plus 6 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Research Report Interpretation is an agent skill from byteseek/Mira. Interpret sell-side, institutional, expert, or investor research by extracting claims, assumptions, valuation drivers, verification needs, and thesis impact.

Its SKILL.md is about 3k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Business, Finance & HR, covering Essays and academic help and Deep research. The repository describes itself as: Agent-native investment research workspace for evidence-tracked, refreshable investment theses across equities, earnings, macro, and portfolio review. The licence is Apache-2.0.

When your agent uses it

  • Tasks that involve Essays and academic help
  • Tasks that involve Deep research

Example prompts

  • “/research-report-interpretation”

Workflow steps

8 steps, taken from the step headings in SKILL.md.

  1. Report Metadata And Source Posture
  2. Thesis Of The Report
  3. Claim Extraction
  4. Expectation And Variant-Perception Bridge
  5. Valuation And Model Decomposition
  6. Evidence Cross-Check
  7. Bias, Incentive And Framing Check
  8. Mira Thesis Impact

What it can do on your machine

Read from SKILL.md and the folder at commit adddce7. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Research Report Interpretation loads about 3k tokens when it runs. Until then it costs about 47 tokens; SKILL.md has 1,354 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~47
When it runs · the whole SKILL.md, loaded when a task matches
~3k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from byteseek/Mira at commit adddce7, republished under its Apache-2.0 licence (© byteseek). 1,354 words, ~3,000 tokens.

Download SKILL.mdSave it as .claude/skills/research-report-interpretation/SKILL.md (or your agent's skills folder).
name
research-report-interpretation
description
Interpret sell-side, institutional, expert, or investor research by extracting claims, assumptions, valuation drivers, verification needs, and thesis impact.

Research Report Interpretation Skill

这个 skill 用于解读券商、卖方、机构、专家或投资者研究报告。它的目标不是复述研报,而是把一份报告拆成可验证 claim、隐含假设、预期变量、估值驱动和对 Mira thesis 的增量影响。

研报在 Mira 中默认是 sellside_and_expert_research,通常是 L3 secondary / signal。它可以帮助识别框架、预期差、变量优先级、估值方法和叙事变化,但不能替代公司披露、监管文件、官方数据、市场数据或可复算模型。

Use When

  • 用户提供或指定一份券商研报、机构研报、rating change、target price update、initiation note、industry note、专家研究、投资者信或研究 PDF。
  • 用户问“这篇研报怎么看 / 靠谱吗 / 有什么新东西 / 对 thesis 有什么影响”。
  • 需要从研报中提取可复用方法、变量框架或预期差线索,但当前任务仍围绕某个研究对象,而不是纯方法论研究。
  • 需要把研报结论与已有 Mira thesis、company filing、earnings package、consensus proxy 或市场定价做差异检查。

如果用户问的是“这个研究方法本身是否值得纳入 Mira”,优先进入 loops/methodology-research-loop.md。如果研报解读触发 thesis 状态变化,再 handoff 到 loops/thesis-update-loop.md 或 loops/event-delta-loop.md。

Required Inputs

  • research_object: ticker、company、industry、macro asset 或 methodology object。
  • market_scope
  • time_boundary
  • report_title
  • provider_or_submitter
  • author_or_team,如可得
  • report_date 或明确的 source_gap
  • report_type: initiation、update、rating_change、target_price_update、industry_note、thematic_note、expert_research、investor_letter、other
  • access_route: public_on_demand、user_material、authorized_provider 或 transient_only
  • license_scope
  • storage_scope
  • redistribution_allowed
  • user_goal: summarize、challenge、extract_claims、compare_to_thesis、update_thesis、reverse_engineer_method
  • completeness_status: full_report、excerpt、screenshot、summary_only、metadata_only

Required Source Types

  • Report source or user material intake record.
  • restricted_source_note when the report is paid, confidential, licensed, user-provided, expert-network, or otherwise restricted.
  • At least one independent L1 / L2 / L5 source when a report claim is used for a durable conclusion.
  • Existing Mira thesis package, evidence log or expectation map when the user asks for thesis impact.
  • Consensus or estimate source, or explicit source_gap, when the interpretation depends on market expectation baseline.

Ingestion And Permission Gate

Before using a newly supplied report, run data/ingestion-layer.md.

Default treatment:

  • Public report URL: ingestion_route=public_on_demand; cite metadata and short summaries only.
  • User upload, screenshot, clipped PDF or exported note: ingestion_route=user_material; keep private unless user explicitly approves promotion.
  • Licensed vendor or paid research: ingestion_route=authorized_provider or user_material; tracked artifacts may contain metadata, short compliant effect notes and claim categories, not raw report content.
  • Unknown permission: storage_scope=transient_only or private; public_case_use=blocked.

Do not commit full paid reports, substantial excerpts, expert-network transcripts, or vendor raw data. Do not quote long passages. Extract claim-level summaries instead.

Analysis Flow

1. Report Metadata And Source Posture

Record:

  • report identity, date, provider, author/team and source URL/path
  • permission and storage boundary
  • whether the report is complete or only a fragment
  • whether it is company-specific, industry-wide, macro, thematic or method-focused
  • stale boundary: report date, event covered, next earnings, next data release or target price/rating update

If report_date, permission, completeness or object identity is missing, keep the output at working_view and mark the gap.

2. Thesis Of The Report

Separate:

  • headline conclusion
  • core variable the author believes matters most
  • time horizon of the view
  • catalyst or revision path
  • base case, bull case and bear case
  • rating / target price / valuation output
  • evidence the report itself cites
  • what the report asks the market to change its mind about

Never treat rating, target price or author conviction as evidence by itself.

3. Claim Extraction

Extract claim-level records into report-claim-map.csv.

Each row should identify:

  • claim_type: fact, reported_metric, guidance, target, forecast, assumption, interpretation, opinion, market_pricing, sentiment or derived_calculation
  • source_speaker: sellside, buyside, expert, company, market, media or mira
  • variable: revenue, margin, pricing, volume, capex, cash flow, multiple, risk premium, market share, demand, supply, regulation or other
  • time_horizon: current, next_quarter, FY1, FY2, long_term or unknown
  • evidence_cited_by_report
  • independent_verification_status
  • treatment: use_normally, attribute, monitor, needs_cross_check, source_gap, exclude

Facts and reported metrics require independent verification before they can support a durable Mira conclusion. Forecasts, assumptions, interpretations and opinions remain attributed to the report.

4. Expectation And Variant-Perception Bridge

Ask:

  • Is the report describing consensus, challenging consensus, or updating consensus?
  • Which variable is the expectation baseline: revenue, EPS, margin, FCF, capex, TAM, unit volume, ASP, multiple or risk premium?
  • Does the report cite consensus provider/data, or is it using author estimates?
  • Is the claimed edge from better facts, better interpretation, different time horizon, or different risk weighting?
  • What would prove the author right or wrong?

If no reliable consensus proxy exists, write source_gap; do not replace consensus with a single analyst view, media tone or price action.

5. Valuation And Model Decomposition

If the report includes target price, rating, valuation multiple, DCF, SOTP or scenario math, decompose:

  • forecast driver: revenue, margin, EPS, FCF, capex, share count, net cash/debt
  • valuation anchor: P/E, EV/Sales, EV/EBITDA, EV/FCF, DCF, SOTP, NAV, replacement cost or other
  • terminal assumptions and discount rate if available
  • multiple change versus estimate change
  • sensitivity: which input moves the conclusion most
  • hidden assumption: margin normalization, utilization, terminal growth, TAM share, customer concentration, dilution or cost of capital

If Mira relies on these numbers for a conclusion, run skills/data-analysis-quality-gate/SKILL.md and record formulas or calculation_gap.

6. Evidence Cross-Check

Cross-check the report's material claims against:

  • issuer primary disclosure or filing
  • current or recent earnings package
  • transcript / management Q&A where relevant
  • market price, valuation and estimate data
  • peer disclosure or industry data
  • previous Mira evidence log or expectation map

Classify each material claim:

  • confirmed: independently supported by higher-weight evidence
  • plausible_unverified: directionally plausible but not yet confirmed
  • contested: contradicted or weakened by other evidence
  • opinion_only: useful framing, not evidence
  • source_gap: cannot be checked with available sources
7. Bias, Incentive And Framing Check

Check for:

  • rating or target-price anchoring
  • model-driven precision without source detail
  • selective peer set or date window
  • company-access bias
  • event-chasing after price movement
  • bull-case assumptions embedded in base case
  • TAM-to-revenue leap
  • channel-check anecdote presented as broad demand fact
  • valuation multiple change without explicit risk-premium or growth rationale

Bias check does not reject the report automatically. It determines treatment and confidence.

Show full SKILL.md (547 more words)Show less
8. Mira Thesis Impact

If an existing thesis or expectation map exists, classify the report impact:

  • no_new_evidence: repeats known consensus or prior Mira view
  • new_variable: introduces a variable Mira was not tracking
  • evidence_upgrade: improves evidence quality for an existing variable
  • evidence_downgrade: weakens or contradicts a current variable
  • expectation_delta: changes consensus, author estimates or valuation-implied expectation
  • method_delta: useful framework should enter methodology review
  • actionability_gap: interesting but not enough for research action without more data

Then state whether to update:

  • evidence-log.csv
  • expectation-map.csv
  • thesis-ledger.md
  • event-delta.md
  • methodology-card.md

When a research report contributes a reusable method for gold, precious metals or macro-sensitive commodities, do not promote the method directly. Classify it as method_delta, identify the existing Mira method it extends, and record whether it should become a labeled lens. For example, a gold residual / MSE framework should map to memory/methodologies/gold-residual-regime-lens.md unless independent data reconstruction supports a stronger methodology review.

Output Package

Default output package:

  • report-readout.md
  • report-claim-map.csv
  • evidence-log.csv

Optional supporting artifacts:

  • restricted-source-note.md
  • calculation-ledger.csv
  • thesis-system updates when impact is material
  • methodology card when the main value is a reusable method

quick_map can output only a routing card, source posture, report thesis, key claim table, Mira impact and refresh triggers. standard should produce the package. deep_dive should add cross-checks, valuation decomposition and thesis-system updates where relevant.

Required Sections In report-readout.md

  • setup
  • source and permission boundary
  • report thesis
  • claim map summary
  • expectation / variant-perception bridge
  • valuation and model decomposition
  • independent cross-check
  • bias and framing check
  • Mira thesis impact
  • facts / inferences / judgments
  • refresh triggers
  • follow-up prompts

Scoring

Use scores only to force structure, not to replace judgment.

dimensionscore rangemeaning
source_posture1-5report identity, date, permission and completeness quality
claim_separation1-5facts, forecasts, assumptions and opinions are separable
evidence_traceability1-5report shows upstream evidence that can be checked
independent_verifiability1-5Mira can cross-check material claims
expectation_delta_quality1-5report improves consensus / expectation understanding
valuation_transparency1-5target price or model assumptions are decomposable
bias_risk1-5higher means more framing / incentive / selection risk
mira_incremental_value1-5value added versus existing Mira state

Red Flags

  • report date or author/source unknown
  • full conclusion rests on target price or rating language
  • facts, forecasts and opinions are mixed without separation
  • target price changes mainly from multiple expansion with no risk-premium explanation
  • TAM narrative is treated as company revenue without share, timing and margin bridge
  • channel checks lack sample, geography, timing or counter-evidence
  • consensus is asserted but provider, date and metric definition are missing
  • report relies on company access or management framing without external check
  • model precision exceeds source quality
  • report is stale relative to earnings, guidance, filing or material event

Stop Rules

  • If permission is unclear, do not retain raw report content in tracked artifacts.
  • If the report is restricted, output only compliant metadata, short effect notes and claim-level summaries.
  • If the report is fragmentary, do not infer omitted model assumptions as known.
  • If independent verification is unavailable, keep conclusions at working_view, monitor or source_gap.
  • If valuation math is central and cannot be reproduced, mark calculation_gap and avoid strong target-price conclusions.
  • If the report only adds opinion and no new evidence, do not update the durable thesis; record no_new_evidence or method_delta only.
  • If a report's main value is a reusable model or factor lens, keep report facts attributed to the report and route the method through methodology review before treating it as a Mira framework.

© byteseek, Apache-2.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in skills/research-report-interpretation of byteseek/Mira.

Open the folder on GitHubat commit adddce7

Compare with similar skills

Research Report Interpretation next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Research Report Interpretation compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Research Report Interpretation this skillbyteseek/Mira275—~3kAutomated safety check: PassApache-2.0
Investable Viewhh-health-AI/healthcare-equity101—~1kAutomated safety check: PassMIT
Oss Investment Scorecardlucy-cxy/oss-investment-scorecard341—~2.5kAutomated safety check: PassNone
China Market Open Data SearchOpenSenseNova/SenseNova-Skills5.7k—~954Automated safety check: NotesMIT
Weekly Trading Planzhu1090093659/dsh-trading238—~2kAutomated safety check: PassCustom licence
Workflow OrchestrationAnastasiyaW/codex-claude-code-config154—~3.8kAutomated safety check: PassMIT

Similar skills

  • Investable View

    hh-health-AI/healthcare-equity

    A skill your agent uses to build a falsifiable healthcare investment view from clinical, regulatory, commercial, competitive and financial evidence; assemble an underwriting thesis with explicit…

    101 GitHub stars~1k tokensUpdated 3 days ago
    Business, Finance & HRAuto-check passed
  • Oss Investment Scorecard

    lucy-cxy/oss-investment-scorecard

    Evaluate whether an open source project / company is investable by a USD-denominated VC fund in the current AI cycle.

    341 GitHub stars~2.5k tokensUpdated 5 mo ago
    Business, Finance & HRAuto-check passed
  • China Market Open Data Search

    OpenSenseNova/SenseNova-Skills

    Researches Chinese market, macro, trade, procurement, listed-company and regulatory information from free official sources that need no sign-up or API key.

    5.7k GitHub stars~954 tokensUpdated 2 days ago
    Business, Finance & HRAuto-check: notes
  • Weekly Trading Plan

    zhu1090093659/dsh-trading

    制定每周交易计划:把本周复盘、统一台账持仓与资金、市场消息与公告、facts/ 与知识库、假设档案(hypothesistracking / 持仓 thesis / 宏观管道状态)合成一份下周计划,逐条过六道闸门并给出双向预案与失效条件。当用户要求「制定本周/下周交易计划」「周度作战计划」「把复盘+持仓+消息+知识库合成计划」,或周末例行生成计划时调用。

    238 GitHub stars~2k tokensUpdated today
    Business, Finance & HRAuto-check passed
  • Workflow Orchestration

    AnastasiyaW/codex-claude-code-config

    Написание и запуск Claude Code dynamic workflows (JS-оркестратор субагентов).

    154 GitHub stars~3.8k tokensUpdated today
    Business, Finance & HRAuto-check passed
  • Xvary Stock Research

    sickn33/agentic-awesome-skills

    Thesis-driven equity analysis from public SEC EDGAR and market data; /analyze, /score, /compare workflows with bundled Python tools (Claude Code, Cursor, Codex).

    47k GitHub starsUsed in 2 repos~952 tokens
    Business, Finance & HRAuto-check passed

More from byteseek/Mira

All 10 skills in this repo
  • Discover listed, pending, filed, or newly announced ETFs and create a structured candidate watchlist for ETF listing analysis.

    275 GitHub stars~887 tokensUpdated 1 mo ago
    Auto-check passed
  • Run Mira's core single-equity research workflow across fundamentals, financial quality, macro context, technical pricing, events, and thesis framing.

    275 GitHub stars~1.9k tokensUpdated 1 mo ago
    Auto-check passed
  • Analyze new, pending, or expanding ETF products as product signals, exposure maps, demand indicators, and potential asset-pricing read-throughs.

    275 GitHub stars~1.6k tokensUpdated 1 mo ago
    Auto-check passed
  • Analyze commodity cycles, futures curves, inventories, cost curves, policy/geopolitics, positioning, and transmission into related assets.

    275 GitHub stars~3k tokensUpdated 1 mo ago
    Auto-check passed
  • Gate quantitative Mira conclusions by requiring reproducible data, formulas, calculation ledgers, or explicit downgrades when numbers drive judgment.

    275 GitHub stars~1.1k tokensUpdated 1 mo ago
    Auto-check passed
  • Analyze earnings releases, filings, transcripts, guidance, peer comparisons, market reaction, and thesis impact for a company reporting event.

    275 GitHub stars~2.6k tokensUpdated 1 mo ago
    Auto-check passed

Questions about Research Report Interpretation

What does Research Report Interpretation do?

Interpret sell-side, institutional, expert, or investor research by extracting claims, assumptions, valuation drivers, verification needs, and thesis impact. Research Report Interpretation is an agent skill from byteseek/Mira. Interpret sell-side, institutional, expert, or investor research by extracting claims, assumptions, valuation drivers, verification needs, and thesis impact.

When should I use Research Report Interpretation?

Research Report Interpretation fits situations like: tasks that involve Essays and academic help; tasks that involve Deep research.

How do I install Research Report Interpretation in Claude Code?

Run `npx skills add byteseek/Mira --skill research-report-interpretation -a claude-code`. Or copy the skill folder (skills/research-report-interpretation in byteseek/Mira) into .claude/skills/research-report-interpretation in your project. Claude Code loads it when a task matches its description.

How do I install Research Report Interpretation in Codex?

Run `npx skills add byteseek/Mira --skill research-report-interpretation -a codex`. Or copy the skill folder (skills/research-report-interpretation in byteseek/Mira) into .agents/skills/research-report-interpretation in your project. Codex loads it when a task matches its description.

Can I use Research Report Interpretation in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add byteseek/Mira --skill research-report-interpretation -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/research-report-interpretation, .gemini/skills/research-report-interpretation, .github/skills/research-report-interpretation and .opencode/skills/research-report-interpretation in your project.

What does Research Report Interpretation need to run?

SKILL.md names no scripts, command-line tools or credentials: Research Report Interpretation is instructions for the agent only.

Does Research Report Interpretation access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Research Report Interpretation safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Research Report Interpretation use?

Research Report Interpretation is published under the Apache-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Research Report Interpretation use?

About 3k tokens (SKILL.md is roughly 12k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Research Report Interpretation?

Skills that share tags, products or a category with Research Report Interpretation: Investable View (hh-health-AI/healthcare-equity, 101 stars), Oss Investment Scorecard (lucy-cxy/oss-investment-scorecard, 341 stars), China Market Open Data Search (OpenSenseNova/SenseNova-Skills, 5.7k stars) and Weekly Trading Plan (zhu1090093659/dsh-trading, 238 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Research Report Interpretation?

byteseek (a GitHub organization) maintains it in byteseek/Mira, which has 275 GitHub stars. The repository holds 10 skills in this directory. The repository was last updated on September 8, 2026.

Source: byteseek/Mira on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.