manage-local-models

manage-local-models is a skill for Claude Code, Codex from understudylabs/understudy-agent-tools. It costs 127 tokens per session (2,511 once invoked), scanned A, original, MIT.

A guide for downloading, storing, organizing, and choosing open-weight language models that run on a developer's computer. Open-weight models are models whose files can be downloaded and used locally.

In plain words
What is it for?
Getting local models, checking available weights, choosing model sizes and quantization, and removing cached models to free disk space.
Why use it?
It prevents unsuitable or oversized downloads and explains where model files live, how their formats differ, and when licenses or tokens are needed.

Skill for Claude CodeCodex

Part of the understudy plugin — 43 skills, 1 command shipped together

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/understudylabs/understudy-agent-tools/manage-local-models
Any agent
npx skills add understudylabs/understudy-agent-tools --skill manage-local-models
Clone the repo
git clone --depth 1 https://github.com/understudylabs/understudy-agent-tools

Made for: Claude Code, Codex.

Or install understudy, the plugin that ships this one along with the rest of its 43 skills, 1 command.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for manage-local-models

README.md
[![agentmods](https://agentmods.dev/badge/skills/understudylabs/understudy-agent-tools/manage-local-models.svg)](https://agentmods.dev/skills/understudylabs/understudy-agent-tools/manage-local-models)
Your own site
<a href="https://agentmods.dev/skills/understudylabs/understudy-agent-tools/manage-local-models"><img src="https://agentmods.dev/badge/skills/understudylabs/understudy-agent-tools/manage-local-models.svg" alt="Measured on agentmods" height="20"></a>
Per session 127 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 2,511 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. 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.00127 $0.02511
Opus 5 $0.00063 $0.01256
Sonnet 5 $0.00025 $0.00502
Haiku 4.5 $0.00013 $0.00251

Measured 4d ago against content hash 8cba127e22bb, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

manage-local-models scanned grade A with 0 findings 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 4d ago.

The scan reads SKILL.md. This mod also ships 1 executable file (scripts/serve-understudy-snapshot.mjs), listed below but not scanned — reading those needs a real analyzer, not pattern matching.

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.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

skills/manage-local-models/SKILL.md · 171 lines

How it starts

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

Manage Local Models

Get open-weight models onto the machine, keep them organized, and teach the user enough to choose well. This skill is acquisition + curation + education; to score a local model against a workload, use ../run-local-model-lab/SKILL.md.

The habit this skill installs: use a small verified model to prove the local loop, then choose the workload candidate from task fit, evidence, hardware, and time. The bootstrap model is not a route recommendation. Skip directly to a stronger rung when a weak-model sequence would delay the answer; big quality lives one understudy route away when you need it.

Safety Gates

  • No download without explicit approval + a size cap. Always state model, quantization, and GB on disk first, then confirm. Weights are large; a wrong pull can fill a disk.
  • Background big pulls. Announce the ETA, start the download in the background, and keep working — do not block the user on a progress bar.
  • Gated weights need consent. Gemma (and some others) require accepting a license and using a Hugging Face token. Walk the user through acceptance; never print, log, or commit the token. The Ollama path serves Gemma without an HF token.
  • Local-first, no upload. Pulling weights is a download only; nothing about the user's data leaves the machine.
  • Make size/spec/price claims from fresh official sources (HF model cards, the Ollama library, vendor pages), never from memory — label anything indicative.

Intake

Read ~/.understudy/profile.json for hardware, installed runtimes, and the user's experience tier (set tone accordingly). Inventory what is already cached before proposing a download — the best pull is often one they already have. Disk locations and registry links are in reference.md.

If the Understudy desktop app is running, prefer its daemon. Check ~/.understudy/agent-card.json and trust the app block only after a pid check on app.pid plus a health probe of <app.base_url>/health (understudy daemon status does exactly this; then run understudy desktop capabilities; schema in ../onboard/reference.md). A running app can start/poll/cancel verified snapshot downloads into the same ~/.understudy/models cache and already serves warm slots (app.warm_models) and exposes them through understudy desktop chat with canonical runtime evidence — reuse it instead of spawning your own MLX servers or a second download of the same weights. The concrete verbs: understudy desktop model list / model catalog (cached snapshots and the bundled certified catalog), slot list|add|assign (residency), download list|start (managed downloads), and chat --slot <id>. If the app is not installed, it ships as GitHub Releases on understudylabs/understudy-agent-tools (macOS Apple Silicon .dmg, tags desktop-v*); the headless CLI covers everything in this skill without it.

Read the full file on GitHub · 171 lines

Files

What ships with it

3 files 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. 4d ago First seen · 171 lines · 127 tokens per session scan A 8cba127e22bb

Subscribe to this mod's changes

manage-local-models is a skill published in the GitHub repository understudylabs/understudy-agent-tools (16 stars, last pushed 3d ago), licensed MIT. It adds 127 tokens to every session and 2,511 once invoked, about $0.0006 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.

Related

Other skills, from other repositories

systematic-debugging

Use when encountering any bug, test failure, or unexpected behavior, before proposing fixes.

obra/superpowers · 21 tokens

brainstorming

You MUST use this before any creative work - creating features, building components, adding functionality, or modifying behavior. Explores user intent, requirements and design before implementation.

obra/superpowers · 37 tokens

auto-perf-optimize

Run agent-driven VS Code performance or memory investigations. Use when asked to launch Code OSS, automate a VS Code scenario, run the Chat memory smoke runner, capture renderer heap snapshots, take workflow screenshots, compare run summaries, or drive a repeatable scenario before heap-snapshot analysis.

microsoft/vscode · 62 tokens

chat-perf

Run chat perf benchmarks and memory leak checks against the local dev build or any published VS Code version. Use when investigating chat rendering regressions, validating perf-sensitive changes to chat UI, or checking for memory leaks in the chat response pipeline.

microsoft/vscode · 51 tokens

chat-pet-sprite-creation

Use when creating or changing VS Code chat pet sprite art, sprite sheets, state animations, eye treatments, Stable/Insiders variants, or pet transitions under src/vs/workbench/contrib/chat/browser/widget/media/chatPet.

microsoft/vscode · 53 tokens

cpu-profile-analysis

Analyze V8/Chrome CPU profiles (.cpuprofile) and DevTools trace files (Trace-.json). Use when: profiling performance, investigating slow functions, comparing code paths, finding bottlenecks, analyzing timeToRequest, understanding call trees from sampling profiler data, analyzing layout/paint/rendering, investigating…

microsoft/vscode · 71 tokens