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.

develop-userscripts - Skill

Name: develop-userscripts
Author: xixu-me

Imported from xixu-me/skills (skills/develop-userscripts/SKILL.md) via skills.sh. Install upstream with npx skills add xixu-me/skills --skill develop-userscripts. Copyright stays with the author.

Userscript work usually breaks at the runtime and metadata boundary, not in the page logic. Choose the runtime first, declare the minimum permissions up front, then debug in the environment where the script actually runs.

When to Use

Use this skill for:

writing or fixing a Tampermonkey or ScriptCat userscript
debugging injection timing, missing permissions, CSP workarounds, update checks, or GM_* behavior
deciding between a portable foreground script and ScriptCat-only @background or @crontab
adding config UI with ==UserConfig==
packaging a ScriptCat ==UserSubscribe== bundle or preparing a CloudCat-compatible script

Do not use this skill for full browser extension development or general browser automation outside userscript managers.

Runtime Selection

digraph userscript_runtime {
    "Need page DOM or page context?" [shape=diamond];
    "Need persistent or scheduled work?" [shape=diamond];
    "Need to install many scripts as one package?" [shape=diamond];
    "Portable foreground script" [shape=box];
    "ScriptCat background or crontab script" [shape=box];
    "ScriptCat subscription package" [shape=box];

    "Need page DOM or page context?" -> "Portable foreground script" [label="yes"];
    "Need page DOM or page context?" -> "Need persistent or scheduled work?" [label="no"];
    "Need persistent or scheduled work?" -> "ScriptCat background or crontab script" [label="yes"];
    "Need persistent or scheduled work?" -> "Need to install many scripts as one package?" [label="no"];
    "Need to install many scripts as one package?" -> "ScriptCat subscription package" [label="yes"];
    "Need to install many scripts as one package?" -> "Portable foreground script" [label="no"];
}

Preflight

Confirm the manager and browser. On Manifest V3 browsers, ScriptCat may require Allow User Scripts or browser developer mode before scripts run.
Decide page script versus background script before writing code. ScriptCat background scripts cannot touch the DOM.
Start with metadata, not implementation: @match, @grant, @connect, @run-at, and any update URLs.
Prefer portable ==UserScript== patterns for ordinary page scripts. Only switch to ScriptCat-only headers when the requested behavior actually needs them.

Workflow

Choose the runtime and metadata first.
Declare the smallest permission surface that fits the task.
Implement against the runtime you chose.
Debug where the code really runs.
- Foreground scripts: page console plus manager logs.
- ScriptCat background scripts: run log first, then background.html for real-environment debugging.
Publish with the right update model.
- Normal scripts: keep @version accurate and add @updateURL or @downloadURL only when needed.
- Subscription bundles: use ==UserSubscribe==, HTTPS URLs, and subscription-level @connect.

Quick Reference

Intent	Default choice	Watch for
Page UI, DOM scraping, page patching	Portable `==UserScript==`	`@match`, `@grant`, `@run-at`, CSP-sensitive injection
Cross-origin API access	`GM_xmlhttpRequest` with explicit `@connect`	Missing hosts, cookie behavior differences, user authorization
Long-running worker	ScriptCat `@background`	No DOM, must return `Promise` for async work
Scheduled task	ScriptCat `@crontab`	Only first `@crontab` counts, prefer 5-field cron, avoid interval overlap
User-editable settings	`==UserConfig==` plus `GM_getValue`	Block placement and `group.key` naming
Silent bundle install and updates	`==UserSubscribe==`	HTTPS, `user.sub.js`, subscription `connect` overrides child scripts

Common Mistakes

Missing @grant for APIs the script actually uses.
Missing @connect for hosts used by GM_xmlhttpRequest or GM_cookie.
Treating @include as a better default than @match for ordinary host targeting.
Using DOM APIs inside ScriptCat background or cron scripts.
Returning from a ScriptCat background script before async GM work is truly finished.
Mixing ==UserScript== and ==UserSubscribe== packaging concepts.
Putting ==UserConfig== in the wrong place or reading config keys without the group.key name.
Assuming Tampermonkey and ScriptCat storage, notification, or request behavior is identical.

References

Install develop-userscripts 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": "xixu-me-skills-develop-userscripts", "kind": "skill", "name": "develop-userscripts", "description": "Use when building, debugging, packaging, or publishing browser userscripts for Tampermonkey or ScriptCat, including GM APIs, metadata blocks, permission issues, @match/@grant/@connect setup, ScriptCat background or scheduled scripts, UserConfig blocks, or subscription workflows.", "publisher": "xixu-me", "version": "1.0.0", "capabilities": { "domains": [ "customer_support", "coding" ], "tags": [ "skill-md", "skills-sh" ], "languages": [ "en" ] }, "quality_prior": 0.6, "examples": [ "Use when building, debugging, packaging, or publishing browser userscripts for Tampermonkey or ScriptCat, including GM APIs, metadata blocks, permission issues, @match/@grant/@connect setup, ScriptCat background or scheduled scripts, UserConfig blocks, or subscription workflows." ], "primary": false, "metadata": { "source": { "provider": "skills.sh", "repository": "https://github.com/xixu-me/skills", "path": "skills/develop-userscripts/SKILL.md", "ref": "HEAD", "url": "https://www.skills.sh/xixu-me/skills/develop-userscripts", "key": "xixu-me/skills/skills/develop-userscripts/SKILL.md" } }, "instructions": "Userscript work usually breaks at the runtime and metadata boundary, not in the page logic. Choose the runtime first, declare the minimum permissions up front, then debug in the environment where the script actually runs.\n\n## When to Use\n\nUse this skill for:\n\n- writing or fixing a Tampermonkey or ScriptCat userscript\n- debugging injection timing, missing permissions, CSP workarounds, update checks, or `GM_*` behavior\n- deciding between a portable foreground script and ScriptCat-only `@background` or `@crontab`\n- adding config UI with `==UserConfig==`\n- packaging a ScriptCat `==UserSubscribe==`", "cost": { "context_tokens": 1263 } }

develop-userscripts

About

When to Use

Runtime Selection

Preflight

Workflow

Quick Reference

Common Mistakes

References

Install develop-userscripts 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