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 --installThe command writes the skill folder to .agents/skills/currents-cli. Agents read project skills from these folders:
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/skillsCommit 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 keyreferences/ci-setup.md: GitHub Actions and GitLab CI steps forrun upload,run attach,run canceland rerunning failed tests withcachereferences/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
--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?