list-models

Query the /v1/models endpoint and format model catalogs from OpenAI-compatible APIs.

Updated Mar 23, 2026
One-click install
npx skills add https://github.com/luyangliuable/claude-setup --skill list-models-luyangliuable
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: list-models
Source: https://github.com/luyangliuable/claude-setup/tree/main/.agents/skills/list-models
Command: npx skills add https://github.com/luyangliuable/claude-setup --skill list-models-luyangliuable

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps you quickly discover which models are available from an OpenAI-compatible or LiteLLM API, so you do not have to guess model names or manually inspect API responses.

Core Features & Use Cases

  • Model Discovery: Queries the /v1/models endpoint and lists model IDs in a readable format.
  • Auth-Aware API Access: Supports both Bearer token and x-api-key authentication.
  • Useful for: Checking available models before configuring an app, validating endpoint access, or comparing what a provider exposes.

Quick Start

Ask the skill to list models for your API endpoint by providing the base URL, API key, and authentication type.

Frequently Asked Questions about list-models

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I list available API models from an OpenAI-compatible endpoint?

To list available API models from an OpenAI-compatible endpoint, query the /v1/models route with a Bearer token or x-api-key. This returns a formatted catalog of model IDs, owners, and creation dates for review.

What authentication do I need to query the /v1/models route?

Querying the /v1/models route requires authenticated HTTP access using either a Bearer token or an x-api-key. You must provide your API key and specify the authentication type to retrieve the available models list.

Can I use this to check available models on a LiteLLM service?

Yes, you can check available models on a LiteLLM service. The skill queries the /v1/models endpoint and formats the returned catalog, making it suitable for model discovery and endpoint validation on LiteLLM platforms.

What metadata is returned when discovering models from an API endpoint?

When discovering models from an API endpoint, the returned metadata includes model IDs, owners, and creation dates. This information is formatted into a readable list to help you review what a provider exposes.

Why do I need to discover models before configuring my app with an OpenAI-compatible API?

You need to discover models before configuring your app to avoid guessing model names or manually inspecting API responses. Querying the /v1/models endpoint provides a readable list of valid model IDs for accurate configuration.

Does this work for validating endpoint access on OpenAI-compatible APIs?

Yes, this works for validating endpoint access on OpenAI-compatible APIs. By querying the /v1/models route with your credentials, you can confirm authenticated access and review the available models exposed by the provider.