claude-ai-models 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,85 @@
+# claude-ai-models
+
+A [Claude Code](https://claude.com/claude-code) skill that fetches the latest AI model IDs from **Anthropic**, **OpenAI**, and **Google** — so Claude always uses up-to-date model names in your code.
+
+**No API keys needed.** The skill scrapes public sources to get the latest model lists.
+
+## Why?
+
+Claude's training data has a knowledge cutoff. When you ask it to write code calling AI APIs, it often uses outdated model IDs (e.g., `gpt-4-turbo` when `gpt-5.2` already exists). This skill fixes that by fetching the real, current model list before writing any code.
+
+## Install
+
+```bash
+npx claude-ai-models
+```
+
+That's it. The skill is now active in Claude Code.
+
+## How it works
+
+When Claude writes code that calls an AI API, it automatically runs a bash script that:
+
+1. **Anthropic** — Scrapes the [official docs page](https://docs.anthropic.com/en/docs/about-claude/models) for `claude-*` model IDs
+2. **OpenAI** — Fetches the [SDK source file](https://github.com/openai/openai-python/blob/main/src/openai/types/shared/chat_model.py) on GitHub (auto-generated from their OpenAPI spec — the true source of truth)
+3. **Google** — Scrapes the [Gemini docs page](https://ai.google.dev/gemini-api/docs/models) for `gemini-*` model IDs
+
+The script does all the heavy lifting (curl + grep/sort), so Claude only receives a clean list of model IDs — minimal token usage.
+
+## Commands
+
+```bash
+npx claude-ai-models install    # Install (default)
+npx claude-ai-models uninstall  # Remove the skill
+npx claude-ai-models test       # Fetch models to verify it works
+npx claude-ai-models help       # Show help
+```
+
+## Manual usage
+
+You can also run the fetch script directly:
+
+```bash
+bash ~/.claude/skills/ai-models/fetch-models.sh             # All providers
+bash ~/.claude/skills/ai-models/fetch-models.sh --anthropic  # Anthropic only
+bash ~/.claude/skills/ai-models/fetch-models.sh --openai     # OpenAI only
+bash ~/.claude/skills/ai-models/fetch-models.sh --google     # Google only
+```
+
+## Example output
+
+```
+=== LATEST AI MODELS (2026-02-08) ===
+
+## ANTHROPIC (Claude)
+
+  claude-opus-4-6
+  claude-sonnet-4-5
+  claude-haiku-4-5
+  ...
+
+## OPENAI
+
+  gpt-5.2
+  gpt-5.1
+  gpt-4o
+  o4-mini
+  o3
+  ...
+
+## GOOGLE (Gemini)
+
+  gemini-3-pro
+  gemini-2.5-pro
+  gemini-2.5-flash
+  ...
+```
+
+## Requirements
+
+- `jq` — Install with `brew install jq` (macOS) or `apt install jq` (Linux)
+- `curl` — Usually pre-installed
+
+## License
+
+MIT

package/bin/cli.js

@@ -0,0 +1,108 @@
+#!/usr/bin/env node
+
+const fs = require("fs");
+const path = require("path");
+const os = require("os");
+const { execSync } = require("child_process");
+
+const SKILL_NAME = "ai-models";
+const SKILL_DIR = path.join(os.homedir(), ".claude", "skills", SKILL_NAME);
+const SOURCE_DIR = path.join(__dirname, "..", "skill");
+
+const args = process.argv.slice(2);
+const command = args[0] || "install";
+
+function install() {
+  console.log("Installing claude-ai-models skill...\n");
+
+  // Ensure ~/.claude/skills/ exists
+  const skillsRoot = path.join(os.homedir(), ".claude", "skills");
+  fs.mkdirSync(skillsRoot, { recursive: true });
+
+  // Create skill directory
+  fs.mkdirSync(SKILL_DIR, { recursive: true });
+
+  // Copy skill files
+  const files = fs.readdirSync(SOURCE_DIR);
+  for (const file of files) {
+    const src = path.join(SOURCE_DIR, file);
+    const dest = path.join(SKILL_DIR, file);
+    fs.copyFileSync(src, dest);
+    console.log(`  Copied ${file}`);
+  }
+
+  // Make fetch script executable
+  const scriptPath = path.join(SKILL_DIR, "fetch-models.sh");
+  if (fs.existsSync(scriptPath)) {
+    fs.chmodSync(scriptPath, 0o755);
+  }
+
+  console.log(`\nInstalled to ${SKILL_DIR}`);
+  console.log("\nThe skill is now available in Claude Code.");
+  console.log("It will automatically fetch latest model IDs when you write AI API code.");
+  console.log("\nYou can also run it manually:");
+  console.log(`  bash ${scriptPath}`);
+  console.log(`  bash ${scriptPath} --anthropic`);
+  console.log(`  bash ${scriptPath} --openai`);
+  console.log(`  bash ${scriptPath} --google`);
+}
+
+function uninstall() {
+  console.log("Uninstalling claude-ai-models skill...\n");
+
+  if (fs.existsSync(SKILL_DIR)) {
+    fs.rmSync(SKILL_DIR, { recursive: true });
+    console.log(`Removed ${SKILL_DIR}`);
+    console.log("\nSkill uninstalled successfully.");
+  } else {
+    console.log("Skill not found — nothing to remove.");
+  }
+}
+
+function test() {
+  console.log("Testing ai-models skill...\n");
+
+  const scriptPath = path.join(SKILL_DIR, "fetch-models.sh");
+  if (!fs.existsSync(scriptPath)) {
+    console.error("Skill not installed. Run: npx claude-ai-models install");
+    process.exit(1);
+  }
+
+  try {
+    const output = execSync(`bash "${scriptPath}"`, {
+      encoding: "utf-8",
+      timeout: 60000,
+    });
+    console.log(output);
+  } catch (err) {
+    console.error("Script failed:", err.message);
+    process.exit(1);
+  }
+}
+
+switch (command) {
+  case "install":
+    install();
+    break;
+  case "uninstall":
+    uninstall();
+    break;
+  case "test":
+    test();
+    break;
+  case "help":
+  case "--help":
+  case "-h":
+    console.log("claude-ai-models — Claude Code skill for fetching latest AI model IDs\n");
+    console.log("Usage: npx claude-ai-models [command]\n");
+    console.log("Commands:");
+    console.log("  install     Install the skill to ~/.claude/skills/ (default)");
+    console.log("  uninstall   Remove the skill");
+    console.log("  test        Run the fetch script to verify it works");
+    console.log("  help        Show this help message");
+    break;
+  default:
+    console.error(`Unknown command: ${command}`);
+    console.error("Run: npx claude-ai-models help");
+    process.exit(1);
+}

package/package.json

@@ -0,0 +1,30 @@
+{
+  "name": "claude-ai-models",
+  "version": "1.0.0",
+  "description": "Claude Code skill that fetches latest AI model IDs from Anthropic, OpenAI, and Google — no API keys needed",
+  "bin": {
+    "claude-ai-models": "bin/cli.js"
+  },
+  "keywords": [
+    "claude",
+    "claude-code",
+    "skill",
+    "ai-models",
+    "anthropic",
+    "openai",
+    "google",
+    "gemini",
+    "gpt",
+    "llm"
+  ],
+  "author": "Tontoon7",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/Tontoon7/claude-ai-models"
+  },
+  "files": [
+    "bin/",
+    "skill/"
+  ]
+}

package/skill/SKILL.md

@@ -0,0 +1,47 @@
+---
+name: ai-models
+description: Fetch latest AI model IDs from Anthropic, OpenAI, and Google APIs to use accurate model names in code
+metadata:
+  tags: ai, models, api, anthropic, openai, google, claude, gpt, gemini
+invocation:
+  user_invocable: true
+---
+
+## When to use
+
+Use this skill **automatically** whenever you write code that calls AI APIs and need to specify a model ID.
+
+**Triggers:**
+- Writing API calls to Anthropic, OpenAI, or Google AI
+- Setting `model` parameters in any AI SDK (Vercel AI SDK, LangChain, etc.)
+- User asks about latest available models
+- Any code involving `model:` or `model=` for AI providers
+
+## How to use
+
+Run the fetch script — it scrapes public sources, no API keys needed:
+
+```bash
+bash ~/.claude/skills/ai-models/fetch-models.sh
+```
+
+Options:
+- `--all` (default): All providers
+- `--anthropic`: Anthropic only
+- `--openai`: OpenAI only
+- `--google`: Google Gemini only
+
+**Sources:**
+- Anthropic: official docs page (docs.anthropic.com)
+- OpenAI: SDK source of truth on GitHub (auto-generated from OpenAPI spec)
+- Google: official Gemini docs (ai.google.dev)
+
+## Rules
+
+1. **Always run the script** before using any model ID in code — never guess or use memorized IDs
+2. **Use the exact model ID** from the script output
+3. **Pick the right tier** for the use case:
+   - **Flagship** (Opus / GPT-4o / Gemini Pro): Complex reasoning, high quality
+   - **Balanced** (Sonnet / GPT-4o-mini / Gemini Flash): Best speed/quality ratio, default choice
+   - **Fast** (Haiku / GPT-3.5 / Gemini Flash Lite): Speed-first, simple tasks, cost-effective
+4. **Prefer aliases** (e.g. `claude-sonnet-4-5`) over dated versions unless pinning is needed

package/skill/fetch-models.sh

@@ -0,0 +1,116 @@
+#!/usr/bin/env bash
+# Fetch latest AI model IDs from public sources (no API keys needed)
+# Usage: ./fetch-models.sh [--anthropic|--openai|--google|--all]
+
+set -uo pipefail
+
+ANTHROPIC_URL="https://docs.anthropic.com/en/docs/about-claude/models"
+OPENAI_URL="https://raw.githubusercontent.com/openai/openai-python/main/src/openai/types/shared/chat_model.py"
+GOOGLE_URL="https://ai.google.dev/gemini-api/docs/models"
+
+fetch_anthropic() {
+  echo "## ANTHROPIC (Claude)"
+  echo ""
+
+  local html
+  html=$(curl -sL --max-time 20 "$ANTHROPIC_URL" 2>/dev/null) || html=""
+
+  if [ -z "$html" ]; then
+    echo "  ERROR: Could not fetch $ANTHROPIC_URL"
+    return
+  fi
+
+  local models
+  models=$(echo "$html" \
+    | grep -oE 'claude-(opus|sonnet|haiku)-[a-z0-9._-]+' \
+    | sort -t'-' -k2,2 -k3,3rn -k4,4rn \
+    | uniq \
+    | head -30 2>/dev/null) || models=""
+
+  if [ -n "$models" ]; then
+    echo "$models" | while read -r model; do echo "  $model"; done
+  else
+    echo "  No models found. Page structure may have changed."
+  fi
+  echo ""
+}
+
+fetch_openai() {
+  echo "## OPENAI"
+  echo ""
+
+  local content
+  content=$(curl -sL --max-time 20 "$OPENAI_URL" 2>/dev/null) || content=""
+
+  if [ -z "$content" ]; then
+    echo "  ERROR: Could not fetch $OPENAI_URL"
+    return
+  fi
+
+  local models
+  models=$(echo "$content" \
+    | grep -oE '"(gpt-[0-9][a-z0-9._-]*|o[0-9][-a-z0-9]*|chatgpt-[a-z0-9-]+|codex-[a-z0-9-]+)"' \
+    | tr -d '"' \
+    | sort -t'-' -k1,1 -k2,2rn \
+    | uniq \
+    | head -40 2>/dev/null) || models=""
+
+  if [ -n "$models" ]; then
+    echo "$models" | while read -r model; do echo "  $model"; done
+  else
+    echo "  No models found. Source file may have changed."
+  fi
+  echo ""
+}
+
+fetch_google() {
+  echo "## GOOGLE (Gemini)"
+  echo ""
+
+  local html
+  html=$(curl -sL --max-time 20 "$GOOGLE_URL" 2>/dev/null) || html=""
+
+  if [ -z "$html" ]; then
+    echo "  ERROR: Could not fetch $GOOGLE_URL"
+    return
+  fi
+
+  local models
+  models=$(echo "$html" \
+    | grep -oE 'gemini-[0-9][a-z0-9._-]*' \
+    | grep -v '_[0-9]$' \
+    | sort -t'-' -k2,2rn -k3,3r \
+    | uniq \
+    | head -30 2>/dev/null) || models=""
+
+  if [ -n "$models" ]; then
+    echo "$models" | while read -r model; do echo "  $model"; done
+  else
+    echo "  No models found. Page structure may have changed."
+  fi
+  echo ""
+}
+
+# Main
+PROVIDER="${1:---all}"
+
+echo "=== LATEST AI MODELS ($(date +%Y-%m-%d)) ==="
+echo ""
+
+case "$PROVIDER" in
+  --anthropic) fetch_anthropic ;;
+  --openai)    fetch_openai ;;
+  --google)    fetch_google ;;
+  --all)
+    fetch_anthropic
+    fetch_openai
+    fetch_google
+    ;;
+  *)
+    echo "Usage: $0 [--anthropic|--openai|--google|--all]"
+    exit 1
+    ;;
+esac
+
+echo "---"
+echo "Use the model IDs above in your API calls."