agentskills-cli 0.2.0-preview.2

This is a prerelease version of agentskills-cli.
There is a newer version of this package available.
See the version list below for details.
dotnet tool install --global agentskills-cli --version 0.2.0-preview.2
                    
This package contains a .NET tool you can call from the shell/command line.
dotnet new tool-manifest
                    
if you are setting up this repo
dotnet tool install --local agentskills-cli --version 0.2.0-preview.2
                    
This package contains a .NET tool you can call from the shell/command line.
#tool dotnet:?package=agentskills-cli&version=0.2.0-preview.2&prerelease
                    
nuke :add-package agentskills-cli --version 0.2.0-preview.2
                    

AgentSkills CLI logo

AgentSkills CLI

The .NET commandline tool for the open Agent Skills ecosystem.

Install skills from GitHub, NuGet, npm, well-known endpoints, or local folders into Claude Code, Cursor, Codex, OpenCode, and any spec-compliant agent.

First-class NuGet & npm · library-bundled skill packages · extension points by design.

📖 Documentation · Why AgentSkills CLI? · Quick start · vs npx skills


Early-access preview (0.2.0-preview.2). Feature-complete and tested, but pre-stable. Refinements expected based on early-user feedback before the stable 0.2.0 release. Open an issue with feedback or bug reports.

Install

# One-shot via dnx (.NET 10+) - preview tag pulled automatically
dnx agentskills-cli --help

# Or as a global tool (.NET 8 LTS or .NET 10)
dotnet tool install --global agentskills-cli --prerelease
agentskills-cli --help

See the install guide for .NET 8 notes, shell aliases (including a function that auto-falls-back to dnx), and verification.

At a glance

# Install from any source - one command, multiple ecosystems
agentskills-cli add anthropics/skills              # GitHub shorthand
agentskills-cli add Contoso.AgentSkills            # NuGet package
agentskills-cli add @my-org/agent-skills           # npm package
agentskills-cli add ./my-local-skill               # local folder

# Inspect what's installed, grouped however you want
agentskills-cli list --by package

# Search community skills
agentskills-cli find testing

# Remove an entire package's worth of skills
agentskills-cli remove @my-org/agent-skills -y

Five-minute quick start →

What makes it different

  • NuGet as a first-class source - public and private feeds via your existing NuGet.config and credential providers. No new auth surface.
  • npm registry fetch (not just node_modules sync) - public and private registries via your existing .npmrc, scoped registries, _authToken.
  • Skills can ship inside library packages - drop a skills/ folder into your existing .nupkg or .tgz. Users get the skills for free when they install your library. How →
  • Extension points by design - register ISkillSourceFactory for new source types and ISkillSearchProvider for new search backends with a single DI registration.
  • Multi-targeted - one .nupkg ships both .NET 8 LTS and .NET 10 builds.
  • Lock-file interop - same ~/.agents/.skill-lock.json and ./skills-lock.json format as upstream vercel-labs/skills, so the two tools share state.

Full feature matrix vs npx skills →

Documentation

Comprehensive guides at mysticmind.github.io/agentskills-cli:

Section What's there
Why AgentSkills CLI The value proposition, condensed
Install dnx, global tool, shell aliases, runtime requirements
Quick start Five-minute hands-on tour
Concepts Skill, source, agent, scope - the five terms
Commands Full reference: add, list, remove, init, find, update
Source formats Local, GitHub, GitLab, git, NuGet, npm, well-known endpoints
Authoring + publishing SKILL.md format + NuGet + npm publishing patterns
Common workflows Bootstrap a project, drive dnx in CI, set up private feeds, etc.
Reference Agents, lock files, env vars, search-provider extension contract
Troubleshooting Common issues with fixes
FAQ The "why is it like that" questions

A .NET-native port of vercel-labs/skills

AgentSkills CLI is a faithful .NET port of vercel-labs/skills (the npx skills CLI). The two tools share the open Agent Skills specification, the same SKILL.md format, the same lock-file format, and the universal .agents/skills/ install directory - so a skill installed by either tool is visible to the other and you can mix toolchains in a polyglot team.

AgentSkills CLI extends the upstream with first-class NuGet support, full npm registry fetch (not just node_modules sync), library-bundled skill packages, version-aware target matching on list / remove, and an extension-point architecture for custom sources and search backends. See the full feature comparison.

Samples

Three working samples under samples/ - a minimal standalone skill, a NuGet package that bundles a skill, and an npm package that does the same. Each has its own README with copy-pasteable verify commands. See the Samples reference for what to try.

Contributing

Issues and PRs welcome at github.com/mysticmind/agentskills-cli. See CHANGELOG.md for release history.

To build from source:

git clone https://github.com/mysticmind/agentskills-cli.git
cd agentskills-cli
dotnet build agentskills-cli.sln
dotnet test agentskills-cli.sln

Requires the .NET 10 SDK (it can build both net8.0 and net10.0 outputs; the .NET 8 SDK cannot build the net10 output).

License

MIT. See LICENSE and NOTICE.

Product Compatible and additional computed target framework versions.
.NET net8.0 is compatible.  net8.0-android was computed.  net8.0-browser was computed.  net8.0-ios was computed.  net8.0-maccatalyst was computed.  net8.0-macos was computed.  net8.0-tvos was computed.  net8.0-windows was computed.  net9.0 was computed.  net9.0-android was computed.  net9.0-browser was computed.  net9.0-ios was computed.  net9.0-maccatalyst was computed.  net9.0-macos was computed.  net9.0-tvos was computed.  net9.0-windows was computed.  net10.0 is compatible.  net10.0-android was computed.  net10.0-browser was computed.  net10.0-ios was computed.  net10.0-maccatalyst was computed.  net10.0-macos was computed.  net10.0-tvos was computed.  net10.0-windows was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

This package has no dependencies.

Version Downloads Last Updated
1.1.0 281 11/5/2026
1.0.0 739 6/3/2026
0.2.2 176 5/26/2026
0.2.1 149 5/26/2026
0.2.0 145 5/25/2026
0.2.0-preview.2 96 5/25/2026
0.2.0-preview.1 99 5/25/2026