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
dotnet tool install -g skillz

Both NuGet packages expose the same 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` and `skillz` NuGet packages
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 and dotnet tool install -g skillz both expose 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

for tool in skills skillz; do
  dotnet pack src/Skills.Tool -c Release -o ./artifacts \
    -p:SkillsToolPackageId="$tool"
done

Produces artifacts/skills.<version>.nupkg and artifacts/skillz.<version>.nupkg; both packages install the skills command.

Contributing

Issues and PRs welcome. Before sending a PR:

dotnet build
dotnet test

License

MIT