v1.3.0

Multi-agent support and Orka 3.6 alignment

• Expanded README with per-agent installation instructions: Claude Code, Gemini CLI, Cursor, Windsurf, GitHub Copilot, Claude Desktop, and a generic fallback for any agent supporting system prompt injection
• Added compatibility table showing which agents can execute Orka CLI commands vs. guidance only
• Renamed from orka3-cli-claude-skill to orka3-cli-agent-skill throughout
• Updated docs links to docs.macstadium.com
• Fixed formatting in integration reference files (bulleted ToC, consistent with rest of skill)
• Updated version reference to Orka 3.6

v1.2.2

v1.2.2

What's Changed

• SKILL.md rewrite (708 → 173 lines)

The previous SKILL.md exceeded Claude's ~200-line truncation boundary, which meant the routing table at the bottom was getting silently dropped. This is the part that tells Claude which reference file to load for a given query. This release rewrites SKILL.md to fit within context, with domain-critical facts (architecture split, auth lifecycle, async operations, shared disk constraints) inlined at the top so they are always available.

• Better reference routing

The three separate routing sub-tables have been consolidated into one, with troubleshooting rows bolded to signal "always load for errors." The result is that Claude loads the correct reference file more consistently instead of improvising from a truncated SKILL.md.

• Troubleshooting files restructured

• auth-issues.md: Token expiration table promoted to the top of the file, since it is the most common first question when debugging auth. The admin-commands section now explains the actual role model and provides actionable commands rather than directing users to "contact your admin."

• deployment-issues.md: Debug workflow promoted to a Quick Triage Checklist at the top. grep anti-patterns replaced with CLI-native filtering (orka3 vm list <NAME> instead of orka3 vm list | grep). "Ask admin" language replaced with
  (requires admin role) and the actual commands.

• image-issues.md, network-issues.md: Same grep to CLI filtering cleanup. Added tables of contents for navigation.

  Workflow updates

  • shared-disk-workflows.md: Added a first-time per-host disk initialization section (diskutil eraseDisk). This was previously undocumented and is a common blocker during initial setup.
  • getting-started.md: Removed. Its content is already covered by the rewritten SKILL.md and existing reference files.

  Test infrastructure

  • Test harness and query set moved from repo root to tests/.
  • Harness refactored to standalone single-version testing. Removed A/B
    comparison scaffolding and external /tmp backup paths.

Installation

Claude Code

# Download and extract the .skill archive
unzip orka3-cli-v1.2.2.skill -d ~/.claude/skills/orka3-cli

Restart Claude Code after installation.

Claude Desktop

Upload the .skill archive via Settings > Capabilities > Skills.

What's Changed

• Rewrite SKILL.md for context window safety + better reference routing by @celanthe in #5

Full Changelog: v1.2.1...v1.2.2

v1.2.1

Installation

Claude Code

# Download and extract the .skill archive
unzip orka3-cli-v1.2.1.skill -d ~/.claude/skills/orka3-cli

Restart Claude Code after installation.

Claude Desktop

Upload the .skill archive via Settings > Capabilities > Skills.

What's Changed

• Fix release workflow reliability and update skill description by @celanthe in #4

Full Changelog: 1.2.0...v1.2.1

v1.2.0

Installation

Claude Code

# Download and extract the .skill archive
unzip orka3-cli-v1.2.0.skill -d ~/.claude/skills/orka3-cli

Restart Claude Code after installation.

Claude Desktop

Upload the .skill archive via Settings > Capabilities > Skills.

What's Changed

• docs: sync documentation with recent commits by @celanthe in #1
• feat: elevate skill guidelines to operating principles by @celanthe in #2
• refactor: restructure repo for clean skill distribution by @matt-pulsipher in #3

New Contributors

• @celanthe made their first contribution in #1
• @matt-pulsipher made their first contribution in #3

Full Changelog: https://github.com/macstadium/orka3-cli-claude-skill/commits/v1.2.0