Skip to content

fix(skills): repoint remaining omniroute-cli skill links (#15665) - #16109

Merged
diegosouzapw merged 1 commit into
release/v3.8.52from
fix/15665-cli-skill-links
Oct 10, 2026
Merged

diegosouzapw merged 1 commit into
release/v3.8.52from
fix/15665-cli-skill-links

Conversation

@diegosouzapw

Copy link
Copy Markdown
Owner

Fixes #15665

⚠️ Protected surface: this PR touches skills/**/SKILL.md (agent-instruction files). Per AGENTS.md → Review focus, it needs explicit owner approval before merge.

⚠️ base-red inherited: #15306

What

#15676 (thanks @Poid-ZA) fixed the "Capability skills" table in omni-auth and the routing link in cli-providers. This PR fixes every remaining link to a deleted skills/omniroute*/SKILL.md directory (all 404 on raw GitHub):

Old target New target Evidence
omniroute/SKILL.md (12 "entry-point SKILL" links in omni-inference/combos-routing/resilience/mcp/agents-a2a/compression) omni-auth <!-- Migrated from skills/omniroute/SKILL.md --> in omni-auth; its description says "Start here"
omniroute-cli, omniroute-cli-admin cli-serve cli-serve carries the old entry-point content (install, global flags) and the "Admin lifecycle" section. The self-reference inside cli-serve now says "see the install and global-flags sections above"
omniroute-cli-providers cli-providers migration marker
omniroute-cli-eval cli-eval migration marker
omniroute-cli-cloud (cloud agents) cli-backup-sync see below
cli-serve "Server admin + backup" row "Backup & restore" -> cli-backup-sync admin is cli-serve itself

Cloud agents decision. No cli-*cloud* skill exists. The skill generator assigns the whole omniroute cloud command group to cli-backup-sync (src/lib/agentSkills/cliRegistryParser.ts: cloud: "cli-backup-sync"). That command group (bin/cli/commands/cloud.mjs) is the cloud-agent task CLI, hitting /api/v1/agents/tasks. cli-backup-sync is the only skill that documents omniroute cloud create/list/status/approve/message/sources/agents/auth, so the link goes there. The row labels now say omniroute cloud … so readers aren't sent to a "backup" skill without explanation. (Splitting cloud into its own skill would be a generator change and is out of scope here.)

Remap groundwork came from #16016 (thanks @afonsoft), credited as co-author. I also confirmed the cloud-agent target and added the entry-point links that #16016 didn't cover.

Every edited line is inside a <!-- skill:custom-start/end --> block, so the generator keeps it on --apply. Tables were aligned by hand because skills/*/SKILL.md is in .prettierignore.

Regression test

tests/unit/docs/skillManifestsLint.test.ts gets a new check: every skills/<dir>/SKILL.md reference inside a skill (HTML comments excluded, since migration-provenance markers aren't links) must resolve to an existing skill dir.

  • With the fix reverted: fail (dangling skill links: …)
  • With the fix applied: pass (4/4)

Checks

  • node --import tsx/esm --test tests/unit/docs/skillManifestsLint.test.ts: 4/4 pass
  • check:docs-sync, check:docs-frontmatter, check:env-doc-sync, check:deprecated-versions, check:doc-links, check:fabricated-docs: all pass
  • check:docs-counts: fails, inherited. The 7 strict drifts are provider count 371 (live) vs 370 in PROVIDER_REFERENCE.md and the hero/tier SVGs, unrelated to skills.
  • check:agent-skills-sync: exit 2, inherited. The base tip reports the exact same 20-skill "would regenerate" list.
  • Pre-commit hooks (lint-staged, docs-sync, any-budget, tracked-artifacts, ai-attribution): pass

The omniroute-* skill dirs were renamed to omni-*/cli-* long ago, but several
skills still linked to the old raw URLs, which now 404 for agents following
them. #15676 fixed the capability table in omni-auth; this repoints the rest:

- omniroute/SKILL.md (entry point) -> omni-auth (its content was migrated
  there; 12 "entry-point SKILL" links across omni-* skills)
- omniroute-cli / omniroute-cli-admin -> cli-serve (both migrated there);
  the self-reference inside cli-serve now points at its own sections
- omniroute-cli-providers -> cli-providers, omniroute-cli-eval -> cli-eval
- omniroute-cli-cloud -> cli-backup-sync: the generator assigns the whole
  'omniroute cloud' command group (cloud-agent tasks) to that skill
  (src/lib/agentSkills/cliRegistryParser.ts), and it is the only skill that
  documents those subcommands; the row labels now say 'omniroute cloud'

Adds a regression test to skillManifestsLint: every skills/<dir>/SKILL.md
reference inside a skill (outside HTML comments) must resolve.

Co-authored-by: afonsoft <11299396+afonsoft@users.noreply.github.com>
Comment thread tests/unit/docs/skillManifestsLint.test.ts Dismissed
@diegosouzapw
diegosouzapw merged commit 02f2f00 into release/v3.8.52 Oct 10, 2026
20 of 46 checks passed
@github-actions

Copy link
Copy Markdown
Contributor

CI Coverage Report

  • Coverage job: skipped
  • PR test policy: success

Coverage artifact was not available for this run.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

[bug] skills/omni-auth and cli-providers link to skills/omniroute-*/SKILL.md that no longer exist (404)

2 participants