# Super Agent

> Enable when delegating tasks to specialized sub-agents via @kimuson/super-agent CLI

- Skill: `d-kimuson/super-agent` (Agent Skill)
- Install (CLI): `npx skillmds@latest add d-kimuson/super-agent`
- Raw SKILL.md: https://api.skillmd.com/api/skills/d-kimuson/super-agent/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: d-kimuson (https://skillmd.com/u/d-kimuson)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/d-kimuson/super-agent

---


`@kimuson/super-agent` is a tool that invokes AI agents (Claude Code, Codex, etc.) through a unified CLI interface.

## Usage Flow

### 1. List available agents

```bash
npx -y @kimuson/super-agent agent-list
```

Returns all available agent types. Each agent is a pre-configured specialist — specifying `--agent-type` automatically loads an optimized system prompt tailored to the agent's role.

### 2. Run a task

```bash
# Foreground (blocks until complete)
npx -y @kimuson/super-agent agent-task --agent-type <type> "<prompt>"

# Background (non-blocking, returns session ID)
npx -y @kimuson/super-agent agent-task --agent-type <type> --background "<prompt>"
```

Use `--background` for async execution — allows running other tasks while waiting. Retrieve results with `agent-task-output`:

```bash
npx -y @kimuson/super-agent agent-task-output <session-id>
```

### 3. Resume a session

For follow-up requests or questions, resume an existing session:

```bash
npx -y @kimuson/super-agent agent-task-resume <session-id> "<follow-up prompt>"
```

## Rate Limits and Provider Fallback

Each agent type defines preferred providers and models in priority order. The highest-priority model from globally enabled providers is selected automatically.

Since agents are invoked over the network, they may fail due to rate limits or service outages. On failure, temporarily disable the provider with `provider-cooldown` and retry:

```bash
# Example: "claude is rate limited until 3:00 PM"
npx -y @kimuson/super-agent provider-cooldown claude --disabled-until "15:00"
npx -y @kimuson/super-agent agent-task --agent-type <type> "<prompt>"  # retry
```

## Troubleshooting

If unexpected errors occur, the background local server may be running an outdated version. Restart it:

```bash
npx -y @kimuson/super-agent server stop
```