Skip to content

README: unclear distinction between CLI commands and in-session skills #2198

@pgagarinov

Description

@pgagarinov

Problem

The README conflates two different invocation methods without making the distinction clear:

1. CLI commands vs in-session skills

The README shows:

autopilot: build a REST API for managing tasks

This looks like a CLI command (omc autopilot ...) but it's actually an in-session skill invoked as /autopilot inside a Claude session. The README should clarify both invocation methods where applicable:

  • omc autopilot "..." (CLI, outside a session)
  • /autopilot "..." (inside a Claude/omc session)

2. Undocumented autoresearch command

omc autoresearch exists as a CLI command but is not mentioned in the README at all.

3. General confusion

A reader can't tell from the README which features are:

  • CLI commands — run directly from the terminal (omc setup, omc team, omc autoresearch)
  • In-session skills — invoked inside a Claude session (/autopilot, /ralph, /ultrawork)
  • Both — available as CLI command AND in-session skill

Suggested fix

Add a clear section or table distinguishing CLI commands from in-session skills. Where a feature supports both invocation methods, show both:

# As a CLI command:
omc autopilot "build a REST API for managing tasks"

# Inside a Claude/omc session:
/autopilot build a REST API for managing tasks

Metadata

Metadata

Assignees

No one assigned

    Labels

    agentsRelated to agent definitionsdocumentationImprovements or additions to documentation

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions