Skip to content
cccskills
FreePublished on GitHub

add-provider

Scaffold a new model provider for Forge — class implementation, registry wiring, providerEnum entry, local-catalog classification, and unit test with mocked transport. Use for anything under src/models/.

The English summary is being prepared. Showing the original description.

See how to install

Files included (1)

  • SKILL.md2.2 KB

SKILL.md (original)

Review the instructions the agent will receive before you install.

/add-provider — add a new model provider

Providers in Forge follow a uniform shape (see src/models/ollama.ts, src/models/openai.ts, src/models/anthropic.ts). Copy the shape, don't invent a new one.

Provider name: $ARGUMENTS.

1. Provider class — src/models/$ARGUMENTS.ts

  • Export a class that matches the shape of existing providers (availability probe, chat/complete, token counting, streaming).
  • Availability probe must be ~1.5s max. Long timeouts block the REPL cold-start budget.
  • Use undici for HTTP (already a dependency). Do not add axios, node-fetch, or similar.
  • Redact credentials via src/security/redact.ts before any log call.
  • Map transport errors to ForgeRuntimeError with the right retryable flag and a recoveryHint where possible.

2. Registry — src/models/registry.ts

  • Add the provider id to providerEnum.
  • Register the class in initProviders.
  • If the provider is local (Ollama-style, runs on the user's machine), add it to isLocalProvider.

3. Catalog — src/models/local-catalog.ts

  • Add model id → family classification there.
  • Do not write regexes inside your provider to detect model capabilities. The catalog is the single source of truth.

4. Router — src/models/router.ts

  • Verify the router can reach the new provider via the standard routing rules. If routing needs a change, update the router and add a test in test/unit/adapter.test.ts.

5. Unit test

  • Mock the transport (see test/unit/adapter.test.ts for the pattern).
  • Cover: availability probe success/failure, chat/complete happy path, 429 retry logic, auth failure surfaces a non-retryable structured error.

6. Docs

  • Update the provider table in docs/ARCHITECTURE.md §6.
  • Bump the provider count in README.md "At a glance" if applicable.
  • Add a one-line setup note to docs/SETUP.md.

Run /verify to close the loop.

Reviews

No reviews yet. Tell others what you thought.

Comments

No login needed. Share how it worked for you, ask a question, or note where it did not run.

No comments yet. Be the first to write one.

Comments are published right away. Do not include personal information such as email addresses or phone numbers. Up to 2 URLs.

0 / 1,000 characters

This form is protected by reCAPTCHA, and the Google Privacy Policy and Terms of Service apply.

More skills from this repository

Scaffold a new Forge subagent (planner/architect/executor/reviewer/debugger/memory-style). Use when adding anything to src/agents/.

The English summary is being prepared. Showing the original description.

hoangsonww/Forge-Agentic-Coding-CLI26Updated Sep 28, 2026

Scaffold a new Forge subagent (planner/architect/executor/reviewer/debugger/memory-style).

The English summary is being prepared. Showing the original description.

hoangsonww/Forge-Agentic-Coding-CLI26Updated Sep 28, 2026

Scaffold a new model provider for Forge — class, registry wiring, providerEnum entry, local-catalog classification, router check, and a unit test with mocked transport.

The English summary is being prepared. Showing the original description.

hoangsonww/Forge-Agentic-Coding-CLI26Updated Sep 28, 2026

Scaffold a new Forge tool end-to-end — type, implementation, registration, permission/risk classification, and unit test. Use when adding anything to src/tools/.

The English summary is being prepared. Showing the original description.

hoangsonww/Forge-Agentic-Coding-CLI26Updated Sep 28, 2026

Scaffold a new Forge tool — implementation, registration, permission/risk metadata, sandbox routing, and a unit test. Use when adding anything to src/tools/.

The English summary is being prepared. Showing the original description.

hoangsonww/Forge-Agentic-Coding-CLI26Updated Sep 28, 2026

Scaffold a new Forge tool end-to-end — implementation, registration, permission/risk metadata, sandbox routing, and a unit test.

The English summary is being prepared. Showing the original description.

hoangsonww/Forge-Agentic-Coding-CLI26Updated Sep 28, 2026

See all skills by hoangsonww

Report a problem with this skill