oderajoseph95

Polaris Agent Kit — AI skill for Claude Code

AI community

Unofficial Polaris 2.0 web components kit for AI coding agents building Shopify embedded apps: rules, references and a linter for Claude Code, Cursor, Copilot and Codex.

How to install Polaris Agent Kit

This entry records only its repository, not the path inside it, so there is no exact command to give. Open oderajoseph95/polaris-agent-kit and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

What Polaris Agent Kit does

Unofficial Polaris 2.0 web components kit for AI coding agents building Shopify embedded apps: rules, references and a linter for Claude Code, Cursor, Copilot and Codex. Not affiliated with Shopify.

Alternatives in AI

TokenTracker — Local-first AI token usage & cost tracker for 31 coding tools incl 1.4k ★
Embeddedskills — An open-source collection of embedded development and debugging skills for Claude Code, Copilot, TRAE, and oth 593 ★
onWatch — Open-source Go CLI that tracks AI API quota usage across 7 providers (Synthetic, Z.ai, Anthropic, Codex, GitHu 397 ★

README

Polaris agent kit

**Rules and a linter that stop AI coding agents from writing broken Polaris 2.0 web components in Shopify embedded apps.** Works with Claude Code, Cursor, GitHub Copilot, Codex and Windsurf. Zero dependencies.

Unofficial community project, not affiliated with Shopify. Status: 0.1.0, first release. The checker and installer are tested on Windows and in CI on Linux; see [Tested and untested](#tested-and-untested) for what is not.

![The check command listing seven errors in a page an agent wrote, each with file, line and fix](docs/demo/check-demo.svg)

The problem

Agents write Polaris from memory, and in our experience much of that memory is Polaris 1, the React library. The code type-checks and is still wrong: a hyphenated prop (`list-slot`) that `tsc` cannot see and the browser ignores; the deprecated `@shopify/polaris` React package added when web components were meant; an unversioned script URL next to Polaris 2.0 types that do not match it; boolean props React 18 writes as the string `"false"`, which Polaris reads as true. This kit gives the agent the rules before it writes, and a linter that catches what the compiler cannot.

Install in 3 commands

Until the package is on npm and a release is tagged, install from a clone: `git clone https://github.com/oderajoseph95/polaris-agent-kit && node polaris-agent-kit/bin/cli.mjs check `. The three commands below work once `polaris-agent-kit@0.1.0` is published.

# 1. Claude Code only (two lines inside Claude Code). Other agents skip to step 2.
/plugin marketplace add oderajoseph95/polaris-agent-kit
/plugin install polaris-agent-kit@polaris-agent-kit-marketplace

# 2. Put the rules where your agent reads them (claude | cursor | copilot | codex | windsurf | all)
npx -y polaris-agent-kit@0.1.0 init --agent claude

# 3. Lint what the agent wrote (exit 1 on an error finding)
npx -y polaris-agent-kit@0.1.0 check

The version is pinned on purpose: `npx -y` runs whate