Practical overview
When it fits
Use it when you want a CLI-based way to select skills for a compatible coding agent or maintain a categorized personal or team catalog instead of managing an unstructured set of skill folders.
Who it is for
- Developers who want to browse and install reusable skills for a compatible coding agent.
- Individuals curating a focused personal library of agent skills.
- Teams organizing skills into a managed library that can be shared through a repository.
Documented uses
- List and browse skill collections and shelves.
- Install a bundled skill or skills from an upstream repository.
- Create a managed library, categorize entries, and record why each skill is included.
- Import an existing skills directory and generate workspace documentation.
Requirements & limits
The repository is public source code under the MIT license. The documented workflows use npx commands.
- The project distinguishes local bundled copies from upstream catalog entries, which are fetched from their source repositories when requested.
- Default install targets are
~/.claude/skills/globally and.agents/skills/for a project; a legacy agent-specific target can be selected with--agent. - Workspace commands support categorization, curator rationale, importing, syncing, and documentation generation.
Check current requirements in the official documentation. Source-based guidance does not mean OpenViST has run or independently tested this project.
Create and document a managed skills library
Set up a workspace, add a bundled skill with its shelf and rationale, install it, and build library documentation.
Before you start
- Node.js/npm access to run the documented npx commands
- An Agent Skills-compatible agent for using the installed skill
Steps
Run the command below and enter the workspace with
cd my-library.npx ai-agent-skills init-library my-libraryAdd a bundled skill with the command below.
npx ai-agent-skills add frontend-design --area frontend --branch Implementation --why "I want this on my shelf."Install it to the project target with the command below.
npx ai-agent-skills install frontend-design -pGenerate the workspace documentation with the command below.
npx ai-agent-skills build-docs
Expected outcome
A managed workspace with a categorized skill, an installation in the project-level target, and generated library documentation.
Guide limitations
- The documented project target is
.agents/skills/; the global default is~/.claude/skills/. - Agent use requires an Agent Skills-compatible agent.
Import and browse an existing skills repository
Initialize a flat repository of skills as a managed library and browse its imported contents.
Before you start
- An existing local repository or directory of skills
- Node.js/npm access to run the documented npx commands
Steps
Change to the existing skills directory.
Run the command below.
npx ai-agent-skills init-library . --areas "mobile,workflow,agent-engineering" --import --auto-classifyRun the command below.
npx ai-agent-skills browse
Expected outcome
The existing directory is initialized as a library with the specified areas and imported skills available to browse.
Guide limitations
- Invalid private-only names are skipped and reported.
- Low-confidence imports fall back to the workflow area with a needs-curation label.
Compare options for AI coding assistance
These projects document a common task and share a project role. This is a source-based comparison, not an execution benchmark or a guarantee of interchangeability.
| Project | Documented purpose | Platform | Access and requirements |
|---|---|---|---|
| AI Agent Skills | List and browse skill collections and shelves. | CLI | The repository is public source code under the MIT license. The documented workflows use npx commands. |
| Dexto | Define agents in YAML with a model, tools, storage and permissions. | CLI |
Sources & review
Source record details
- Source availability
- Active
- Sources checked
- 11 October 2026
- Original website title
- MoizIbnYousaf/ai-agent-skills · Official homepage title · retained in its source language

