@evatick/skill

EVA Tick Skill for Codex

Teach Codex how to discover financial instruments and query market data through the EVA Tick CLI safely and predictably.

The package installs the EVA Tick Skill and depends on the exact matching version of @evatick/cli, so one npm command installs both the eva command and the Skill installer.

Install

npm install --global @evatick/skill
eva-skill install
eva-skill status

Restart Codex after installing or updating the Skill so it can rediscover the instructions.

Try it in Codex

Ask Codex:

• “搜索平安银行并告诉我它的规范金融标的 ID。”
• “查询平安银行最近三个交易日的前复权日线。”
• “检查 000001 是股票还是指数。”
• “查询沪深 300 的指数成分并导出 CSV。”

The Skill helps Codex select and sequence the appropriate eva commands from a natural-language request.

What the Skill does

The Skill instructs Codex to:

1. Check the locally installed CLI and the configured EVA Tick service.
2. Search or resolve uncertain instrument input before requesting data.
3. Prefer canonical instrument IDs when a name or trading code is ambiguous.
4. Inspect leaf-command help before unfamiliar calls.
5. Parse stdout as one strict JSON value and handle structured errors.
6. Report the requested instrument, period, and known data limitations.

The Skill teaches Codex how to use the CLI; the EVA Tick Server owns provider routing, fallback, retries, normalization, and catalog persistence.

Safety and data boundaries

• Never exposes API keys from environment variables or configuration files.
• Never adds --overwrite without user authorization.
• Does not call upstream data providers directly when EVA Tick fails.
• Does not invent unsupported commands, markets, or asset capabilities.
• Treats market data as research and reference material, not investment advice.

The current public service starts with mainland China A-shares and Chinese indices. Availability depends on the configured service and its enabled providers.

Update

npm update --global @evatick/skill
eva-skill update
eva-skill status

eva-skill update replaces the installed Skill and preserves the previous copy as a recoverable backup. Automated removal of the copied Skill is not currently provided.

The Skill is installed into $CODEX_HOME/skills/eva, or ~/.codex/skills/eva when CODEX_HOME is unset. It does not use npm lifecycle scripts and never silently overwrites an existing Skill.

Documentation

• EVA Tick Skill source
• Complete command guide
• EVA Tick CLI documentation
• EVA Tick Server and OpenAPI