-
-
Notifications
You must be signed in to change notification settings - Fork 2.2k
README: unclear distinction between CLI commands and in-session skills #2198
Copy link
Copy link
Open
Labels
agentsRelated to agent definitionsRelated to agent definitionsdocumentationImprovements or additions to documentationImprovements or additions to documentation
Description
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
Reactions are currently unavailable
Metadata
Metadata
Assignees
Labels
agentsRelated to agent definitionsRelated to agent definitionsdocumentationImprovements or additions to documentationImprovements or additions to documentation