skill-rules

A single, language-agnostic skill-authoring discipline Claude Code plugin. It encodes one rule that every Claude skill must satisfy: be portable across every developer and machine. A skill is committed and shared, so anything tied to one person's environment -- a home path, an absolute path to another repo, a pinned plugin version -- breaks silently for everyone else.

It is the companion to xgodev/dev-rules: dev-rules governs how code is written; skill-rules governs how the skills themselves are authored. Apply it before writing or editing a skill.

It is a discipline-enforcing skill: rigid, concise, applied before writing -- not a passive reference skimmed after the fact.

Install

The plugin is distributed through the single xgodev-plugins marketplace, hosted in xgodev/claude-plugin, which lists this repo as a GitHub source (this repo is not a marketplace itself):

/plugin marketplace add git@github.com:xgodev/claude-plugin.git
/plugin install skill-rules@xgodev-plugins

Until 0.1.0 this repo was its own marketplace (xgodev-skill-rules). If you installed the old way: /plugin uninstall skill-rules@xgodev-skill-rules, /plugin marketplace remove xgodev-skill-rules, then install as above.

Update

Inside Claude Code:

/plugin update skill-rules

From the CLI:

claude plugin update skill-rules@xgodev-plugins

What it provides

• LAW 1 -- Portable by construction. No environment-tied hardcoding in a committed skill (SKILL.md or its scripts): no /Users/<name> or /home/<name>, no absolute path to another repo, no pinned plugin version.
• Resolution table -- how to resolve each need portably: $HOME, git rev-parse --show-toplevel, environment variables, version globs, or ask-once plus per-machine memory (with an offered git clone).
• A pre-publish grep that flags machine-tied hardcoding before commit.
• Rationalizations and Red Flags populated from real cross-dev failures, so the skill resists the "it works on my machine" shortcut.

Why a separate plugin

Each xgodev plugin lives in its own repo (like boost-claude, quality-gate, dev-rules) and is listed as a GitHub source by the single xgodev-plugins marketplace in xgodev/claude-plugin, whose umbrella plugin pulls it in as a same-marketplace dependency alongside the others.

• Version: 0.2.0