# Research Conventions

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

- Repository: https://github.com/ginlix-ai/LangAlpha (2232 stars)
- Category: Writing
- License: Apache-2.0
- Last updated: 2026-11-01
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add ginlix-ai/LangAlpha --skill research-conventions -g -a claude-code -y`
Codex: `npx skills add ginlix-ai/LangAlpha --skill research-conventions -g -a codex -y`
Cursor: `npx skills add ginlix-ai/LangAlpha --skill research-conventions -g -a cursor -y`
Gemini CLI: `npx skills add ginlix-ai/LangAlpha --skill research-conventions -g -a gemini-cli -y`

## 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.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# 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.

The rest: https://github.com/ginlix-ai/LangAlpha/blob/HEAD/plugins/langalpha_research/skills/research-conventions/SKILL.md