Skip to content
Back to search

orca-skills

MarketplaceWorks with Claude CodeGitHub

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.

Checked today

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
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/virtuslab--orca/badge.svg)](/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)

  1. {
  2. "name": "orca-skills",
  3. "owner": {
  4. "name": "VirtusLab",
  5. "url": "https://github.com/VirtusLab/orca"
  6. },
  7. "plugins": [
  8. {
  9. "name": "orca",
  10. "source": "./skills/orca",
  11. "description": "Delegate a well-defined implementation task to Orca's autonomous plan-code-review flow."
  12. }
  13. ]
  14. }
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)

  1. # Orca
  2. Deterministic, AI-driven development flows.
  3. Orca allows you to programmatically define software development workflows where
  4. AI agents perform the coding. If you want AI-generated code to always be
  5. reviewed by another agent, don't try to coerce the agents; just express that
  6. requirement in code. Don't waste tokens on formatting, committing, or creating
  7. PRs - all of this can be handled by an ordinary script.
  8. Orca comes with an `orca` cli and a skill, which can be used interactively by
  9. humans, or headlessly by humans and agents alike. A number of built-in flows,
  10. implementing e.g. a plan-implement-review loop, allow you to start using Orca
  11. right away.
  12. Orca flow scripts are written in Scala, and can be run with a single command
  13. through [scala-cli](https://scala-cli.virtuslab.org), which is installed by the
  14. `orca` installer. No other dependencies are needed - everything is automatically
  15. bootstrapped. Scala 3 looks like Python, but with types - so you get quick
  16. feedback if your flow script has any problems.
  17. Orca's development flows are resumable, so that if work is interrupted mid-flow
  18. for any reason, it can be continued from the last commit.
  19. You can use Orca to orchestrate development in any language and ecosystem.
  20. Orca assumes that it has configured, logged-in access to Claude, Codex,
  21. OpenCode, Pi or Gemini (depending which backend you use), as well as `gh` and
  22. `git`.
  23. > [!NOTE]
  24. > Orca is designed to be run as part of a single-developer workflow. For a
  25. > platform designed for teams, see
  26. > [Visdom](https://virtuslab.com/services/visdom): VirtusLab's AI-native SDLC
  27. > platform.
  28. ## Documentation
  29. Is available here: [orca.virtuslab.com](https://orca.virtuslab.com)
  30. ## Install
  31. The below installs `scala-cli` (via its official installer) if you don't have
  32. it already, and writes the `orca` executable to `~/.local/bin/orca`:
  33. ```bash
  34. 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
  35. ```
  36. To let a coding agent delegate work to Orca, install the `orca` skill. In
  37. Claude Code:
  38. ```text
  39. /plugin marketplace add VirtusLab/orca
  40. /plugin install orca@orca-skills
  41. ```
  42. In Pi: `pi install git:github.com/VirtusLab/orca`. For OpenCode, Codex and
  43. per-project installs, see [`skills/orca/README.md`](skills/orca/README.md).
  44. ## Start using
  45. Run `orca` in your repository. The first run asks which agent and model to use
  46. for planning, coding and review. Then pick a flow (`implement.sc` comes first)
  47. and enter your prompt.
  48. The same can be run non-interactively:
  49. ```bash
  50. orca run implement.sc "add a rate limiter to /login"
  51. ```
  52. Orca creates a feature branch, plans the change into tasks, implements and
  53. reviews each one, reviews the whole change, and opens a PR when the repository
  54. is on GitHub. Each stage is committed as it finishes; if the run is interrupted,
  55. run the same command again and it will continue from the last commit.
  56. A flow is a scala-cli script, so it also runs with no install:
  57. ```bash
  58. scala-cli run --workspace "$(mktemp -d)" implement.sc -- "add a rate limiter to /login"
  59. ```
  60. > [!WARNING]
  61. > **Orca should be used in a sandboxed environment!** Coding agent tool usage is
  62. > auto-approved by default: write-capable turns let the agent edit files and run
  63. > shell commands without prompting. Use a VPS or a local sandbox such as
  64. > [Sandcat](https://github.com/VirtusLab/sandcat) or [Docker
  65. > Sandboxes](https://docs.docker.com/ai/sandboxes/), or narrow the agents' tools
  66. > in the flow.
  67. ## A flow
  68. Flows are ordinary Scala scripts. For example, the below one plans, implements
  69. each task with a review, and opens a PR:
  70. ```scala
  71. //> using scala 3.9.0
  72. //> using dep "org.virtuslab::orca:0.2.1"
  73. //> using jvm 21
  74. import orca.{*, given}
  75. flow(OrcaArgs(args)):
  76. val plan = stage("Plan"):
  77. Plan.autonomous.from(userPrompt, planningAgent).value
  78. for task <- plan.tasks do
  79. stage(s"Task: ${task.title}"):
  80. val session = codingAgent.session("implementer", seed = plan.brief)
  81. session.run(task.description)
  82. reviewThenFix(coderSession = session, reviewers = allReviewers(reviewAgent), task = task)
  83. val openFindings = stage("Final review"):
  84. val finalFixer = codingAgent.session("final-fixer", seed = plan.brief)
  85. reviewAndFixLoop(
  86. coderSession = finalFixer,
  87. reviewers = allReviewers(reviewAgent),
  88. task = Task(Title("The whole planned change"), plan.brief),
  89. diff = ReviewDiff.WholeRun
  90. )
  91. openPrIfGitHub(summarisingAgent = codingAgent, openFindings = openFindings)
  92. ```
  93. Each `stage` commits on completion and is skipped on resume. The tutorial at
  94. [orca.virtuslab.com](https://orca.virtuslab.com) explains every line; the
  95. shipped flows live in [`flows/`](flows/).
  96. ## Documentation
  97. - [orca.virtuslab.com](https://orca.virtuslab.com) — user documentation: usage,
  98. built-in flows, settings, authoring flows, API reference, glossary. Source in
  99. [`docs/`](docs/).
  100. - [`adr/`](adr/) — architecture decision records.
  101. - [`CONTRIBUTING.md`](CONTRIBUTING.md) — building, testing, and running a
  102. locally modified orca.
  103. - [`AGENTS.md`](AGENTS.md) — internals, architecture, and coding conventions;
  104. the same file AI assistants pick up.
  105. ## License
  106. Apache 2.0 — see [LICENSE](LICENSE).
  107. ## Copyright
  108. Copyright (C) 2026 VirtusLab [https://virtuslab.com](https://virtuslab.com).

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.