Install Agent Skill

VS Code extension for installing Markdown-based agent skills from the Explorer context menu.

Features

• Right-click a SKILL.md file or a folder containing SKILL.md and install it as an agent skill.
• Right-click any Markdown file with name and description frontmatter and install it as a skill.
• Select a folder and scan for nested skill Markdown candidates up to depth 3.
• Use the frontmatter name as the default install folder name, with a prompt to override it before copying.
• Optionally rewrite the installed SKILL.md frontmatter name when the install name differs.
• Install to one or more selected destinations in a single flow.
• Handle single-destination conflicts with replace, install-as-new-name, or cancel.
• Handle multi-destination conflicts with replace existing, skip existing, or cancel.
• Add, remove, and set default install destinations from the command palette.
• Install to built-in Codex, Claude, Gemini, Windsurf, and OpenCode locations, or any custom folder.
• Validate frontmatter before installation.

Skill Format

---
name: my-skill
description: Use when a user needs this workflow.
---

Skill instructions go here.

Commands

• Install as Agent Skill...
• Open Installed Agent Skills Folder
• Add Agent Skill Install Destination
• Manage Agent Skill Install Destinations

Built-In Targets

• Codex user skills: ~/.agents/skills
• Codex local skills: ~/.codex/skills
• Codex repo skills: <workspace>/.agents/skills
• Claude user skills: ~/.claude/skills
• Claude repo skills: <workspace>/.claude/skills
• Gemini user skills: ~/.gemini/skills
• Gemini repo skills: <workspace>/.gemini/skills
• Windsurf user skills: ~/.codeium/windsurf/skills
• Windsurf repo skills: <workspace>/.windsurf/skills
• OpenCode user skills: ~/.config/opencode/skill
• OpenCode repo skills: <workspace>/.opencode/skill
• Named custom destinations: configured with rightClickInstallSkill.customDestinations
• One-off custom folder: choose Choose another folder... during install

The install target picker supports selecting multiple destinations. The extension asks for the skill install name once, then installs the same skill to every selected target.

Agent skill folder conventions can change between tools and versions. If a built-in destination is outdated or your agent uses a different location, add a custom destination and install there instead.

Custom Destinations

Use Add Agent Skill Install Destination from the command palette, or edit settings directly:

{
  "rightClickInstallSkill.customDestinations": [
    {
      "label": "Team agent skills",
      "path": "~/agent-skills",
      "description": "Shared local test destination"
    }
  ],
  "rightClickInstallSkill.defaultProvider": "custom-destination-0"
}

The older rightClickInstallSkill.customSkillRoots array is still supported for plain path-only destinations.

Development

Install dependencies:

pnpm install

Compile:

pnpm run compile

Run tests:

pnpm test

Run the VS Code extension-host smoke test:

pnpm run test:extension

Package a VSIX:

pnpm run package

Publish to the VS Code Marketplace:

1. Replace "publisher": "local" in package.json with your Marketplace publisher ID.
2. Add a real repository field to package.json.
3. Store your Azure DevOps Marketplace PAT as the GitHub Actions secret VSCE_PAT.
4. Run the manual Publish workflow from GitHub Actions.
5. Keep dry_run enabled to package and upload a VSIX artifact only, or disable dry_run to publish to the Marketplace.

Debug in VS Code:

1. Open this project folder.
2. Press F5.
3. In the Extension Development Host, right-click files under examples/.