Skip to content
For the complete documentation index, see llms.txt. This page is also available as Markdown.

currents skill

Install the currents-cli agent skill, which tells coding agents such as Claude Code, Codex and Cursor how to use the currents command

currents skill prints or installs the currents-cli agent skill. The skill tells a coding agent which currents command fits a task, which key each command needs, and how to add the commands to GitHub Actions and GitLab CI. Its content matches the version of @currents/cmd that prints it.

Install the skill in a project

npx --package @currents/cmd@2 currents skill --install

The command writes the skill folder to .agents/skills/currents-cli. Agents read project skills from these folders:

Agent
Folder

Codex, Cursor

.agents/skills

Claude Code

.claude/skills

For Claude Code, install the skill to .claude/skills:

npx --package @currents/cmd@2 currents skill --install --dir .claude/skills

Commit the skill folder so that every agent working in the repository reads it.

What the skill contains

  • SKILL.md: which command to use for a task, the keys and environment variables of each command, exit codes, and safety rules, such as never printing a key

  • references/ci-setup.md: GitHub Actions and GitLab CI steps for run upload, run attach, run cancel and rerunning failed tests with cache

  • references/sessions.md: how to record a session, attach files to it and share it

npx --package @currents/cmd@2 currents skill without options prints SKILL.md only. Install the skill to get the reference files too.

Options

Option
Description

--install

Write the skill folder to <dir>/currents-cli.

--dir <path>

The skills folder to install to. Default: .agents/skills.

--force

Replace an installed copy of the skill that differs from this version.

Without --force, --install fails when an installed copy differs from this version, and leaves it in place. After you upgrade @currents/cmd, run npx --package @currents/cmd@2 currents skill --install --force to update the skill.

Last updated

Was this helpful?