Supercli Mastery

Master the supercli capability router. Covers the full agent workflow — discover plugins, inspect commands, preview with plan, execute safely, use skills, interpret output and exit codes.

57 stars 5 forksProductivity & Notes

Install

skills CLI (Claude Code, Cursor, Codex and more)
npx skills add javimosch/supercli --skill supercli-mastery
Manual install
git clone --depth 1 https://github.com/javimosch/supercli.git /tmp/supercli
mkdir -p ~/.claude/skills
cp -r /tmp/supercli/.agents/skills/supercli-mastery ~/.claude/skills/supercli-mastery

Personal skills live in ~/.claude/skills. Use .claude/skills in a project folder to share a skill with your team.

From the SKILL.md

# supercli-mastery — Agent's Guide to SuperCLI

## What SuperCLI Is

SuperCLI is a **capability router**. It wraps external CLIs (plugins) behind a uniform `namespace.resource.action` command model. Every command follows the same pattern:

```
sc <namespace> <resource> <action> --<arg> <value> --json
```

The workflow is: `discover → learn → inspect → plan → execute`

## Core Capabilities

| Capability | Description |
|---|---|
| `commands` | Query available commands |
| `plugins` | Plugin management and discovery |
| `skills` | Agent-facing skill documents |
| `inspect` | View command schema |
| `plan` | Preview execution steps before running |
| `ask` | LLM suggests which commands to run (no execution) |
| `mcp` | Model Context Protocol adapter |

## Output Conventions

All commands return JSON when `--json` is used (or by default in non-TTY):

```
sc <ns> <res> <act> --json
→ { "version": "1.0", "command": "ns.res.act", "data": {...} }
```

- **stdout**: Primary data (JSON envelope)
- **stderr**: Progress events, warnings, structured errors
- **Exit code 0**: Success

## Semantic Exit Codes

| Code | Meaning | Agent action |
|---|---|---|
| 0 | Success | Proceed |
| 82 | Validation error | Fix input arguments |
| 85 | Invalid argument | Fix the args, don't retry |
| 91 | Safety violation | Non-TTY interactive command blocked |
| 92 | Resource not found | Use different ID/name |
| 105 | Integration / API error | Retry with backoff (transient) |
Read the full skill on GitHub

Details

Skill name
supercli-mastery
Path
.agents/skills/supercli-mastery/SKILL.md
License
MIT
Repo updated
2 November 2026

FAQ

What does the Supercli Mastery skill do?

Master the supercli capability router. Covers the full agent workflow — discover plugins, inspect commands, preview with plan, execute safely, use skills, interpret output and exit codes.

How do I install the Supercli Mastery skill?

skills CLI (Claude Code, Cursor, Codex and more): npx skills add javimosch/supercli --skill supercli-mastery. Skills go in ~/.claude/skills (personal) or .claude/skills (project), and Claude loads them automatically when a task matches the description.

Is Supercli Mastery popular?

It lives in javimosch/supercli, which has 57 GitHub stars and 5 forks, and is included in 1 curated skill list.

Related skills

Browse the most popular Claude skills, all productivity & notes skills, or write your own with the skills generator.