Repository navigation
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 oforka3 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-cliRestart Claude Code after installation.
Claude Desktop
Upload the .skill archive via Settings > Capabilities > Skills.
What's Changed
Full Changelog: v1.2.1...v1.2.2