byok-custom-model — Claude Code skill for custom models
Register a chat model in Starchild using your own API key. Choose a preset provider or configure another endpoint from its API example.
npx skills add Starchild-ai-agent/official-skills --skill byok-custom-model -a claude-codeWhat byok-custom-model 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.
What it helps with
- 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 for the agent
- 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.
How to install byok-custom-model
1Skills CLI (Vercel)
npx skills add Starchild-ai-agent/official-skills --skill byok-custom-model -a claude-code2Manually: put the files in place
~/.claude/skills/byok-custom-model/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/byok-custom-model/
1Skills CLI (Vercel)
npx skills add Starchild-ai-agent/official-skills --skill byok-custom-model -a codex2Manually: put the files in place
.agents/skills/byok-custom-model/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add Starchild-ai-agent/official-skills --skill byok-custom-model -a cursor2Manually: put the files in place
.cursor/skills/byok-custom-model/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install Starchild-ai-agent/official-skills byok-custom-model2Manually: put the files in place
.github/skills/byok-custom-model/SKILL.md1Skills CLI (Vercel)
npx skills add Starchild-ai-agent/official-skills --skill byok-custom-model -a gemini-cli2Platform CLI
gemini skills install https://github.com/Starchild-ai-agent/official-skills --path byok-custom-modelManually: put the files in place
.devin/skills/byok-custom-model/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add Starchild-ai-agent/official-skills --skill byok-custom-model -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about byok-custom-model
How do I install byok-custom-model in Claude Code?
Run npx skills add Starchild-ai-agent/official-skills --skill byok-custom-model -a claude-code. The skill file is at ~/.claude/skills/byok-custom-model/SKILL.md.
What does byok-custom-model do?
It registers chat models with personal API keys in Starchild. Use a preset for supported providers or create a draft from another provider’s API example.
How do I register a provider without a preset?
Give the skill an official API request example with a placeholder or fake key, then review the resulting draft before adding it.
