Skip to content
skill-manager-guide logo

Skill Manager for Copilot — User Guide

skill-manager-guide

**GUIDE SKILL** — Guide to the Skill Manager for Copilot extension. USE FOR: adding/removing skill repos, syncing skills, pushing feedback, configuring sync intervals, troubleshooting sync issues, understanding skill format. DO NOT USE FOR: creating new skills (use skill-creator), creating agents...

SKILL.md

Full skill instructions

Skill Manager for Copilot — User Guide

You are helping a developer who uses the Skill Manager for Copilot VS Code extension. This skill teaches you how the extension works so you can guide them effectively.

What is a Skill?

A skill is a Markdown file (SKILL.md) that gives you (the AI agent) domain-specific knowledge. Skills are organized in Git repositories and synced to the developer's local workspace via this extension.

Extension Commands

CommandWhat it does
Skills: Add RepositoryAdds a Git repo URL as a skill source
Skills: Add Official RepositoryAdds the curated official skill repo
Skills: Remove RepositoryRemoves a previously added repo
Skills: Pull AllSyncs all skills from all configured repos
Skills: Pull RepoSyncs skills from a specific repo
Skills: Push FeedbackSends local feedback to the repo via branch + PR
Skills: StatusShows sync status of all skills
Skills: Enable SkillRe-enables a disabled skill (including workspace-disabled)
Skills: Disable SkillDisables a skill without deleting it
Skills: Enable AgentRe-enables a disabled agent (including workspace-disabled)
Skills: Disable AgentDisables an agent without deleting it
Skills: Move Agent to WorkspaceMoves an agent from global to the current workspace
Skills: Move Agent to GlobalMoves an agent from workspace back to global
Skills: Browse CatalogOpens the skill catalog in the browser

How Sync Works

  1. The extension clones configured repos to a local cache.
  2. On Pull, it copies skills from <repo>/​skills/<name>/ to the workspace's .github/​skills/ directory.
  3. Each synced skill gets a .manifest.json tracking its origin and hash.
  4. If the local copy hasn't been edited, it auto-updates on next pull.
  5. If the local copy was edited, the conflict strategy kicks in (configurable).

Configuration

Users configure the extension in VS Code settings (skillManager.*):

{
  // List of skill repositories
  "skillManager.repos": [
    { "name": "Official", "url": "https://github.com/​AllanSantos-DV/​skill-kit.git", "priority": 1 },
    { "name": "Team", "url": "https://github.com/​my-org/​team-skills.git", "priority": 2 }
  ],

  // Auto-sync interval in minutes (0 = disabled)
  "skillManager.syncIntervalMinutes": 30,

  // What to do when same skill exists in multiple repos
  // "highest-priority" | "ask" | "keep-local"
  "skillManager.conflictStrategy": "highest-priority",

  // What to do when local skill was edited and repo has update
  // "keep-local" | "overwrite" | "ask"
  "skillManager.localEditStrategy": "ask"
}

Skill Structure

Every skill lives in a folder under skills/ in the repo:

skills/
  my-skill/
    SKILL.md            ← Required: the skill content (you read this)
    FEEDBACK.md         ← Optional: feedback protocol for this skill
    references/         ← Optional: extra docs loaded on-demand
      api-reference.md
      examples.md

SKILL.md Frontmatter

---
name: my-skill
description: What this skill teaches
---

Supported attributes: name, description, argument-hint, compatibility, disable-model-invocation, license, metadata, user-invocable.

Version Convention

  • Patch (1.0.0 → 1.0.1): typos, clarifications
  • Minor (1.0.1 → 1.1.0): new scenarios, improvements
  • Major (1.1.0 → 2.0.0): fundamental rewrites

Feedback Flow

If a skill has FEEDBACK.md, users can submit improvements:

  1. Developer writes feedback in the local skill directory
  2. Skills: Push Feedback creates a branch and pushes
  3. A PR is created on the skill repo for the maintainer to review

Sidebar & Status

  • The Skill Manager sidebar shows all skills grouped by repo
  • Icons indicate state: ✓ synced, ↑ local-only, ⊘ disabled
  • The status bar shows overall sync state: synced, divergent, error, or syncing
  • Skills with benchmark reports show a 📊 icon; reports are centralized in ~/​.copilot/​skill-benchmarks/

Scoped Disable & Remove (Skills and Agents)

When disabling or removing a global skill or agent, the extension prompts "Global or this workspace?":

  • Global — disables/​removes for all workspaces. Persisted in placements.json (survives .excluded.json cleanup).
  • This workspace — disables only in the current workspace. The item remains visible in other workspaces.

Re-enabling a workspace-disabled item (via Enable Skill or Enable Agent) reactivates it by removing the workspace entry from placements.json.

Moving Agents Between Scopes

Just like skills, agents can be moved between global and workspace scope:

  • Move to Workspace — copies the agent file to .github/​agents/ in the current workspace and removes from global. Tracked in placements.json.
  • Move to Global — copies the agent file back to ~/​.copilot/​agents/ and removes from workspace. Tracked in placements.json.

On next Pull, the sync respects these decisions — an agent moved to a workspace is not reinstalled globally.

Benchmark Reports

Benchmark reports are centralized in ~/​.copilot/​skill-benchmarks/. When pulling from a repo that contains benchmarks (under skill-benchmarks/), results are:

  1. Copied to the global benchmarks directory
  2. Registered in placements.json for quick lookup
  3. Accessible from the sidebar via the 📊 icon or the benchmark command

When the User Asks for Help

  • "How do I add a skill repo?" → Ctrl+Shift+P → Skills: Add Repository → paste the Git URL
  • "My skills aren't updating" → Run Skills: Pull All, check status bar for errors
  • "How do I disable a skill?" → Right-click the skill in sidebar → Disable Skill
  • "How do I create my own skill?" → Create a folder under skills/ with a SKILL.md containing frontmatter + content
  • "How do I submit improvements?" → Edit the local skill, then Skills: Push Feedback

More skills from gabrielmoreira

workflow-router logo
gabrielmoreira/agent-skills-mirror

workflow-router

研发工作流入口 - 帮助用户快速进入正确的工作流阶段。 触发关键词: 工作流, 流程, 从哪开始, 帮我, 我该怎么做, 下一步, workflow, 不知道用什么, 新手引导, 怎么用

19 0
View
平台架构知识 logo
gabrielmoreira/agent-skills-mirror

平台架构知识

Periodically refreshed mirror of agents, skills, prompts and instruction files from public repositories.

19 0
View
unity-profiler logo
gabrielmoreira/agent-skills-mirror

unity-profiler

Read-only Unity runtime performance snapshots — FPS, frame time, batches/draw calls, triangles/vertices, memory (total/mono/per-asset), object counts, AssetBundle stats. Exact signatures via GET /skills/schema.

19 0
View
ads-audit logo
gabrielmoreira/agent-skills-mirror

ads-audit

Full multi-platform paid advertising audit with parallel subagent delegation. Analyzes Google Ads, Meta Ads, LinkedIn Ads, TikTok Ads, Microsoft Ads, and Apple Ads accounts via 6 parallel audit agents. Amazon Ads, cross-platform attribution, and server-side tracking are covered by their standalon...

19 0
View
unity-skills logo
gabrielmoreira/agent-skills-mirror

unity-skills

Unity Editor automation via REST API — create scripts, analyze scenes, manage assets, control editor, orchestrate workflows, run batch jobs, and route by Unity version. Triggers: Unity, Unity Skills, in Unity, automate Unity, Unity editor automation, create Unity script, scene summary, analyze Un...

19 0
View
purple-cow-audit logo
gabrielmoreira/agent-skills-mirror

purple-cow-audit

Score product remarkability 1-10 to decide if it's worth promoting. Seth Godin's Purple Cow test. Triggers on: "is this product worth promoting", "should I promote", "product audit", "purple cow", "remarkable product", "is it remarkable", "rate this product", "product quality check", "worth my re...

19 0
View
unity-cleaner logo
gabrielmoreira/agent-skills-mirror

unity-cleaner

Project cleanup and audit — find unused assets, content-hash duplicates, missing references, empty folders, large assets, dependency trees; two-step confirm-token delete. Exact signatures via GET /skills/schema.

19 0
View
configure-nightwatch logo
gabrielmoreira/agent-skills-mirror

configure-nightwatch

Configures Laravel Nightwatch data collection, sampling rates, filtering rules, and redaction policies. Use when setting up Nightwatch, managing data volume, protecting sensitive data (PII), or optimizing event collection for production workloads.

19 0
View
research-and-write logo
gabrielmoreira/agent-skills-mirror

research-and-write

End-to-end workflow: research a topic and then write a LinkedIn post about it. Use this skill whenever the user wants the full pipeline — from a topic idea to a finished LinkedIn post. Triggers on: 'research and write a post about', 'create a LinkedIn post about [topic]', 'I want to post about', ...

19 0
View
AI Tutor Persona logo
gabrielmoreira/agent-skills-mirror

AI Tutor Persona

Periodically refreshed mirror of agents, skills, prompts and instruction files from public repositories.

19 0
View
unity-importer logo
gabrielmoreira/agent-skills-mirror

unity-importer

Asset import settings — texture/audio/model importers, sprite settings, per-platform overrides, and reimport. Exact signatures via GET /skills/schema.

19 0
View

Popular AI tools

Kaiber logo
Video

Kaiber

Generate, edit, and beat-sync AI video with leading models in one workspace.

Paid
View
Vimcal logo
Productivity

Vimcal

The world's fastest calendar for remote work

Free
View

Transform Your Design with AI Designer by ImgCreator.ai

Freemium
View
Akool AI logo
Content & writing

Akool AI

Revolutionizing Video Production with AI-Powered Creativity

Paid
View

Extend an image past the frame and let AI fill the new aspect ratio.

Freemium
View
StarByFace logo
Security

StarByFace

Discover your celebrity doppelgänger with StarByFace!

Free
View
C

ChainClarity explains 700+ crypto whitepapers in plain English, with layered summaries, comparisons, research tools, alerts, and a $4.99 Pro plan.

Freemium
View
Opus Clip logo
Coding & apps

Opus Clip

Opus.ai: Revolutionize Your Web Experience

Free
View