Skills

A CLI for managing AI agent skills - markdown SKILL.md files with YAML frontmatter that teach AI coding agents how to do specific tasks.

# One-shot run, no install (.NET 10+ SDK)
dnx skills add chillicream/agent-skills

# Or persistent install
dotnet tool install -g skills

The NuGet package exposes the skills command.

End-user documentation - including the full dnx reference - lives in src/Skills.Tool/README.md and is what ships on NuGet.

What it does

• Installs skills from GitHub, GitLab, generic Git repos, or local paths
• Targets 55+ AI coding agents (Claude Code, Cursor, Copilot, Codex, Continue, Gemini CLI, …) - auto-detected on your machine
• Symlinks by default from one canonical location so all agents stay in sync; --copy for agents that don't follow symlinks
• Two scopes: project (skills-lock.json in cwd) and global (XDG state dir)
• Scaffolds new skills with skills init

Repository layout

src/
  Skills/           Main CLI assembly (AOT-publishable binary)
  Skills.Tool/      `dotnet tool` wrapper for the `skills` NuGet package
test/
  Skills.Tests/     Unit tests
  Skills.SmokeTests/ End-to-end smoke tests
Skills.sln          Solution
global.json         .NET SDK pin

Skills.Tool is a thin wrapper that calls into Skills.Program.Main. It exists so dotnet tool install -g skills exposes the skills command while Skills itself can also be AOT-published as a standalone binary for the supported runtime identifiers (linux-x64, linux-arm64, linux-musl-x64, osx-x64, osx-arm64, win-x64, win-arm64).

Build

dotnet build

Targets net8.0 and net9.0. Requires the .NET SDK pinned in global.json.

Test

dotnet test

Run locally

dotnet run --project src/Skills -- add anthropics/skills

Publish AOT

dotnet publish src/Skills -c Release -r linux-x64

Produces a single self-contained skills binary at src/Skills/bin/Release/<tfm>/linux-x64/publish/skills.

Pack the tool

dotnet pack src/Skills.Tool -c Release -o ./artifacts \
  -p:SkillsToolPackageId="skills"

Produces artifacts/skills.<version>.nupkg; the package installs the skills command.

Contributing

Issues and PRs welcome. Before sending a PR:

dotnet build
dotnet test

License

MIT