claude-plugins: Skill for Claude Code

repo-operator

repo-operator syncs shared config to its repos with xfg. A synced file is overwritten on every sync, so a change made in the target repo is lost. Change the source in repo-operator.

How xfg works

• Config is src/ in repo-operator: base.yaml (id, deleteOrphaned, prOptions) plus the fragment files named in the table below.
• content: "@templates/<path>" points at src/templates/<path>, resolved relative to the fragment file. Everything distributed lives in src/templates/.
• Groups are named bundles of files and settings and can extends other groups. A repo opts in through groups: in repos.yaml.
• Conditional groups apply files or settings by which groups a repo has, with allOf, anyOf and noneOf. Use them for cross-cutting rules (for example rulesets that differ when mergify is present).
• createOnly: true seeds a file once and never overwrites it. Use it for files a repo customises (.gitignore, .mega-linter.yml, renovate-overrides.json5). Without it the file is overwritten on every sync.
• $arrayMerge: append with $values: [...] appends to an array (pre-commit repos, devcontainer extensions). Plain YAML keys replace the array.
• deleteOrphaned: true plus the .xfg.json manifest: xfg records what it synced under the config id, and deletes a recorded file from the repos once it leaves src/.
• template: true with vars substitutes ${xfg:name} and built-ins such as ${xfg:repo.fullName} in a file. An unknown variable fails the sync.
• xfg substitutes an env reference in any synced content: a dollar sign, a brace, an identifier and a closing brace, with an optional :-default or :?message. An unset one fails the sync. Double the dollar sign ($$ before the brace) to emit it literally, as lint.sh.tmpl does for shell expansions. GitHub expressions and ${xfg:...} in a non-template file pass through unchanged. A shell template that holds ${xfg:...} takes a .tmpl extension (lint.sh.tmpl) so shellcheck skips it.
• Comments in YAML/JSON templates are not synced: xfg parses and regenerates them with only the header: lines from groups.yaml. Explain non-obvious config via a header: link or repo-operator's docs. Shell and markdown templates keep their comments.
• .github/xfg-managed.json maps each repo to the files xfg overwrites there (not createOnly ones). .claude/xfg-managed.sh reads it from repo-operator's main (cached 15 minutes in the git dir). A PreToolUse hook blocks Edit, MultiEdit, Write, NotebookEdit and Bash writes to a listed file, and a pre-commit hook refuses commits that change one. The claude group syncs all three. In repo-operator the root copies are synced too: edit src/templates/ and let Apply write them.