Agent skill

Duel Agents

by 2aronS in 2aronS/Duel-Agents

Configure and use Duel Agents model routing in Claude Code. An agent skill from 2aronS/Duel-Agents.

MITAuto-check: notesAI & LLM Engineering

Install Duel Agents

skills CLI
$ npx skills add 2aronS/Duel-Agents --skill duel-agents -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install 2aronS/Duel-Agents duel-agents --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/2aronS/Duel-Agents.git skills-src && mkdir -p .claude/skills && cp -r skills-src/integrations/claude-plugin/skills/duel-agents .claude/skills/duel-agents && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
duel-agents
GitHub stars
745
Token cost
~298 tokens
SKILL.md length
80 words
Files
1
Skills in repo
3
Repo updated
First seen
Licence
MIT

At a glance

Configure and use Duel Agents model routing in Claude Code. An agent skill from 2aronS/Duel-Agents.

  • Works in 4 steps: Subscribe and create an API key at… → Run: npx @duel-agents/install claude-code → Or set manually in ~/.claude/.env → …
  • Tasks that involve Model routing and gateways
  • SKILL.md covers Setup, Verify and Build on top
  • Calls npx; reaches duelagents.com; needs ANTHROPIC_API_KEY and DUEL_API_KEY

What it does

Duel Agents is an agent skill from 2aronS/Duel-Agents. Configure and use Duel Agents model routing in Claude Code. Requires a Duel API key from duelagents.com. Routes all LLM traffic through duelagents.com/v1.

Its SKILL.md is about 300 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in AI & LLM Engineering, covering Model routing and gateways. It works with OpenAI, npm and TypeScript. The repository describes itself as: CLI, SDK, and IDE plugins for Duel Agents. The licence is MIT.

When your agent uses it

  • Tasks that involve Model routing and gateways

Example prompts

  • “/duel-agents”

Requirements

  • Node.js
  • A credential in ANTHROPIC_API_KEY
  • A credential in DUEL_API_KEY

Workflow steps

4 steps, taken from the first numbered list in SKILL.md.

  1. Subscribe and create an API key at https://duelagents.com/dashboard/settings
  2. Run: npx @duel-agents/install claude-code
  3. Or set manually in ~/.claude/.env
  4. Restart Claude Code

What it can do on your machine

Read from SKILL.md and the folder at commit c9559e4. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • npx

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Hosts in commands or code, which the agent is likely to contact:

    • duelagents.com

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names these keys or tokens, usually read from environment variables:

    • ANTHROPIC_API_KEY
    • DUEL_API_KEY

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Duel Agents loads about 298 tokens when it runs. Until then it costs about 42 tokens; SKILL.md has 80 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~42
When it runs · the whole SKILL.md, loaded when a task matches
~298

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check: notes

The automated check noted patterns worth knowing about, such as sudo or a known installer.

  • NoteMentions a .env fileSKILL.md:16
    3. Or set manually in `~/.claude/.env`:

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from 2aronS/Duel-Agents at commit c9559e4, republished under its MIT licence (© 2aronS). 80 words, ~298 tokens.

Download SKILL.mdSave it as .claude/skills/duel-agents/SKILL.md (or your agent's skills folder).
name
duel-agents
description
Configure and use Duel Agents model routing in Claude Code. Requires a Duel API key from duelagents.com. Routes all LLM traffic through duelagents.com/v1.

Duel Agents

Duel Agents runs your prompts against multiple models and picks the cheapest answer that still passes quality checks. Every request must use your Duel API key. Never substitute a direct Anthropic or OpenAI key.

Setup

  1. Subscribe and create an API key at https://duelagents.com/dashboard/settings
  2. Run: npx @duel-agents/install claude-code
  3. Or set manually in ~/.claude/.env:
bash
ANTHROPIC_BASE_URL=https://duelagents.com/v1
ANTHROPIC_API_KEY=duel_yourprefix_yoursecret
  1. Restart Claude Code

Verify

bash
npx @duel-agents/install doctor

Build on top

Use @duel-agents/sdk in your own tools. Always pass apiKey from your Duel dashboard.

ts
import { DuelClient } from "@duel-agents/sdk";

const duel = new DuelClient({ apiKey: process.env.DUEL_API_KEY! });
await duel.chat.completions.create({
  model: "duel-auto",
  messages: [{ role: "user", content: "Hello" }],
});

Repository: https://github.com/2aronS/Duel-Agents

© 2aronS, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in integrations/claude-plugin/skills/duel-agents of 2aronS/Duel-Agents.

Open the folder on GitHubat commit c9559e4

Compare with similar skills

Duel Agents next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Duel Agents compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Duel Agents this skill2aronS/Duel-Agents745—~298Automated safety check: NotesMIT
Openrouter Hello Worldjeremylongshore/tons-of-skills-marketplace2.8k—~1.8kAutomated safety check: PassMIT
Openrouter SDK Patternsjeremylongshore/tons-of-skills-marketplace2.8k—~2.9kAutomated safety check: PassMIT
Page AgentTommy-yw/RunbookHermes5463 repos~2.3kAutomated safety check: NotesMIT
9Router AI Gateway Setupdecolua/9router30k—~744Automated safety check: PassMIT
Trigger.dev Agent Patternspapermark/papermark9.2k—~2kAutomated safety check: PassCustom licence

Similar skills

  • Openrouter Hello World

    jeremylongshore/tons-of-skills-marketplace

    Send your first OpenRouter API request and understand the response.

    2.8k GitHub stars~1.8k tokensUpdated today
    AI & LLM EngineeringAuto-check passed
  • Openrouter SDK Patterns

    jeremylongshore/tons-of-skills-marketplace

    Build reusable OpenRouter client wrappers with retries, typing, and middleware.

    2.8k GitHub stars~2.9k tokensUpdated today
    AI & LLM EngineeringAuto-check passed
  • Page Agent

    Tommy-yw/RunbookHermes

    Embed alibaba/page-agent into your own web application — a pure-JavaScript in-page GUI agent that ships as a single <script tag or npm package and lets end-users of your site drive the UI with…

    546 GitHub starsUsed in 3 repos~2.3k tokens
    Productivity & AutomationAuto-check: notes
  • Sets up access to the 9Router AI gateway, an OpenAI-compatible REST endpoint for chat, images, speech, embeddings, web search and web fetch, and indexes its capability skills.

    30k GitHub stars~744 tokensUpdated 7 days ago
    AI & LLM EngineeringAuto-check passed
  • Trigger.dev Agent Patterns

    papermark/papermark

    Patterns for building LLM agents on Trigger.dev tasks: prompt chaining, routing, parallel workers, orchestrator-workers, evaluator loops and human approval gates.

    9.2k GitHub stars~2k tokensUpdated 1 mo ago
    AI & LLM EngineeringAuto-check passed
  • Sends chat and code-generation requests through a 9Router gateway using OpenAI or Anthropic message formats, with streaming and auto-fallback combos.

    30k GitHub stars~635 tokensUpdated 7 days ago
    AI & LLM EngineeringAuto-check passed

More from 2aronS/Duel-Agents

  • Duel Agents

    2aronS/Duel-Agents

    Use Duel Agents model routing in Cursor. An agent skill from 2aronS/Duel-Agents.

    745 GitHub stars~228 tokensUpdated 3 mo ago
    Auto-check passed
  • Duel Agents

    2aronS/Duel-Agents

    OpenClaw integration for Duel Agents routing. An agent skill from 2aronS/Duel-Agents.

    745 GitHub stars~217 tokensUpdated 3 mo ago
    Auto-check: notes

Questions about Duel Agents

What does Duel Agents do?

Configure and use Duel Agents model routing in Claude Code. An agent skill from 2aronS/Duel-Agents. Duel Agents is an agent skill from 2aronS/Duel-Agents. Configure and use Duel Agents model routing in Claude Code.

When should I use Duel Agents?

Duel Agents fits situations like: tasks that involve Model routing and gateways.

How do I install Duel Agents in Claude Code?

Run `npx skills add 2aronS/Duel-Agents --skill duel-agents -a claude-code`. Or copy the skill folder (integrations/claude-plugin/skills/duel-agents in 2aronS/Duel-Agents) into .claude/skills/duel-agents in your project. Claude Code loads it when a task matches its description.

How do I install Duel Agents in Codex?

Run `npx skills add 2aronS/Duel-Agents --skill duel-agents -a codex`. Or copy the skill folder (integrations/claude-plugin/skills/duel-agents in 2aronS/Duel-Agents) into .agents/skills/duel-agents in your project. Codex loads it when a task matches its description.

Can I use Duel Agents in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add 2aronS/Duel-Agents --skill duel-agents -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/duel-agents, .gemini/skills/duel-agents, .github/skills/duel-agents and .opencode/skills/duel-agents in your project.

What does Duel Agents need to run?

Going by SKILL.md and its folder, Duel Agents needs the command-line tools its instructions call (npx) and credentials named ANTHROPIC_API_KEY and DUEL_API_KEY. Our summary lists: Node.js; A credential in ANTHROPIC_API_KEY; A credential in DUEL_API_KEY.

Does Duel Agents access the network?

SKILL.md names 1 domain. In commands or code: duelagents.com; the agent is likely to contact it when it follows the instructions. This is read from the text; nothing was executed.

Is Duel Agents safe to install?

Our automated static check of SKILL.md found notes only (mentions a .env file), nothing it rates as a warning. It is not a guarantee. Review the folder before installing.

What licence does Duel Agents use?

Duel Agents is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Duel Agents use?

About 298 tokens (SKILL.md is roughly 1.2k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Duel Agents?

Skills that share tags, products or a category with Duel Agents: Openrouter Hello World (jeremylongshore/tons-of-skills-marketplace, 2.8k stars), Openrouter SDK Patterns (jeremylongshore/tons-of-skills-marketplace, 2.8k stars), Page Agent (Tommy-yw/RunbookHermes, 546 stars) and 9Router AI Gateway Setup (decolua/9router, 30k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Duel Agents?

2aronS (a GitHub user) maintains it in 2aronS/Duel-Agents, which has 745 GitHub stars. The repository holds 3 skills in this directory. The repository was last updated on June 29, 2026.

Source: 2aronS/Duel-Agents on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.