Agent skill

Local Network

by Convex-Dev in Convex-Dev/convex

Run isolated local Convex networks and in-process lattice node networks for development.

Custom licenceAuto-check passedDatabases

Install Local Network

skills CLI
$ npx skills add Convex-Dev/convex --skill local-network -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install Convex-Dev/convex local-network --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/Convex-Dev/convex.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/local-network .claude/skills/local-network && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
local-network
GitHub stars
117
Token cost
~177 tokens
SKILL.md length
48 words
Files
1
Skills in repo
12
Repo updated
First seen
Licence
Custom licence

At a glance

Run isolated local Convex networks and in-process lattice node networks for development.

  • Testing against local peers
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md
  • Reproducing peer
  • P2P replication issues

What it does

Local Network is an agent skill from Convex-Dev/convex. Run isolated local Convex networks and in-process lattice node networks for development. Use when testing against local peers, reproducing peer or P2P replication issues, exercising NodeServer or P2PNode sync, or when no remote network is configured.

Its SKILL.md is about 180 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Databases. The repository describes itself as: Convex Main Repository - Decentralised platform for the Internet of Value.

When your agent uses it

  • Testing against local peers
  • Reproducing peer
  • P2P replication issues
  • Exercising NodeServer

Example prompts

  • “/local-network”

What it can do on your machine

Read from SKILL.md and the folder at commit 9e199a3. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Local Network loads about 177 tokens when it runs. Until then it costs about 66 tokens; SKILL.md has 48 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~66
When it runs · the whole SKILL.md, loaded when a task matches
~177

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

Its licence (Custom licence) doesn't allow us to republish the file, so here is its outline and opening line. It has 48 words (~177 tokens).

“This is the Codex discovery entry for the canonical shared skill at .claude/skills/local-network/SKILL.md.”

— opening of SKILL.md by Convex-Dev, Custom licence
name
local-network

Read the full SKILL.md on GitHub

Files

Just SKILL.md in .agents/skills/local-network of Convex-Dev/convex.

Open the folder on GitHubat commit 9e199a3

Compare with similar skills

Local Network next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Local Network compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Local Network this skillConvex-Dev/convex117—~177Automated safety check: PassCustom licence
Evolving The Data ModelTriliumNext/Trilium38k—~2.1kAutomated safety check: PassAGPL-3.0
Hybrid Cloud Outboxesgetsentry/sentry45k—~4.8kAutomated safety check: PassCustom licence
Iptvnator Sqlite DB Worker4gray/iptvnator7.3k—~824Automated safety check: PassMIT
Replicate Video AdJingyi-Wu-Richael/replicate-video-ad1061 repos~1.6kAutomated safety check: PassNone
Content Create Hero Imageprisma/web1.1k—~6.9kAutomated safety check: PassNone

Similar skills

  • Evolving The Data Model

    TriliumNext/Trilium

    A skill your agent uses when adding a DB migration or a new column/field to a Becca entity in Trilium ("add a migration", "new column on notes/attributes", "ALTER TABLE", "add a field to…

    38k GitHub stars~2.1k tokensUpdated today
    DatabasesAuto-check passed
  • Hybrid Cloud Outboxes

    getsentry/sentry

    Official

    Guide for creating and maintaining outbox-based eventually consistent operations in Sentry.

    45k GitHub stars~4.8k tokensUpdated today
    DatabasesAuto-check passed
  • A skill your agent uses when changing Electron SQLite IPC, database-worker operations, request-scoped progress or cancellation, worker packaging, or runtime verification of non-EPG database work.

    7.3k GitHub stars~824 tokensUpdated yesterday
    DatabasesAuto-check passed
  • Replicate Video Ad

    Jingyi-Wu-Richael/replicate-video-ad

    Analyze a reference video frame by frame and turn its visual grammar, story beats, dialogue, product reveal, proof sequence, and conversion structure into a production-ready ecommerce story-ad…

    106 GitHub starsUsed in 1 repo~1.6k tokens
    DatabasesAuto-check passed
  • Official

    A skill your agent uses when the operator wants a hero or meta image for a Prisma blog post; asks to create or generate a blog hero, cover, social card, Open Graph, or YouTube image; mentions cover…

    1.1k GitHub stars~6.9k tokensUpdated today
    DatabasesAuto-check passed
  • AI Partner Chat

    eze-is/ai-partner-chat

    基于用户画像和向量化笔记提供个性化对话。当用户需要个性化交流、上下文感知的回应,或希望 AI 记住并引用其之前的想法和笔记时使用。

    213 GitHub starsUsed in 1 repo~3k tokens
    DatabasesAuto-check passed

More from Convex-Dev/convex

All 12 skills in this repo
  • Account

    Convex-Dev/convex

    Create or inspect Convex accounts. An agent skill from Convex-Dev/convex.

    117 GitHub stars~140 tokensUpdated yesterday
    Auto-check passed
  • Build Convex

    Convex-Dev/convex

    Build the Convex project from source. An agent skill from Convex-Dev/convex.

    117 GitHub stars~139 tokensUpdated yesterday
    Auto-check passed
  • Cad Reference

    Convex-Dev/convex

    Index of the Convex Architecture Documents (CADs), the normative specifications for Convex.

    117 GitHub stars~165 tokensUpdated yesterday
    Auto-check passed
  • Cad3 Encoding

    Convex-Dev/convex

    CAD3 encoding format — cells, embedded vs branch references, value IDs, validity rules.

    117 GitHub stars~164 tokensUpdated yesterday
    Auto-check passed
  • Cns

    Convex-Dev/convex

    Resolve or register Convex Name System (CNS) names. An agent skill from Convex-Dev/convex.

    117 GitHub stars~143 tokensUpdated yesterday
    Auto-check passed
  • Convex DB

    Convex-Dev/convex

    Use Convex DB — a lattice-backed SQL database. An agent skill from Convex-Dev/convex.

    117 GitHub stars~159 tokensUpdated yesterday
    Auto-check passed

Categories

Questions about Local Network

What does Local Network do?

Run isolated local Convex networks and in-process lattice node networks for development. Local Network is an agent skill from Convex-Dev/convex. Run isolated local Convex networks and in-process lattice node networks for development.

When should I use Local Network?

Local Network fits situations like: testing against local peers; reproducing peer; P2P replication issues; exercising NodeServer.

How do I install Local Network in Claude Code?

Run `npx skills add Convex-Dev/convex --skill local-network -a claude-code`. Or copy the skill folder (.agents/skills/local-network in Convex-Dev/convex) into .claude/skills/local-network in your project. Claude Code loads it when a task matches its description.

How do I install Local Network in Codex?

Run `npx skills add Convex-Dev/convex --skill local-network -a codex`. Or copy the skill folder (.agents/skills/local-network in Convex-Dev/convex) into .agents/skills/local-network in your project. Codex loads it when a task matches its description.

Can I use Local Network in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add Convex-Dev/convex --skill local-network -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/local-network, .gemini/skills/local-network, .github/skills/local-network and .opencode/skills/local-network in your project.

What does Local Network need to run?

SKILL.md names no scripts, command-line tools or credentials: Local Network is instructions for the agent only.

Does Local Network access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Local Network safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Local Network use?

Local Network has a licence file (the repository's licence) that doesn't match a standard licence. Read it on GitHub before reusing the skill.

How many tokens does Local Network use?

About 177 tokens (SKILL.md is roughly 708 characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Local Network?

Skills that share tags, products or a category with Local Network: Evolving The Data Model (TriliumNext/Trilium, 38k stars), Hybrid Cloud Outboxes (getsentry/sentry, 45k stars), Iptvnator Sqlite DB Worker (4gray/iptvnator, 7.3k stars) and Replicate Video Ad (Jingyi-Wu-Richael/replicate-video-ad, 106 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Local Network?

Convex-Dev (a GitHub organization) maintains it in Convex-Dev/convex, which has 117 GitHub stars. The repository holds 12 skills in this directory. The repository was last updated on October 6, 2026.

Source: Convex-Dev/convex on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.