onboarding

A first-run setup guide for CodeWeaver, a server that gives AI agents semantic code search. It walks the user through choosing an embedding provider, configuring credentials, indexing the codebase, and checking the setup.

In plain words
What is it for?
Use it during CodeWeaver's initial setup to select Voyage AI or another provider, enter credentials securely, index a codebase, and verify that search works.
Why use it?
It reduces the uncertainty of setting up meaning-based code search for the first time. It explains the provider choice and the required API credentials before indexing begins.

Skill for Claude CodeCodex

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add skills/knitli/toolshed/onboarding
Any agent
npx skills add knitli/toolshed --skill onboarding
Clone the repo
git clone --depth 1 https://github.com/knitli/toolshed

Made for: Claude Code, Codex.

Per session 0 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 1,493 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 1 finding. Scan, not verified.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5 $0.00000 $0.01493
Opus 5 $0.00000 $0.00746
Sonnet 5 $0.00000 $0.00299
Haiku 4.5 $0.00000 $0.00149

Measured yesterday against content hash 5193eb797d6e, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

onboarding scanned grade A with 1 finding against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured yesterday.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Makes network callslowCapability

Not a fault in itself. Listed so you know the mod talks to something, and to what.

curl --fail-with-body -sS \
plugins/codeweaver/agents/onboarding/SKILL.md · 220 lines

How it starts

The opening of the file, as written. The whole thing — 220 lines — stays where its author put it; the contents beside it link to each section on GitHub.


name: codeweaver-onboarding version: 1.0.0 description: Interactive first-run onboarding for CodeWeaver plugin trigger: automatic condition: CODEWEAVER_FIRST_RUN=true author: Knitli Inc. license: MIT OR Apache-2.0

CodeWeaver First-Run Onboarding

You are guiding a user through their first-time setup of CodeWeaver, a semantic code search MCP server. This onboarding runs once and should be friendly, clear, and efficient.

Your Goal

Walk the user through selecting an embedding provider, configuring credentials, and verifying the setup works. Be conversational but concise.

Setup Flow

1. Welcome & Overview

Greet the user warmly and explain what's about to happen:

Welcome to CodeWeaver! 👋

I'll help you get set up in just a few minutes. We need to:
1. Choose an embedding provider (for semantic search)
2. Configure your API credentials (stored securely)
3. Index your codebase
4. Verify everything works

Let's get started!

2. Embedding Provider Selection

Explain the options and make a recommendation:

Recommended: Voyage AI (Voyage-4)

  • Best-in-class code embeddings
  • Optimized for semantic code search
  • Requires API key (free tier available)
  • Get API key at voyage.ai

Alternative: FastEmbed (Local)

  • Runs entirely on your machine
  • No API key needed
  • Good quality, slightly slower
  • Zero-cost option

Question: "Which provider would you like to use? (voyage/fastembed)"

Wait for user response. If they choose Voyage, proceed to step 3. If FastEmbed, skip to step 4.

3. API Key Collection (Voyage only)

For Voyage AI:

Great choice! You'll need a Voyage AI API key.

Get one here: https://voyage.ai (free tier available)

Once you have your API key, paste it below. It will be stored securely in your system keychain.

Wait for the user to provide the API key.

Validation: Test the API key works by assigning it inline so it doesn't need to be exported first:

# Use the bash tool to test the key; this will fail on non-2xx responses
VOYAGE_API_KEY="<key-provided-by-user>" \
curl --fail-with-body -sS \
     -H "Authorization: Bearer ${VOYAGE_API_KEY}" \
     -H "Content-Type: application/json" \
     https://api.voyageai.com/v1/models

Read the full file on GitHub · 220 lines

Files

What ships with it

1 file beside SKILL.md in the same directory: the scripts, references and assets a skill reads on demand. Not counted in the per-session cost; read them before you install if any of them is executable.

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. yesterday First seen · 220 lines · 0 tokens per session scan A 5193eb797d6e

Subscribe to this mod's changes

onboarding is a skill published in the GitHub repository knitli/toolshed (1 stars, last pushed 4mo ago), licensed MIT. It costs nothing until one of its globs matches a file; then it loads 1,493 tokens. A static security scan graded it A with 1 finding (makes network calls). No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.

Related

Other skills, from other repositories

motherduck-build-cfa-app

Design a MotherDuck-backed customer-facing analytics app. Use for embedded analytics, multi-tenant SaaS reporting, or product analytics for external users -- whenever the decision depends on per-customer isolation, backend routing, service-account boundaries, read scaling, or Hypertenancy-style patterns.

motherduckdb/agent-skills · 63 tokens

motherduck-build-dashboard

Build a live MotherDuck dashboard as a Dive. Use when composing one shareable KPI, trend, and breakdown story over existing MotherDuck data, especially when the result should stay a saved workspace artifact rather than a full application.

motherduckdb/agent-skills · 50 tokens

motherduck-build-data-pipeline

Design an end-to-end MotherDuck data pipeline. Use for ETL/ELT workflows -- choosing raw, staging, and analytics boundaries, bulk ingestion paths, transformation sequencing, dlt/dbt integration, publication targets, or whether DuckLake is actually required.

motherduckdb/agent-skills · 59 tokens

motherduck-connect

Connect to MotherDuck from any application. Use when setting up database connectivity via the Postgres endpoint (recommended), pgduckdb, native DuckDB API, or JDBC. Covers connection strings, authentication, SSL, and environment variable configuration.

motherduckdb/agent-skills · 52 tokens

motherduck-create-dive

Create, edit, manage, share, or embed MotherDuck Dives — live React + SQL dashboards, charts, and data apps saved in the workspace. Use for any dashboard, chart, KPI display, or data visualization over MotherDuck data, and for Dive authoring mechanics such as getdiveguide, useSQLQuery, local preview, version history…

motherduckdb/agent-skills · 95 tokens

motherduck-create-flight

Create, schedule, run, and debug MotherDuck Flights — Python jobs that run on MotherDuck compute. Use whenever someone wants to create a flight, schedule a Python script or recurring job on MotherDuck, set up scheduled ingestion from Postgres, dlt sources, S3, BigQuery, Snowflake, or APIs, refresh aggregates or…

motherduckdb/agent-skills · 106 tokens