Banshan Skill Hub

Banshan Skill Hub is a desktop plugin for importing, organizing, and installing AI agent skills from a vault-managed library.

Use it when you collect reusable agent skills from GitHub, local folders, or npx skills add ..., and want a visual place to manage them before installing selected skills into an agent workspace.

Who It Is For

• People who maintain a personal or team library of AI agent skills.
• Codex and agent users who frequently install skills into .agents/skills.
• Skill authors who want to test, group, and reuse skill folders across projects.
• Workflow builders who want curated collections of skills for coding, research, writing, debugging, or other recurring tasks.

What It Can Do

Import Skills

Skill Hub can import skills from three sources:

• GitHub import: Enter a GitHub URL that points to a directory containing a skills/ folder. Skill Hub lists the skills it finds there and lets you choose which ones to import. It does not fall back to downloading a full repository ZIP.
• Local scan: Choose a local folder and scan for either skills/ or .agents/skills/. If neither exists, Skill Hub shows a notice instead of guessing.
• npx import: Paste a command such as:

npx skills add https://github.com/vercel-labs/skills --skill find-skills

Automatic npx execution is controlled by plugin settings. When execution is disabled or unavailable, Skill Hub can still show the command path so you can run it yourself.

Imported skills are copied into the vault skill folder, which defaults to Skill/ and can be changed in settings. If a folder name already exists, Skill Hub creates a collision-safe name instead of overwriting existing files.

Manage Skills

The Skill Hub view presents imported skills as visual blocks. You can:

• Rename skills with a local nickname.
• Choose an emoji.
• Assign tags and tag colors.
• Pick a block color.
• View details, history, warnings, and source information.
• Delete skills with confirmation.
• Select multiple skills with a purple glow state instead of checkboxes.

Organize Collections

Collections are workflow groups for related skills. You can:

• Create named collections with descriptions and colors.
• Drag skills into collections.
• Reorder skills inside a collection for workflow order.
• Remove skills from a collection by dragging them out or from the collection edit window.
• Install, edit, view, or delete collections from the collection block actions.
• Include collections in bulk selection and install flows.

Install Skills Into Agent Workspaces

Skill Hub installs selected skills into a target workspace under:

.agents/skills/

When needed, it creates .agents/skills in the chosen target directory.

You can install by:

• Clicking the install action on one skill.
• Clicking the install action on one collection.
• Selecting multiple skills and collections.
• Clicking install with no active selection, then choosing from a checklist.

The install method is configurable:

• Copy: Copies skill folders into .agents/skills.
• Symlink: Links installed skills back to the vault copy, so updates in the vault are reflected in the target workspace.

Symlink creation depends on OS permissions. On Windows, Developer Mode or elevated permissions may be required.

How To Use

1. Install and enable Banshan Skill Hub.
2. Open the Skill Hub view from the ribbon or command palette.
3. Import skills from GitHub, a local folder, or an npx skills add ... command.
4. Edit skill names, colors, emojis, and tags as needed.
5. Create collections for workflows or skill types.
6. Select skills or collections, then click Install.
7. Choose the target project folder in the native folder picker.
8. Skill Hub installs the chosen skills into .agents/skills.

Settings

Skill Hub settings include:

• Skill folder: Vault folder used for imported skill copies. Default: Skill/.
• Install method: Copy or symlink.
• Default sort: Nickname, original name, recently updated, or custom drag order.
• Enable npx execution: Controls whether Skill Hub can run npx skills add ... directly.
• Symlink conflict behavior: Skip or overwrite existing symlinks.

Notes And Limitations

• Skill Hub is desktop-only because it uses local filesystem access and native folder picking.
• GitHub import expects a skills/ folder at the directory pointed to by the URL.
• Local scan expects either skills/ or .agents/skills/ under the chosen directory.
• Empty folders may not be selectable through the native folder picker because the browser-style directory input needs at least one file to expose a path.
• The target workspace must allow Skill Hub to create .agents/skills and copy or link skill files.

Development

Install dependencies:

npm install

Run tests:

npm test

Build the plugin:

npm run build

The build writes the plugin to:

.obsidian/plugins/banshan-skillhub/

It also syncs the root main.js bundle for release tracking.

Roadmap

Planned future directions:

• Skill graph: Visualize skill coverage, relationships, workflow inclusion, and duplicates.
• Analytics dashboard: Track skill usage, install frequency, and per-skill history.
• Capability suggestions: Suggest missing skills or combinations of existing skills for new workflows.
• Skill update workflow: Detect and apply upstream changes safely.
• Private GitHub support: Use tokens for private repositories when needed.
• Sidecar metadata: Store richer metadata alongside imported skills.
• Collection templates: Share reusable workflow bundles across vaults or projects.