New: 98,000+ skills indexed from GitHub repos with 100+ stars · every skill safety-checkedBrowse top skillsTop skills
Esc to closeBrowse all skills
Submit a skillBrowse skills
Submit a skillBrowse skills

Agent skill

Switch Extension Source

by BlackBeltTechnology in BlackBeltTechnology/pi-agent-dashboard

Switch a monorepo extension/skill package between its published npm source and its local working-tree source, guaranteeing exactly one source per package.

MITAuto-check passedDevelopment

Install Switch Extension Source

skills CLI
$ npx skills add BlackBeltTechnology/pi-agent-dashboard --skill switch-extension-source -a claude-code

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

GitHub CLI
$ gh skill install BlackBeltTechnology/pi-agent-dashboard switch-extension-source --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/BlackBeltTechnology/pi-agent-dashboard.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.pi/skills/switch-extension-source .claude/skills/switch-extension-source && 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
switch-extension-source
GitHub stars
315
Token cost
~986 tokens
SKILL.md length
353 words
Files
4 (incl. scripts)
Skills in repo
66
Repo updated
First seen
Licence
MIT

At a glance

Switch a monorepo extension/skill package between its published npm source and its local working-tree source, guaranteeing exactly one source per package.

  • Works in 3 steps: status — see current source per package. → local or npm — flip it. Script… → Re-load: packages[] is read at session…
  • My edits dont take effect
  • SKILL.md covers Why this exists, Commands, Procedure and Pitfalls, plus 1 more section
  • Runs TypeScript scripts from its folder; calls npx, npm and python3

What it does

Switch Extension Source is an agent skill from BlackBeltTechnology/pi-agent-dashboard. Switch a monorepo extension/skill package between its published npm source and its local working-tree source, guaranteeing exactly one source per package. Use when "my edits don't take effect", "load local extension", "test the published npm build", or reconciling dev vs distribution package sources.

Its SKILL.md is about 990 tokens, which your agent loads only when the skill is triggered. The skill folder holds 4 other files, including scripts (for example `SKILL.md.AGENTS.md`, `scripts/switch-source.ts` and `scripts/switch-source.ts.AGENTS.md`). Compatibility notes: Requires npx tsx. Edits ~/.pi/agent/settings.json + .pi/settings.json.

It sits in Development, covering Monorepo tooling. It works with npm. The repository describes itself as: Real-time web dashboard for pi coding-agent sessions. Multi-session view, live chat mirroring, integrated terminal, diff viewer, pi-flows execution, and mobile-first remote… The licence is MIT.

When your agent uses it

  • My edits dont take effect
  • Load local extension
  • Test the published npm build
  • Reconciling dev vs distribution package sources

Example prompts

  • “my edits don”
  • “load local extension”
  • “test the published npm build”
  • “/switch-extension-source”

Requirements

  • Python 3
  • Node.js
  • Compatibility (from SKILL.md): Requires npx tsx. Edits ~/.pi/agent/settings.json + .pi/settings.json.

Workflow steps

3 steps, taken from the first numbered list in SKILL.md.

  1. status — see current source per package.
  2. local or npm — flip it. Script guarantees single-source.
  3. Re-load: packages[] is read at session init, so the change takes effect on the

What it can do on your machine

Read from SKILL.md and the folder at commit e23e533. 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

    Ships 2 files in scripts/ (TypeScript), which the agent can run.

    Shell commands in SKILL.md call:

    • npx
    • npm
    • python3

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

  • Network

    No URLs in SKILL.md. Its commands use npx and npm, which can reach the network depending on how they are called.

    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.

  • Compatibility

    Requires npx tsx. Edits ~/.pi/agent/settings.json + .pi/settings.json.

    From compatibility in the SKILL.md frontmatter.

Context cost

Switch Extension Source loads about 986 tokens when it runs. Until then it costs about 81 tokens; SKILL.md has 353 words of instructions outside code blocks.

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

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); the scripts in this folder are not scanned.

SKILL.md

The full file from BlackBeltTechnology/pi-agent-dashboard at commit e23e533, republished under its MIT licence (© BlackBeltTechnology). 353 words, ~986 tokens.

Download SKILL.mdSave it as .claude/skills/switch-extension-source/SKILL.md (or your agent's skills folder). This skill also uses 3 other files; get the full folder from GitHub.
name
switch-extension-source
description
Switch a monorepo extension/skill package between its published npm source and its local working-tree source, guaranteeing exactly one source per package. Use when "my edits don't take effect", "load local extension", "test the published npm build", or reconciling dev vs distribution package sources.
compatibility
Requires npx tsx. Edits ~/.pi/agent/settings.json + .pi/settings.json.
license
MIT
metadata.author
pi-dashboard
metadata.version
1.0

Toggle a monorepo extension between npm (published) and local (working tree) source.

Why this exists

GUI equivalent: Settings → Packages exposes a per-row Reset to published version action (change: reset-override-to-npm) that resets a local/git-installed row back to its canonical npm:<name> — install-first / remove-second, confirm-gated. It is the one-click UI analog of switch <pkg> npm here; keep the two semantically aligned (both drop the local packages[] registration only, never the working-tree files).

On a dev machine you want extensions to load your live working tree so edits take effect. Distribution users consume the published npm package. Both can be wired at once across two config layers, and whichever pi resolves last wins — non-deterministic ("I edited it but nothing changed"). This skill enforces exactly one source per package.

  GLOBAL ~/.pi/agent/settings.json   "packages": [...]
    npm   -> "npm:<npmName>"
    local -> "<repoRoot>/packages/<dir>"      (dir path; pi resolves package.json "pi")

  PROJECT <repo>/.pi/settings.json   "packages":[{ source, extensions:["+packages/<dir>/<entry>"] }]
    local overlay -> only with --overlay; loads ONLY inside this repo; needs pi.extensions

local (default) = global dir path → loads in every session everywhere. local --overlay = project overlay → loads only when running pi inside this repo.

Commands

bash
npx tsx ./scripts/switch-source.ts status               # where each installed pkg loads from
npx tsx ./scripts/switch-source.ts local <pkg>          # -> local working tree (global path)
npx tsx ./scripts/switch-source.ts local <pkg> --overlay# -> local, this-repo-only (extensions only)
npx tsx ./scripts/switch-source.ts npm   <pkg>          # -> published npm build

<pkg> = monorepo dir name (kb-extension) OR npm name (@blackbelt-technology/pi-dashboard-kb-extension).

Each switch removes all other representations of that package, timestamped-backs-up every file it edits (*.bak-switch-*), and re-validates JSON before writing.

Procedure

  1. status — see current source per package.
  2. local <pkg> or npm <pkg> — flip it. Script guarantees single-source.
  3. Re-load: packages[] is read at session init, so the change takes effect on the next session start. Respawn sessions or npm run reload (reload alone may not re-resolve the package list in an already-running process — fresh session is the guaranteed path).
Show full SKILL.md (116 more words)Show less

Pitfalls

  • Bridge plugins (flows/goal/automation) are dashboard-managed via dashboardPluginBridges / _dashboardManagedPackages. This skill does NOT toggle those — leave them to the dashboard UI.
  • npm copy is a frozen snapshot, not a symlink to your monorepo. After npm mode your working-tree edits do NOT load until you local again.
  • --overlay needs pi.extensions — skill-only packages (pi.skills, no extensions) can't use the overlay form; use plain local (global dir path).
  • Same package wired in both layers = non-deterministic load order. Always end with status showing one source.

Verification

  • npx tsx ./scripts/switch-source.ts status shows the target package at exactly one source.
  • python3 -c "import json; json.load(open('<file>'))" confirms both settings files are valid JSON.
  • Respawn a session; the extension loads from the chosen source.

© BlackBeltTechnology, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 3 other files (scripts) in .pi/skills/switch-extension-source of BlackBeltTechnology/pi-agent-dashboard.

  • SKILL.md
  • SKILL.md.AGENTS.md
  • scripts/switch-source.ts
  • scripts/switch-source.ts.AGENTS.md

Open the folder on GitHubat commit e23e533

Compare with similar skills

Switch Extension Source 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.

Switch Extension Source compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Switch Extension Source this skillBlackBeltTechnology/pi-agent-dashboard315—~986Automated safety check: PassMIT
Nx Run Tasksnomcopter/react-mosaic4.8k8 repos~613Automated safety check: PassCustom licence
Migrate Internal Package into GhostTryGhost/Ghost55k—~3.8kAutomated safety check: PassMIT
Cutting A ReleaseTriliumNext/Trilium38k—~3.2kAutomated safety check: PassAGPL-3.0
Link Workspace Packagesnomcopter/react-mosaic4.8k6 repos~760Automated safety check: PassCustom licence
Building And VerifyingNangoHQ/nango13k—~902Automated safety check: PassCustom licence

Similar skills

  • Nx Run Tasks

    nomcopter/react-mosaic

    Helps with running tasks in an Nx workspace. An agent skill from nomcopter/react-mosaic.

    4.8k GitHub starsUsed in 8 repos~613 tokens
    DevelopmentAuto-check passed

  • Migrate Internal Package into Ghost

    TryGhost/Ghost

    Moves a package from another TryGhost repository into Ghost as an internal workspace package while keeping its Git history, with checkpoints for the steps that need an administrator.

    55k GitHub stars~3.8k tokensUpdated today
    DevelopmentAuto-check passed

  • Cutting A Release

    TriliumNext/Trilium

    A skill your agent uses when cutting, preparing, or debugging a Trilium release — bumping the monorepo version, tagging, or diagnosing a failed "Release" workflow run.

    38k GitHub stars~3.2k tokensUpdated today
    DevelopmentAuto-check passed

  • Link Workspace Packages

    nomcopter/react-mosaic

    Link workspace packages in monorepos (npm, yarn, pnpm, bun).

    4.8k GitHub starsUsed in 6 repos~760 tokens
    DevelopmentAuto-check passed

  • Building And Verifying

    NangoHQ/nango

    A skill your agent uses when building the Nango monorepo or verifying TypeScript compilation - covers build commands, project references, common tsc errors, and package dependency order

    13k GitHub stars~902 tokensUpdated today
    DevelopmentAuto-check passed

  • Update Est Fixtures

    ethereumjs/ethereumjs-monorepo

    Updates EthereumJS execution-spec test fixtures from an ethereum/execution-specs release, then (after a human merge) points the monorepo submodule, updates VM npm scripts, reports a first test run…

    2.8k GitHub stars~3.3k tokensUpdated 20 days ago
    DevelopmentAuto-check passed

More from BlackBeltTechnology/pi-agent-dashboard

All 66 skills in this repo

  • Browser

    BlackBeltTechnology/pi-agent-dashboard

    Browser automation via the agent-browser CLI. An agent skill from BlackBeltTechnology/pi-agent-dashboard.

    315 GitHub starsUsed in 1 repo~2k tokens
    Auto-check passed

  • Pi Dashboard

    BlackBeltTechnology/pi-agent-dashboard

    Monitor and control the pi-dashboard server. An agent skill from BlackBeltTechnology/pi-agent-dashboard.

    315 GitHub starsUsed in 1 repo~2.2k tokens
    Auto-check passed

  • CI Troubleshoot

    BlackBeltTechnology/pi-agent-dashboard

    Diagnose failed GitHub Actions runs for pi-agent-dashboard: the 11-file workflow taxonomy, affected-test selection, the release pipeline, known failure modes, and how to read gh run logs and…

    315 GitHub stars~3.5k tokensUpdated today
    Auto-check passed

  • Debug Dashboard

    BlackBeltTechnology/pi-agent-dashboard

    Diagnose problems in the running pi-agent-dashboard system: server.log, /api/health, bridge WebSocket connectivity, vitest triage, known-issue FAQ entries.

    315 GitHub stars~1.6k tokensUpdated today
    Auto-check passed

  • Implement

    BlackBeltTechnology/pi-agent-dashboard

    Disciplined implementation in pi-agent-dashboard: the rebuild matrix (extension→reload, server→restart, client→build+restart, openspec-apply→full rebuild) plus the project's code discipline rules.

    315 GitHub stars~2k tokensUpdated today
    Auto-check passed

  • Session To Guideline

    BlackBeltTechnology/pi-agent-dashboard

    Turn a pi session into a Markdown "how-we-did-it" collaboration guideline: reads the session's JSONL transcript and synthesizes a reusable playbook of which prompts worked, what had to be steered…

    315 GitHub stars~3.2k tokensUpdated today
    Auto-check passed

Works with

Categories

Questions about Switch Extension Source

What does Switch Extension Source do?

Switch a monorepo extension/skill package between its published npm source and its local working-tree source, guaranteeing exactly one source per package. Switch Extension Source is an agent skill from BlackBeltTechnology/pi-agent-dashboard. Switch a monorepo extension/skill package between its published npm source and its local working-tree source, guaranteeing exactly one source per package.

When should I use Switch Extension Source?

Switch Extension Source fits situations like: my edits dont take effect; load local extension; test the published npm build; reconciling dev vs distribution package sources.

How do I install Switch Extension Source in Claude Code?

Run `npx skills add BlackBeltTechnology/pi-agent-dashboard --skill switch-extension-source -a claude-code`. Or copy the skill folder (.pi/skills/switch-extension-source in BlackBeltTechnology/pi-agent-dashboard) into .claude/skills/switch-extension-source in your project. Claude Code loads it when a task matches its description.

How do I install Switch Extension Source in Codex?

Run `npx skills add BlackBeltTechnology/pi-agent-dashboard --skill switch-extension-source -a codex`. Or copy the skill folder (.pi/skills/switch-extension-source in BlackBeltTechnology/pi-agent-dashboard) into .agents/skills/switch-extension-source in your project. Codex loads it when a task matches its description.

Can I use Switch Extension Source 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 BlackBeltTechnology/pi-agent-dashboard --skill switch-extension-source -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/switch-extension-source, .gemini/skills/switch-extension-source, .github/skills/switch-extension-source and .opencode/skills/switch-extension-source in your project.

What does Switch Extension Source need to run?

Going by SKILL.md and its folder, Switch Extension Source needs TypeScript for the scripts in its folder and the command-line tools its instructions call (npx, npm and python3). Our summary lists: Python 3; Node.js. Compatibility (from SKILL.md): Requires npx tsx. Edits ~/.pi/agent/settings.json + .pi/settings.json..

Does Switch Extension Source access the network?

SKILL.md contains no URLs. Its commands use npx and npm, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Switch Extension Source 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. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Switch Extension Source use?

Switch Extension Source is published under the MIT licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Switch Extension Source use?

About 986 tokens (SKILL.md is roughly 3.9k 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 Switch Extension Source?

Skills that share tags, products or a category with Switch Extension Source: Nx Run Tasks (nomcopter/react-mosaic, 4.8k stars), Migrate Internal Package into Ghost (TryGhost/Ghost, 55k stars), Cutting A Release (TriliumNext/Trilium, 38k stars) and Link Workspace Packages (nomcopter/react-mosaic, 4.8k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Switch Extension Source?

BlackBeltTechnology (a GitHub organization) maintains it in BlackBeltTechnology/pi-agent-dashboard, which has 315 GitHub stars. The repository holds 66 skills in this directory. The repository was last updated on October 8, 2026.

Source: BlackBeltTechnology/pi-agent-dashboard on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.