Kairos agent skill

Teach Claude Code, Codex, and other skill-aware coding agents to integrate Kairos through the Minara Cloud System One API. Includes typed question design, request and response contracts, image limits, error handling, and the strict news_return template workflow.

Install

Choose one installation method to avoid duplicate copies. The commands below install from the default branch.

Claude Code

Run these two commands in your terminal:

claude plugin marketplace add DMindAI/kairos-skill
claude plugin install kairos@dmind-ai

Invoke /kairos:kairos in Claude Code, or ask it to “use the Kairos skill”.

Codex and other agents

Run the skills installer and choose your agent when prompted:

npx skills add DMindAI/kairos-skill --skill kairos

Installation is project-local by default; add -g for a global installation. This command uses the skills installer from npm to install Kairos from GitHub; there is no separate Kairos npm package to install.

Manual installation

Copy the entire skills/kairos directory into your agent's skill directory, including references/, assets/, scripts/, and version.json. For example, use .claude/skills/kairos for a project-local Claude Code installation or ~/.codex/skills/kairos for a personal Codex installation. Read SKILL.md directly to inspect the instructions before installing.

Update

For the Claude Code plugin:

claude plugin marketplace update dmind-ai
claude plugin update kairos@dmind-ai

Restart Claude Code or run /reload-plugins to load the update. For skills CLI installations, update Kairos in its existing scope using npx skills update kairos. For manual installations, replace the complete skill directory. Releases must keep .claude-plugin/plugin.json and skills/kairos/version.json at the same incremented version.

Starting with 0.1.5, each skill invocation checks API key presence locally. Remote update checks are limited to once per 24 hours, including failed attempts. An explicit update request can force a fresh check. When a newer release is detected on main, the agent offers a yes/no update prompt. Choosing yes authorizes the agent to perform that update with the existing installer and scope, then verify the installed version. Choosing no keeps the current version. Routine checks, skipped checks, and automatic check failures stay silent. A declined update is not offered again within the 24-hour window. This is an agent-executed workflow, not a background auto-updater; older installations need one manual update to gain it.

Configure

• KAIROS_API_KEY: your Minara Cloud API key, required only for live API calls. Keep it in your server environment or secret manager.
• KAIROS_BASE_URL: optional gateway origin, defaults to https://minara.cloud. Exclude /v1 and the endpoint path.
• Model: use DMIND/Kairos exactly. Model-list discovery is not required.
• API key group: use a key assigned to a Kairos-enabled group. A key in default is not guaranteed to have access to DMIND/Kairos; also check key-level model restrictions.

The public endpoint is POST /v1/systemone, non-streaming. Installing this skill does not initiate API calls or configure credentials. Planning and code generation do not require a key. For live calls, supply the key through the environment inherited by the agent or backend; do not paste it into chat or store it in this repository.

At invocation, the skill checks for the exact variable KAIROS_API_KEY without revealing its value. If missing, it directs you to Minara Cloud to create an API key in the Kairos group, then export it in the terminal used to launch your agent:

export KAIROS_API_KEY="<your Kairos-group API key>"

Restart the agent from that terminal so it inherits the variable. An export in another shell does not update a running process. Other providers' API key variables are not substitutes. See setup checks for the full flow.

Use

Ask your agent:

Use the Kairos skill to add structured intent routing to this application. Keep routing rules in code and handle unsupported requests explicitly.

Use the Kairos skill to integrate news_return with a caller-selected 1h horizon. Load the fixed template bundled with the skill and return the full gross-return distribution.

Use the Kairos skill to review our System One requests, error handling, and question design.

The news_return profile supports 15m, 1h, and 4h. Load skills/kairos/assets/news-return.json locally, preserve its question and candidate IDs and derive interval descriptions using the documented field relationship, and supply the actual required state fields. It predicts a gross-return distribution, not a trade action. See the news reference for fixed fields and input requirements.

Troubleshooting

• No access to DMIND/Kairos: check whether the API key belongs to a Kairos-enabled group and permits that model. Do not assume the account's default group provides access.

See error handling for response formats and bounded retries. Documentation is in English; original template state values that require non-English text are represented with JSON Unicode escapes without changing their decoded values.

Contents

• Skill instructions
• Version checks, automatic update consent, and API key setup
• API contract and curl example
• Workflow recipes
• News trading workflows
• Fixed news workflow
• Bundled fixed news template

The contract snapshot is based on Minara gateway documentation and request validation as of 2026-11-04. The news template was supplied by the project owner. Live endpoint behavior, account permissions, latency, and predictive performance have not been verified by this repository's initial documentation validation.

Use general for custom long/short/skip, factual judgments, or model-selected holding periods. For news_return, use the bundled fixed JSON. /v1/news/templates is not exposed to users and must not be called.

License

MIT.