# Load Orca CLI Guidance for Your Workspace

Using the wrong Orca executable can target another build or launch an unrelated program. This skill selects the session executable and retrieves its version-matched guide.

## Install

```bash
npx skillstore add agc2020/orca-cli
```

## Metadata

- Status: approved
- Slug: agc2020-orca-cli
- Skillstore revision: r1
- Version status: missing
- Tree hash: 063eb7e73b668c4b8b92853d38e9fda92888945bcea8563fefe567dc93169742
- Author: agc2020
- GitHub username: agc2020
- License: MIT
- Repository: https://github.com/agc2020/orca/tree/5e9489c0c01f263c1fb57f73c52d21988ee7dcdd/skills/orca-cli
- Ref: ffae4ad95b0b2593c17cd4c3bbe46f81c29019c2
- Supported tools: Claude, Codex, Claude Code
- Audit status: complete
- Agent install advisory: allowed
- Manual install advisory: allowed
- Artifact signature: available
- Audit attestation: unavailable
- Human verification: not\_verified
- Risk factors: external\_commands
- Quality score: 70
- Public page: https://skillstore.pages.dev/skills/agc2020-orca-cli
- Manifest: https://skillstore.pages.dev/api/skills/agc2020-orca-cli/manifest

## Capabilities

- Provides executable-selection rules for managed sessions, development checkouts, and Linux terminals.
- Documents retrieving the version-matched orca-cli guide from the selected executable.
- Warns against accidentally launching the GNOME Orca screen reader on Linux.
- Directs agents to reuse one executable and stop if it cannot run.
- Recommends JSON output and CLI help for discovering supported commands.
- Provides startup and outdated-command recovery guidance.

## Use Cases

- Prepare a Development Session: Select the correct Orca executable and load its guide before managing worktrees.
- Prepare an Agent Handoff: Retrieve current CLI guidance before coordinating another agent through Orca-managed terminals.
- Diagnose CLI Availability: Identify executable errors, missing guide support, or runtime access restrictions without guessing unsupported commands.

## Prompt Templates

### Find the Session Executable

```
Determine the Orca executable for this session using the skill rules. Explain your selection without changing workspace state.
```

### Load Current Guidance

```
Resolve the Orca executable and retrieve its orca-cli guide. Summarize available operations without executing workspace changes.
```

### Diagnose a Guide Error

```
Investigate why the Orca guide cannot load. Report the exact error and use read-only help where supported. Do not escalate without approval.
```

### Plan a Worktree Handoff

```
Load the matching Orca guide and plan a child-worktree handoff to another agent. Confirm supported commands and request approval before state changes.
```

## Limitations

- Requires an available Orca executable; the skill does not install Orca.
- Detailed workspace operations depend on a runtime-loaded guide that is not included in this package.
- The stub does not document specific worktree, browser, artifact, or terminal operation flags.
- Sandbox access may require explicit approval; this skill cannot authorize permission escalation.

## Best Practices

- Resolve the executable once and reuse it throughout the session.
- Load the matching guide before workspace operations and prefer JSON output.
- Respect sandbox restrictions and obtain required approval before requesting additional access.

## Anti Patterns

- Running bare orca on Linux outside a managed terminal without checking executable-selection rules.
- Switching to a different Orca executable after the selected one fails.
- Guessing unsupported commands or treating sandbox denial as automatic permission to escalate.

## Security Audit

- Audited at: 2026-10-13T15:35:16.174\+00:00
- Summary: All 18 static findings are false positives caused by Markdown formatting and references to shell names. A separate semantic concern is unconditional permission escalation after sandbox denial. No evidence found of credential theft, exfiltration, or audit manipulation in the reviewed stub; the runtime-loaded guide was unavailable for review.

## Stats

- Views: 0
- Downloads: 0
- Favorites: 0
- Popularity score: 0