pbakaus/impeccable · info

Run 'impeccable --help' for available commands.

Error message

Run 'impeccable --help' for available commands.

What it means

Catch-all arm of the skills subcommand dispatcher in run: the first positional argument matched no known subcommand (install, link, update, check, help). It is printed right after the 'Unknown skills command' line as a hint pointing at the top-level help.

Source

Thrown at crates/skills/src/commands.rs:60

pub fn run(args: &[String], io: &mut Io) -> R<()> {
    let sub = args.first().map(String::as_str).unwrap_or("");
    let rest: Vec<String> = args.iter().skip(1).cloned().collect();
    if let Some(help) = subcommand_help(sub) {
        if rest.iter().any(|a| a == "--help" || a == "-h") {
            out(io, help);
            return Ok(());
        }
    }
    match sub {
        "" | "help" | "--help" | "-h" => show_help(io),
        "install" => install(&rest, io),
        "link" => link(&rest, io),
        "update" => update(&rest, io),
        "check" => check(io),
        other => {
            io.err(&format!("Unknown skills command: {other}\n"));
            io.err("Run 'impeccable --help' for available commands.\n");
            Err(Flow::Exit(1))
        }
    }
}

fn ctx(io: &Io) -> (Sys, Prompt) {
    let sys = Sys::new(io.env.clone(), io.cwd.to_string_lossy().into_owned());
    let prompt = Prompt::new(io);
    (sys, prompt)
}

fn has_flag(flags: &[String], name: &str) -> bool {
    flags.iter().any(|f| f == name)
}

fn out(io: &mut Io, line: &str) {
    io.out(&format!("{line}\n"));
}

View on GitHub (pinned to 2bc2879276)

Solutions

  1. Run `impeccable --help` as the message suggests.
  2. Use one of the supported verbs: install, link, update, check, help.
Defensive patterns

Strategy: validation

Prevention

When it happens

Trigger: Emitted together with the unknown-command message whenever the skills dispatcher's catch-all arm runs.

Common situations: Same as the unknown-command error: typos, remembered-but-nonexistent verbs, renamed subcommands.

Related errors


AI-assisted analysis of pbakaus/impeccable@2bc2879276 (2026-09-08). Data as JSON: /api/errors/48e77b03dda9bfe1. Report an issue: GitHub.