Skilled — Agent Skills Manager

A Visual Studio Code extension for managing, synchronizing, authoring, and validating agent skills across AI coding frameworks.

Features

• Subscribe to skill repositories — Add any Git repository containing agent skills and keep it in sync automatically.
• Enable / Disable skills — Choose which skills are active without removing them from your local cache.
• Sync to agent frameworks — Push enabled skills to GitHub Copilot, Claude, Cursor, Windsurf, Codex, and Cline at the user level, project level, or both.
• Validate skills — Lint skill definitions and surface actionable errors and warnings directly in the VS Code output panel.
• Author new skills — Scaffold a new SKILL.md file with the required YAML front-matter from a guided prompt.
• Auto-sync — Configurable background polling detects remote updates and prompts you to sync.

Requirements

• Visual Studio Code 1.85.0 or later
• Git installed and available on your PATH

Installation

From the Visual Studio Code Marketplace

1. Open VS Code.
2. Press Ctrl+Shift+X (Windows/Linux) or Cmd+Shift+X (macOS) to open the Extensions view.
3. Search for Skilled.
4. Click Install.

From a .vsix package

1. Download the .vsix file from the Releases page.
2. In VS Code, open the Extensions view (Ctrl+Shift+X / Cmd+Shift+X).
3. Click the ... menu in the top-right corner of the Extensions view and choose Install from VSIX….
4. Select the downloaded .vsix file.

Getting Started

1. After installing, click the Skilled icon in the Activity Bar on the left.
2. Click Add Skill Repository (the + icon) and enter a Git repository URL or local path that contains skills, e.g.:

   https://github.com/org/skills-repo.git
   

3. Skilled clones the repository, discovers all skills, and lists them in the Agent Skills tree view.
4. Enable the skills you want, then click Sync Skills (the sync icon) and choose your target scope.

Skill Format

Each skill lives in its own directory and must contain a SKILL.md file with a YAML front-matter block:

---
name: my-skill
description: A brief description of what this skill does and when to use it.
---

# my-skill

Full skill instructions go here…

Configuration

All settings are available under Settings → Extensions → Skilled or in settings.json:

Commands

All commands are accessible via the Command Palette (Ctrl+Shift+P / Cmd+Shift+P):

Development

Prerequisites

• Node.js 20 or later
• npm (bundled with Node.js)

Setup

git clone https://github.com/fupacat/skilled.git
cd skilled
npm install

Build

npm run compile

Watch mode

npm run watch

Lint

npm run lint

Tests

npm test

Running in VS Code

Press F5 in VS Code to open an Extension Development Host with Skilled loaded.

Packaging

npm run vscode:prepublish
npx @vscode/vsce package

CI/CD Release

This repository includes GitHub Actions workflows for CI and release automation:

• .github/workflows/ci.yml runs lint, compile, and tests on pushes and pull requests to main.
• .github/workflows/release.yml runs on version tags (v*.*.*) and:
  • runs lint, compile, and tests
  • packages the extension (.vsix)
  • generates release notes from git commits
  • creates a GitHub Release
  • publishes to the VS Code Marketplace for stable tags only

Pre-release tags (-alpha, -beta, -rc) are created as GitHub pre-releases and skip Marketplace publish.

Required Secret

Add this repository secret in GitHub Settings -> Secrets and variables -> Actions:

• VSCE_PAT: Azure DevOps Marketplace Personal Access Token with Marketplace (Manage) scope.

Release Commands

First beta release:

git tag -a v0.1.0-beta.1 -m "Initial beta release"
git push origin v0.1.0-beta.1

First stable release:

git tag -a v0.1.0 -m "First stable release"
git push origin v0.1.0

Contributing

Contributions are welcome! Please open an issue or pull request on GitHub.

License

MIT © 2026 Eric Lunde