Skills

Maintain Cross Platform

Use when preparing an AgentSys release, checking cross-platform compatibility, or...

Install

npx skills add agent-sh/agentsys --skill maintain-cross-platform -g -a claude-code -y
Repository
agent-sh/agentsys1k
Category
Engineering
Updated
4d ago
License
MIT
Context cost
Lightabout 1,109 tokens
Runs scripts
No, instructions only

What it does

Use when preparing an AgentSys release, checking cross-platform compatibility, or changing the installer, transforms, adapters or marketplace pins. Maintainer skill for this repo only.

Maintain cross-platform AgentSys

AgentSys installs the agent-sh plugins on Claude Code, OpenCode, Codex CLI, Cursor and Kiro. The plugins live in their own repos; this repo owns the marketplace, the installer, the transforms and the docs. Use this skill to find where a cross-platform concern lives and what to run.

Platform details (config formats, frontmatter, env vars, label limits) are in checklists/cross-platform-compatibility.md and docs/CROSS_PLATFORM.md; release steps are in checklists/release.md and agent-docs/release.md. Read them for the current facts instead of relying on memory.

Where things live

ConcernLocation
Marketplace, one entry per plugin pinned by tag and commit.claude-plugin/marketplace.json; re-pin with node scripts/pin-marketplace.js [--dry-run] (needs gh)
Installerbin/cli.js: installForClaude, installForOpenCode, installForCodex, installForCursor, installForKiro. Claude Code installs from the marketplace; the others fetch plugin sources into ~/.agentsys/plugins/<name> and transform them.
Transforms (frontmatter, tools to permissions, plugin-root paths, namespaces)lib/adapter-transforms.js. lib/ is maintained in this repo, so edit it here.
Platform adaptersadapters/opencode-plugin/ (native OpenCode plugin), adapters/opencode/, adapters/codex/; scripts/gen-adapters.js keeps generated files fresh
Dev installsnode bin/dev-cli.js dev-install [tool] (scripts/dev-install.js)
Versionspackage.json is the source; npx agentsys-dev bump X.Y.Z stamps package-lock.json, .claude-plugin/plugin.json, marketplace.json and site/content.json. Plugin repos version independently.
Generated doc sections<!-- GEN:START:... --> blocks, rewritten by npx agentsys-dev gen-docs

Platform differences behind most bugs

Read the whole SKILL.md on GitHub

More in Engineering