Agent Shelf is a VS Code extension for managing reusable agent resources across projects.
Use it to collect agent skills and DESIGN.md files from local folders or Git repositories, then install the ones you need into the current workspace.
Features
- Import skill folders that contain a
SKILL.mdmanifest. - Discover skills from saved local or Git sources.
- Group related skills and install a whole workflow at once.
- Import, discover, update, and apply reusable
DESIGN.mdfiles. - Search imported resources by name, description, or source.
- Check imported resources for upstream changes.
Usage
- Open the Agent Shelf view from the Activity Bar.
- Open Skills library or DESIGN.md library.
- Import local resources, or discover resources from configured sources.
- Click Install or Apply to copy the selected resource into the active workspace.
Skill groups are available from Agent Shelf > Skills > Skill groups. Create a group, add imported skills, then install the group into a project when you need that workflow.
Resource Formats
Skills must be folders with a SKILL.md file containing frontmatter:
---
name: frontend-design
description: Build polished frontend interfaces.
---
DESIGN.md files must include frontmatter with a required name field before they can be imported into Agent Shelf. description is optional, and additional design tokens can follow the DESIGN.md schema.
---
version: alpha
name: Product Dashboard
description: Design guidance for dashboard screens.
---
Settings
| Setting | Default | Description |
|---|---|---|
agentShelf.skills.directories |
[".agents/skills"] |
Workspace-relative directories where installed skills are copied. |
agentShelf.design.md.path |
DESIGN.md |
Workspace-relative path used when applying a stored DESIGN.md. |
Notes
- Git sources require
gitto be available on your PATH. - Installing a skill or applying a
DESIGN.mdwill not overwrite an existing target file or folder.