SkillBridge installs and manages portable Agent Skills (SKILL.md) from GitHub for VS Code GitHub Copilot Chat / Agent Mode.
It is designed for both simple skills and complex Claude Code-style skill packs such as repositories with:
.claude-plugin/
skills/<skill>/SKILL.md
agents/*.md
scripts/*.py
schema/
pdf/
extensions/
What it does
- Install a skill or whole skill pack from a GitHub URL.
- Detect
SKILL.mdfiles under common layouts:skills/<name>/SKILL.md.github/skills/<name>/SKILL.md.claude/skills/<name>/SKILL.md.agents/skills/<name>/SKILL.md- direct
SKILL.md
- Validate required frontmatter (
name,description). - Install to either:
- Workspace:
.github/skills/<name> - User/global:
~/.copilot/skills/<name>
- Workspace:
- Show installed skills in a VS Code activity-bar tree view.
- Activate skills by opening/copying
/skill-name ...for VS Code Chat. - Remove and update installed skills.
- Maintain a
.skillbridge-lock.jsonwith source URL and commit metadata. - Run a basic security scan before copying files.
- For complex packs, copy shared root resources into
.github/skills/.skillbridge/packs/<owner>__<repo>/and adapt bare paths likescripts/foo.pyto the installed path. - Optionally copy Claude-format
agents/*.mdinto workspace.claude/agentsso VS Code can discover them as custom agents.
Usage
-
Open a workspace in VS Code.
-
Run SkillBridge: Install Skill from GitHub.
-
Paste a GitHub URL, for example:
https://github.com/AgriciDaniel/claude-seo -
Choose install scope:
- Workspace:
.github/skills - User:
~/.copilot/skills
- Workspace:
-
Review validation and security warnings.
-
Install.
-
In VS Code Chat / Agent Mode, type:
/seo audit https://example.comor right-click an installed skill in the SkillBridge tree and choose Activate Skill in Chat.
Security model
SkillBridge does not run remote install.sh, install.ps1, npm install, pip install, or any bundled scripts automatically.
It only clones/copies files after confirmation. You still must review community skills before allowing Copilot/agent tools to run terminal commands, because a skill can instruct an agent to execute scripts.
The scanner flags common risky patterns such as:
curl ... | shInvoke-WebRequest ... | iexrm -rf /sudo- package installs
- credential references
- script files
This is a basic safety net, not a full security audit.
Important limitations
SkillBridge manages files that VS Code/Copilot can discover. It does not modify Copilot's hidden system prompt and cannot force an agent to use a skill if the host agent does not support Agent Skills.
Some Claude Code plugins rely on Claude-specific runtime features. SkillBridge adapts common filesystem layouts and script paths for VS Code, but hooks, MCP servers, and Claude-only plugin behavior may still require Claude Code.
Development
npm install
npm run compile
Press F5 in VS Code to launch an Extension Development Host.
To package:
npm run package