Agent skill

Research Conventions

by ginlix-ai in ginlix-ai/LangAlpha

The evidence, judgement, intake and market-data rules every research deliverable follows.

Apache-2.0Auto-check passedBusiness, Finance & HR

Install Research Conventions

skills CLI
$ npx skills add ginlix-ai/LangAlpha --skill research-conventions -a claude-code

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

GitHub CLI
$ gh skill install ginlix-ai/LangAlpha research-conventions --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/ginlix-ai/LangAlpha.git skills-src && mkdir -p .claude/skills && cp -r skills-src/plugins/langalpha_research/skills/research-conventions .claude/skills/research-conventions && 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-conventions
GitHub stars
1.8k
Token cost
~881 tokens
SKILL.md length
468 words
Files
6 (incl. references)
Skills in repo
37
Repo updated
First seen
Licence
Apache-2.0

At a glance

The evidence, judgement, intake and market-data rules every research deliverable follows.

  • Tasks that involve Stock and market analysis
  • SKILL.md covers Reference files and Readiness posture
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md
  • Tasks that involve Essays and academic help

What it does

Research Conventions is an agent skill from ginlix-ai/LangAlpha. The evidence, judgement, intake and market-data rules every research deliverable follows. Read before the first deliverable of a research task; when a number has no source; when two sources disagree; when a figure may be stale; when deciding what to ask the user; before any valuation, thesis or recommendation.

Its SKILL.md is about 880 tokens, which your agent loads only when the skill is triggered. The skill folder holds 6 other files, including reference files (for example `references/depth.md`, `references/evidence.md` and `references/intake.md`).

It sits in Business, Finance & HR, covering Stock and market analysis and Essays and academic help. The repository describes itself as: Claude Code for Financial Market. The licence is Apache-2.0.

When your agent uses it

  • Tasks that involve Stock and market analysis
  • Tasks that involve Essays and academic help

Example prompts

  • “/research-conventions”

What it can do on your machine

Read from SKILL.md and the folder at commit 2855e43. 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 Conventions loads about 881 tokens when it runs, and up to ~9k if it reads all its reference files. Until then it costs about 83 tokens; SKILL.md has 468 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~83
When it runs · the whole SKILL.md, loaded when a task matches
~881
With references · SKILL.md plus every file in references/, read only if the agent opens them
~9k

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 ginlix-ai/LangAlpha at commit 2855e43, republished under its Apache-2.0 licence (© ginlix-ai). 468 words, ~881 tokens.

Download SKILL.mdSave it as .claude/skills/research-conventions/SKILL.md (or your agent's skills folder). This skill also uses 5 other files; get the full folder from GitHub.
name
research-conventions
description
The evidence, judgement, intake and market-data rules every research deliverable follows. Read before the first deliverable of a research task; when a number has no source; when two sources disagree; when a figure may be stale; when deciding what to ask the user; before any valuation, thesis or recommendation.

Research Conventions

The shared layer beneath every skill in this plugin. Each research skill says what to build; this one says what a figure has to carry, how far the evidence lets the language go, what is worth asking before starting, and how periods, windows and returns are computed. It holds those rules so no skill re-derives them: on evidence, judgement, intake and market-data mechanics this layer is the source of truth, and the calling skill owns what its deliverable contains.

Reference files

  • Any deliverable that prints a figure, a number with no source, two sources disagreeing, a figure that may be stale, or how densely to cite: .agents/skills/research-conventions/references/evidence.md.
  • A valuation, a thesis, a recommendation, a scenario set, or any section that ends in what to do: .agents/skills/research-conventions/references/judgment.md.
  • Before asking the user anything at the start of a task, and when deciding whether to ask at all: .agents/skills/research-conventions/references/intake.md.
  • Before the first market-data pull of anything that prints a period label, a multiple, a growth rate or a return: .agents/skills/research-conventions/references/market-data-rules.md.
  • Choosing how long a deliverable runs, a draft over its length band, or a request for a short version of something already built: .agents/skills/research-conventions/references/depth.md.

Readiness posture

Every deliverable states one posture, once, near the top, in the reader's language. Posture is about inputs, not conviction: a high-conviction view resting on stale inputs is not decision-grade, and saying so is what makes the rest of the artifact usable.

PostureHolds whenForced down by
decision-gradeevery load-bearing figure is sourced and inside its freshness threshold, the downside is mechanical, and the inputs the recommended action needs are in handone load-bearing figure that is stale, unsourced or contested
review-readythe analysis is complete and sourced, and one check or one input is still openan unresolved conflict on a load-bearing claim, or a check that fails
screen-gradecoverage or depth is deliberately thin and the artifact says soa headline conclusion that outruns the coverage behind it
not-readya load-bearing claim is unsupported, stale or contested with nothing settling it, and the conclusion rests on italready the floor for a claim problem; state what would lift it
blockedan input cannot be obtained at all (a tool failure, an undisclosed metric, a document we do not have)already the floor; name the missing input and what would unblock it
Show full SKILL.md (80 more words)Show less

A posture below decision-grade names the specific figure or input responsible, so the reader can decide whether it matters to them. Posture is read from this table against the current input state, never stepped up or down from a previous value: when an input changes state, re-read the rows. This is the only readiness scale; a skill that needs a finer status for one of its objects labels that object, and the artifact still carries one posture from this table.

© ginlix-ai, 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

SKILL.md and 5 other files (references) in plugins/langalpha_research/skills/research-conventions of ginlix-ai/LangAlpha.

  • SKILL.md
  • references/depth.md
  • references/evidence.md
  • references/intake.md
  • references/judgment.md
  • references/market-data-rules.md

Open the folder on GitHubat commit 2855e43

Compare with similar skills

Research Conventions 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 Conventions compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Research Conventions this skillginlix-ai/LangAlpha1.8k—~881Automated safety check: PassApache-2.0
Earnings AnalysisWind-Alice/AliceMarket1343 repos~2.2kAutomated safety check: PassNone
Equity Research Corebyteseek/Mira275—~1.9kAutomated safety check: PassApache-2.0
Xvary Stock Researchsickn33/agentic-awesome-skills47k2 repos~952Automated safety check: PassMIT
Catalyst ConfirmationSuperior-Trade/superior-skills215—~667Automated safety check: PassMIT
Stock AnalysisPatrickSUDO/fadacai-portfolio142—~5.5kAutomated safety check: PassMIT

Similar skills

  • Earnings Analysis

    Wind-Alice/AliceMarket

    Create professional equity research earnings update reports (8-12 pages, 3,000-5,000 words) analyzing quarterly results for companies already under coverage.

    134 GitHub starsUsed in 3 repos~2.2k tokens
    Business, Finance & HRAuto-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
    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
  • Catalyst Confirmation

    Superior-Trade/superior-skills

    A skill your agent uses when a Polymarket prediction-market thesis rests on an external event — CPI, Fed, elections, court rulings, ETF decisions — and needs market confirmation before committing.

    215 GitHub stars~667 tokensUpdated 1 mo ago
    Business, Finance & HRAuto-check passed
  • Stock Analysis

    PatrickSUDO/fadacai-portfolio

    Analyze a stock ticker with fundamentals, technicals, analyst ratings, and investment thesis.

    142 GitHub stars~5.5k tokensUpdated 2 days ago
    Business, Finance & HRAuto-check passed
  • Investor Call Prep

    gooseworks-ai/goose-skills

    Prepare for investor calls by pulling upcoming meetings from Google Calendar, deeply researching each investor and their firm (website scraping, portfolio analysis, thesis extraction), checking for…

    1.2k GitHub starsUsed in 1 repo~3.8k tokens
    Business, Finance & HRAuto-check passed

More from ginlix-ai/LangAlpha

All 37 skills in this repo
  • Investment Deck Check

    ginlix-ai/LangAlpha

    Quality-checks an investment deck in .pptx form before it goes out: number consistency, chart and narrative alignment, source coverage, language and a circulation verdict.

    1.8k GitHub stars~3.7k tokensUpdated today
    Auto-check passed
  • Equity Initiation Report

    ginlix-ai/LangAlpha

    Produces a first-time equity research initiation report in five tasks: company research, financial model, valuation, charts and a DOCX report.

    1.8k GitHub stars~3.8k tokensUpdated today
    Auto-check passed
  • Builds or repairs an integrated income statement, balance sheet and cash flow model in Excel with live formulas, supporting schedules, scenarios and a Checks sheet.

    1.8k GitHub stars~5.4k tokensUpdated today
    Auto-check passed
  • Financial Model Checker

    ginlix-ai/LangAlpha

    Audits an existing Excel financial model without editing it, checking structure, formulas, integrity identities and source tie-out, and ends in a prioritized issue log.

    1.8k GitHub stars~4.2k tokensUpdated today
    Auto-check passed
  • DCF Model Builder

    ginlix-ai/LangAlpha

    Builds a live Excel DCF valuation workbook with free cash flow projections, WACC, terminal value, three scenarios, sensitivity grids and a reverse DCF.

    1.8k GitHub stars~7.7k tokensUpdated today
    Auto-check passed
  • Builds Word files with python-docx, edits existing ones in place with tracked changes and comments, then renders and validates the result.

    1.8k GitHub stars~4.8k tokensUpdated today
    Auto-check passed

Questions about Research Conventions

What does Research Conventions do?

The evidence, judgement, intake and market-data rules every research deliverable follows. Research Conventions is an agent skill from ginlix-ai/LangAlpha. The evidence, judgement, intake and market-data rules every research deliverable follows.

When should I use Research Conventions?

Research Conventions fits situations like: tasks that involve Stock and market analysis; tasks that involve Essays and academic help.

How do I install Research Conventions in Claude Code?

Run `npx skills add ginlix-ai/LangAlpha --skill research-conventions -a claude-code`. Or copy the skill folder (plugins/langalpha_research/skills/research-conventions in ginlix-ai/LangAlpha) into .claude/skills/research-conventions in your project. Claude Code loads it when a task matches its description.

How do I install Research Conventions in Codex?

Run `npx skills add ginlix-ai/LangAlpha --skill research-conventions -a codex`. Or copy the skill folder (plugins/langalpha_research/skills/research-conventions in ginlix-ai/LangAlpha) into .agents/skills/research-conventions in your project. Codex loads it when a task matches its description.

Can I use Research Conventions 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 ginlix-ai/LangAlpha --skill research-conventions -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-conventions, .gemini/skills/research-conventions, .github/skills/research-conventions and .opencode/skills/research-conventions in your project.

What does Research Conventions need to run?

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

Does Research Conventions 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 Conventions 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 Conventions use?

Research Conventions 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 Conventions use?

About 881 tokens (SKILL.md is roughly 3.5k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 8.1k tokens, read only when the agent opens those files.

What are the alternatives to Research Conventions?

Skills that share tags, products or a category with Research Conventions: Earnings Analysis (Wind-Alice/AliceMarket, 134 stars), Equity Research Core (byteseek/Mira, 275 stars), Xvary Stock Research (sickn33/agentic-awesome-skills, 47k stars) and Catalyst Confirmation (Superior-Trade/superior-skills, 215 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Research Conventions?

ginlix-ai (a GitHub organization) maintains it in ginlix-ai/LangAlpha, which has 1,811 GitHub stars. The repository holds 37 skills in this directory. The repository was last updated on October 10, 2026.

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