# byok-custom-model

Register a chat model in Starchild using your own API key. Choose a preset provider or configure another endpoint from its API example.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 2700 installs · ★ 29
- Author: starchild
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/Starchild-ai-agent/official-skills/tree/HEAD/byok-custom-model/SKILL.md
- Updated: 2026-10-22
- HTML: https://affpapa.org/en/nevibecode/skills/byok-custom-model

## What it does

This skill adds a custom LLM endpoint to Starchild’s model selector. It includes presets for 12 providers, including Anthropic, OpenAI, DeepSeek, and Meta. For a provider without a preset, it can inspect an API request example from the provider’s documentation and prepare a draft configuration.

Python functions handle preset discovery, model listing, and adding or removing entries. For a custom provider, supply an API example without a real key, then review the draft. If registration needs an API key, the agent must call `request_env_input` to open the secure input flow; the script cannot open it on its own. Keep the key out of chat.

The endpoint is accessed directly rather than through the platform proxy. That means the selected provider or aggregator receives the project’s requests, so choose the endpoint with that in mind.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add Starchild-ai-agent/official-skills --skill byok-custom-model -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/byok-custom-model/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/byok-custom-model/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add Starchild-ai-agent/official-skills --skill byok-custom-model -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/byok-custom-model/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add Starchild-ai-agent/official-skills --skill byok-custom-model -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/byok-custom-model/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install Starchild-ai-agent/official-skills byok-custom-model
```

2. **Manually: put the files in place**
- File: `.github/skills/byok-custom-model/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add Starchild-ai-agent/official-skills --skill byok-custom-model -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/Starchild-ai-agent/official-skills --path byok-custom-model
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/byok-custom-model/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add Starchild-ai-agent/official-skills --skill byok-custom-model -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/Starchild-ai-agent/official-skills/tree/HEAD/byok-custom-model/SKILL.md

## When to use it
- add a preset model to Starchild’s selector
- register an API endpoint from another provider
- inspect the registered custom models
- remove a model entry

## Example prompts
- Add an Anthropic chat model to Starchild using my API key.
- Use this provider’s API example to prepare a custom model draft.
- List my registered models and remove the entry I choose.

## Similar
- [skill-creator](https://affpapa.org/en/nevibecode/skills/skill-creator.md) — skill · 414180 installs
- [writing-for-agents](https://affpapa.org/en/nevibecode/skills/writing-for-agents.md) — skill · 466719 installs
- [media-use](https://affpapa.org/en/nevibecode/skills/media-use.md) — skill · 1100000 installs
- [mcp-builder](https://affpapa.org/en/nevibecode/skills/mcp-builder.md) — skill · 130949 installs
- [subagent-driven-development](https://affpapa.org/en/nevibecode/skills/subagent-driven-development.md) — skill · 237746 installs
- [orchestration](https://affpapa.org/en/nevibecode/skills/orchestration.md) — skill · 349800 installs

From the same set: [starchild-ai-agent/official-skills](https://affpapa.org/en/nevibecode/by/starchild-ai-agent/official-skills.md) — 30 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md