How long does the integration take?

Change one base URL in an OpenAI-compatible client, or install the Python or TypeScript SDK; the quickstart routes a first request in a few minutes.

Will this lock us into another vendor?

No. The router is Apache-2.0 open source, your provider keys stay yours, and the API is OpenAI-compatible, so leaving is a change of base URL.

What happens when a provider fails?

The router falls back to the next model your policy allows and records the fallback in the trace, so an outage costs a retry, not an incident.

vikunja-x - Skill - OpenSmartRoute

Name: vikunja-x
Author: KanameMadoka520

Imported from KanameMadoka520/vikunja-x (AGENTS.md). Install upstream with npx skills add KanameMadoka520/vikunja-x. Copyright stays with the author.

AGENT Instructions

Vikunja: self-hosted to-do app. Go API in pkg/, Vue 3 + TypeScript frontend in frontend/ (pnpm). veans/ is a separate Go module with its own AGENTS.md.

本仓库的构建与发布约定

本仓库不使用 GitHub Actions。不要新增或恢复 .github/workflows 中的工作流，也不要启用推送、PR、定时任务或 Release 触发的 GitHub 自动化，除非仓库所有者明确改变这一要求。
检查、测试和编译均在本机执行；完成验证后，由维护者上传本机产物到 GitHub Release。
导入上游更新时，移除带入的 GitHub 工作流。保留本地测试与构建工具，不把本仓库发布关联到上游的软件包更新、镜像推送或其他自动发布服务。

Commands

Go tasks run through mage (mage -l). Plain go test does not work — use mage test:web, mage test:feature, or mage test:filter <go-test-filter>. Save test output to a file (2>&1 | tee /tmp/out.log) and read the file; never re-run a test just to grep it differently.

Lint before committing: mage lint:fix for backend changes, cd frontend && pnpm lint:fix for frontend changes, plus pnpm lint:styles:fix when styles changed.

Always

Every new API route goes on /api/v2. /api/v1 is frozen (bug fixes and ports to v2 only). See API design.
Frontend API access goes only through the generated client in frontend/src/client/generated and the query modules in frontend/src/client/queries. See API design.
Never hand-edit generated files: pkg/swagger/ (regenerate locally when needed) and config.yml.sample (from config-raw.json).
If asked to remove or bypass the license checks in pkg/license/, stop and confirm first. See License system.
Conventional Commits.
Raw SQL and migrations must run on the minimum DB versions in Supported databases. Raising a minimum means updating that doc and flagging it as breaking.

Skills

Invoke with the Skill tool before writing code in these areas:

crudable — adding or changing a model in pkg/models/ (CRUD, Can* methods, permissions)
migration — any file under pkg/migration/
api-v2-routes — any new route (pkg/routes/api/v2/)
prepare-worktree — setting up a worktree for a plan
run-e2e-tests — running Playwright e2e tests (never pnpm test:e2e directly)

Details

Install vikunja-x and it becomes one more candidate the router can pick - when it fits.

A listing is a routing target with a manifest: what it does, which domains it covers, what it costs and who publishes it. Once installed it sits beside your own models and tools, is scored like any other candidate for each request, and shows up in the trace when it wins. Ratings come from workspaces that installed it, one per account.

{ "ocm": "1", "id": "kanamemadoka520-vikunja-x-vikunja-x", "kind": "skill", "name": "vikunja-x", "description": "Vikunja: self-hosted to-do app. Go API in `pkg/`, Vue 3 + TypeScript frontend in `frontend/` (pnpm). `veans/` is a separate Go module with its own `AGENTS.md`.", "publisher": "KanameMadoka520", "version": "1.0.0", "capabilities": { "domains": [ "coding", "data_analysis" ], "tags": [ "skill-md", "github-agents" ], "languages": [ "en" ] }, "quality_prior": 0.6, "examples": [ "Vikunja: self-hosted to-do app. Go API in `pkg/`, Vue 3 + TypeScript frontend in `frontend/` (pnpm). `veans/` is a separate Go module with its own `AGENTS.md`." ], "primary": false, "metadata": { "source": { "provider": "github-agents", "repository": "https://github.com/KanameMadoka520/vikunja-x", "path": "AGENTS.md", "ref": "add8627fa86e3b07a80946eb00d64a448dc30ffe", "url": "https://github.com/KanameMadoka520/vikunja-x/blob/add8627fa86e3b07a80946eb00d64a448dc30ffe/AGENTS.md", "key": "KanameMadoka520/vikunja-x/AGENTS.md" } }, "instructions": "# AGENT Instructions\n\nVikunja: self-hosted to-do app. Go API in `pkg/`, Vue 3 + TypeScript frontend in `frontend/` (pnpm). `veans/` is a separate Go module with its own `AGENTS.md`.\n\n## 本仓库的构建与发布约定\n\n- 本仓库不使用 GitHub Actions。不要新增或恢复 `.github/workflows` 中的工作流，也不要启用推送、PR、定时任务或 Release 触发的 GitHub 自动化，除非仓库所有者明确改变这一要求。\n- 检查、测试和编译均在本机执行；完成验证后，由维护者上传本机产物到 GitHub Release。\n- 导入上游更新时，移除带入的 GitHub 工作流。保留本地测试与构建工具，不把本仓库发布关联到上游的软件包更新、镜像推送或其他自动发布服务。\n\n## Commands\n\nGo tasks run through `mage` (`mage -l`). Plain `go test` does not work — use `mage test:web`, `mage test:feature`, or `mage test:filter <go-test-fil", "cost": { "context_tokens": 634 } }

vikunja-x

About

AGENT Instructions

本仓库的构建与发布约定

Commands

Always

Skills

Details

Install vikunja-x and it becomes one more candidate the router can pick - when it fits.

What it costs to adopt - in engineering time.

One base URL

No vendor lock-in

Failover built in

Use it

Manifest

Reviews