Update every repo from one catalog

One instruction for both agents

Add this to AGENTS.md for Codex or to CLAUDE.md for Claude Code.

## Model updates

Fetch https://aistackregistry.com/index.json once before checking my repos. Reuse that catalog for every repo in this update. Compare each repo's model IDs, limits, and provider settings. Tell me what should change before editing. After I approve, make the changes and run each repo's existing checks. If the catalog is missing a fact you need, tell me instead of guessing.

Then tell the agent which model you want and which repositories to check.

Install the shared model-update skill

Codex and Claude Code use the same SKILL.md. The skill fetches the catalog once and reuses the same bytes for every repo. Before editing, it reads repository instructions and model configuration, then makes the changes the catalog supports. It skips unknown or blocked repos and reports what changed or was skipped.

Install for Codex

skill_dir="${CODEX_HOME:-$HOME/.codex}/skills/update-ai-models"
mkdir -p "$skill_dir"
curl --fail --silent --show-error \
  https://aistackregistry.com/skill/SKILL.md \
  --output "$skill_dir/SKILL.md"

Install in a Claude Code project

mkdir -p .claude/skills/update-ai-models
curl --fail --silent --show-error \
  https://aistackregistry.com/skill/SKILL.md \
  --output .claude/skills/update-ai-models/SKILL.md

Restart the agent, then ask it to use the update-ai-models skill for the repositories you name.

Check pinned model facts in CI

CI can fetch the catalog once and compare a model ID, token limit, or provider setting your app pins.

Check that a configured model ID exists

This example assumes config/ai.json contains a model field. Change the file and field to match your repo. The only network call is the catalog fetch.

- name: Check configured AI model
  shell: bash
  env:
    MODEL_CONFIG: config/ai.json
  run: |
    set -euo pipefail
    catalog="$RUNNER_TEMP/aistackregistry-index.json"
    curl --fail --silent --show-error \
      https://aistackregistry.com/index.json \
      --output "$catalog"
    model_id="$(jq -r '.model' "$MODEL_CONFIG")"
    if ! jq -e --arg id "$model_id" \
      '.models | any(.api_model_id == $id or .registry_id == $id)' \
      "$catalog" >/dev/null
    then
      echo "::error::Configured model is missing from AI Stack Registry: $model_id"
      exit 1
    fi

This check catches an unknown model ID. Add comparisons for the limits and provider settings each repo pins. Fetch the catalog before the repo loop. When you want an upgrade, ask Codex or Claude Code to review new model releases.