orca-skills
Deterministic, AI-driven development flows.
Safety scan
A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.
Check it deeper on your machine
It has changed since its scan on 11 Nov 2026.
As a Claude Code plugin, install it and then ask Claude Code:
/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/VirtusLab/orca with scanskillsafety
Or from a terminal, clone it and run it:
git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/VirtusLab/orca'
It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.
Badge for your README
Markdown
[](/listings/virtuslab--orca)HTML
<a href="/listings/virtuslab--orca"><img src="/api/listings/virtuslab--orca/badge.svg" alt="findsafeskills safety rating" /></a>Install
Install instructions from the README
As written by the repo's author. findsafeskills has not verified these steps.
These steps run a script from the network that findsafeskills does not scan.
The below installs `scala-cli` (via its official installer) if you don't have it already, and writes the `orca` executable to `~/.local/bin/orca`:
curl -fsSL https://raw.githubusercontent.com/VirtusLab/orca/master/install.sh | bash
To let a coding agent delegate work to Orca, install the `orca` skill. In Claude Code:
/plugin marketplace add VirtusLab/orca /plugin install orca@orca-skills
In Pi: `pi install git:github.com/VirtusLab/orca`. For OpenCode, Codex and per-project installs, see [`skills/orca/README.md`](skills/orca/README.md).
What was scanned
The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.
.claude-plugin/marketplace.json · Manifest · 14 lines
View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)
- {
- "name": "orca-skills",
- "owner": {
- "name": "VirtusLab",
- "url": "https://github.com/VirtusLab/orca"
- },
- "plugins": [
- {
- "name": "orca",
- "source": "./skills/orca",
- "description": "Delegate a well-defined implementation task to Orca's autonomous plan-code-review flow."
- }
- ]
- }
README.md · README · 147 lines · 1 finding marked
View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)
- # Orca
- Deterministic, AI-driven development flows.
- Orca allows you to programmatically define software development workflows where
- AI agents perform the coding. If you want AI-generated code to always be
- reviewed by another agent, don't try to coerce the agents; just express that
- requirement in code. Don't waste tokens on formatting, committing, or creating
- PRs - all of this can be handled by an ordinary script.
- Orca comes with an `orca` cli and a skill, which can be used interactively by
- humans, or headlessly by humans and agents alike. A number of built-in flows,
- implementing e.g. a plan-implement-review loop, allow you to start using Orca
- right away.
- Orca flow scripts are written in Scala, and can be run with a single command
- through [scala-cli](https://scala-cli.virtuslab.org), which is installed by the
- `orca` installer. No other dependencies are needed - everything is automatically
- bootstrapped. Scala 3 looks like Python, but with types - so you get quick
- feedback if your flow script has any problems.
- Orca's development flows are resumable, so that if work is interrupted mid-flow
- for any reason, it can be continued from the last commit.
- You can use Orca to orchestrate development in any language and ecosystem.
- Orca assumes that it has configured, logged-in access to Claude, Codex,
- OpenCode, Pi or Gemini (depending which backend you use), as well as `gh` and
- `git`.
- > [!NOTE]
- > Orca is designed to be run as part of a single-developer workflow. For a
- > platform designed for teams, see
- > [Visdom](https://virtuslab.com/services/visdom): VirtusLab's AI-native SDLC
- > platform.
- ## Documentation
- Is available here: [orca.virtuslab.com](https://orca.virtuslab.com)
- ## Install
- The below installs `scala-cli` (via its official installer) if you don't have
- it already, and writes the `orca` executable to `~/.local/bin/orca`:
- ```bash
- curl -fsSL https://raw.githubusercontent.com/VirtusLab/orca/master/install.sh | bash
- Note: Pipes a downloaded script directly into a shell (curl | sh / wget | bash)
- Line 47 on GitHub
- ```
- To let a coding agent delegate work to Orca, install the `orca` skill. In
- Claude Code:
- ```text
- /plugin marketplace add VirtusLab/orca
- /plugin install orca@orca-skills
- ```
- In Pi: `pi install git:github.com/VirtusLab/orca`. For OpenCode, Codex and
- per-project installs, see [`skills/orca/README.md`](skills/orca/README.md).
- ## Start using
- Run `orca` in your repository. The first run asks which agent and model to use
- for planning, coding and review. Then pick a flow (`implement.sc` comes first)
- and enter your prompt.
- The same can be run non-interactively:
- ```bash
- orca run implement.sc "add a rate limiter to /login"
- ```
- Orca creates a feature branch, plans the change into tasks, implements and
- reviews each one, reviews the whole change, and opens a PR when the repository
- is on GitHub. Each stage is committed as it finishes; if the run is interrupted,
- run the same command again and it will continue from the last commit.
- A flow is a scala-cli script, so it also runs with no install:
- ```bash
- scala-cli run --workspace "$(mktemp -d)" implement.sc -- "add a rate limiter to /login"
- ```
- > [!WARNING]
- > **Orca should be used in a sandboxed environment!** Coding agent tool usage is
- > auto-approved by default: write-capable turns let the agent edit files and run
- > shell commands without prompting. Use a VPS or a local sandbox such as
- > [Sandcat](https://github.com/VirtusLab/sandcat) or [Docker
- > Sandboxes](https://docs.docker.com/ai/sandboxes/), or narrow the agents' tools
- > in the flow.
- ## A flow
- Flows are ordinary Scala scripts. For example, the below one plans, implements
- each task with a review, and opens a PR:
- ```scala
- //> using scala 3.9.0
- //> using dep "org.virtuslab::orca:0.2.1"
- //> using jvm 21
- import orca.{*, given}
- flow(OrcaArgs(args)):
- val plan = stage("Plan"):
- Plan.autonomous.from(userPrompt, planningAgent).value
- for task <- plan.tasks do
- stage(s"Task: ${task.title}"):
- val session = codingAgent.session("implementer", seed = plan.brief)
- session.run(task.description)
- reviewThenFix(coderSession = session, reviewers = allReviewers(reviewAgent), task = task)
- val openFindings = stage("Final review"):
- val finalFixer = codingAgent.session("final-fixer", seed = plan.brief)
- reviewAndFixLoop(
- coderSession = finalFixer,
- reviewers = allReviewers(reviewAgent),
- task = Task(Title("The whole planned change"), plan.brief),
- diff = ReviewDiff.WholeRun
- )
- openPrIfGitHub(summarisingAgent = codingAgent, openFindings = openFindings)
- ```
- Each `stage` commits on completion and is skipped on resume. The tutorial at
- [orca.virtuslab.com](https://orca.virtuslab.com) explains every line; the
- shipped flows live in [`flows/`](flows/).
- ## Documentation
- - [orca.virtuslab.com](https://orca.virtuslab.com) — user documentation: usage,
- built-in flows, settings, authoring flows, API reference, glossary. Source in
- [`docs/`](docs/).
- - [`adr/`](adr/) — architecture decision records.
- - [`CONTRIBUTING.md`](CONTRIBUTING.md) — building, testing, and running a
- locally modified orca.
- - [`AGENTS.md`](AGENTS.md) — internals, architecture, and coding conventions;
- the same file AI assistants pick up.
- ## License
- Apache 2.0 — see [LICENSE](LICENSE).
- ## Copyright
- Copyright (C) 2026 VirtusLab [https://virtuslab.com](https://virtuslab.com).
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.