dotnet-cli-packaging

name	dotnet-cli-packaging
category	operations
subcategory	release
description	Publishes to package managers. Homebrew, apt/deb, winget, Scoop, Chocolatey manifests.
license	MIT
targets	["*"]
tags	["foundation","dotnet","skill"]
version	0.0.1
author	dotnet-agent-harness
invocable	true
claudecode	{"allowed-tools":["Read","Grep","Glob","Bash","Write","Edit"]}
codexcli	{"short-description":".NET skill guidance for foundation tasks"}
opencode	{"allowed-tools":["Read","Grep","Glob","Bash","Write","Edit"]}
copilot	{}
geminicli	{}
antigravity	{}

dotnet-cli-packaging

Multi-platform packaging for .NET CLI tools: Homebrew formula authoring (binary tap and cask), apt/deb packaging with dpkg-deb, winget manifest YAML schema and PR submission to winget-pkgs, Scoop manifest JSON, Chocolatey package creation, dotnet tool global/local packaging, and NuGet distribution.

Version assumptions: .NET 8.0+ baseline. Package manager formats are stable across .NET versions.

Scope

• Homebrew formula authoring (binary tap and cask)
• apt/deb packaging with dpkg-deb
• winget manifest YAML schema and PR submission
• Scoop manifest JSON for Windows
• Chocolatey package creation
• dotnet tool global/local packaging and NuGet distribution

Out of scope

• CLI distribution strategy (AOT vs framework-dependent decision) -- see [skill:dotnet-cli-distribution]
• Release CI/CD pipeline that automates packaging -- see [skill:dotnet-cli-release-pipeline]
• Native AOT compilation -- see [skill:dotnet-native-aot]
• Container-based distribution -- see [skill:dotnet-containers]
• General CI/CD patterns -- see [skill:dotnet-gha-patterns] and [skill:dotnet-ado-patterns]

Cross-references: [skill:dotnet-cli-distribution] for distribution strategy and RID matrix, [skill:dotnet-cli-release-pipeline] for automated package publishing, [skill:dotnet-native-aot] for AOT binary production, [skill:dotnet-containers] for container-based distribution, [skill:dotnet-tool-management] for consumer-side tool installation and manifest management.

---

Homebrew (macOS / Linux)

Homebrew is the primary package manager for macOS and widely used on Linux. Two distribution formats exist for CLI tools.

Binary Tap (Formula)

A formula downloads pre-built binaries per platform. This is the recommended approach for Native AOT CLI tools.

# Formula/mytool.rb
class Mytool < Formula
  desc "A CLI tool for managing widgets"
  homepage "https://github.com/myorg/mytool"
  version "1.2.3"
  license "MIT"

  on_macos do
    on_arm do
      url "https://github.com/myorg/mytool/releases/download/v1.2.3/mytool-1.2.3-osx-arm64.tar.gz"
      sha256 
    
    
    on_intel 
      url 
      sha256 
    
  

  on_linux 
    on_arm 
      url 
      sha256 
    
    on_intel 
      url 
      sha256 
    
  

   
    bin.install 
  

  test 
    assert_match version.to_s, shell_output()
  


homebrew-taptext

myorg/homebrew-tap/
  /
    mytool.rb

bash

brew tap myorg/tap
brew install mytool

ruby


cask  
  version 
  sha256 

  url 
  name 
  homepage 

  binary 


text

mytool_1..3_amd64/
  /
    control
  usr/
    bin/
      mytool

text

: mytool
: .
: utils
: optional
: amd64
:   <dev.com>
: A  tool  managing widgets
  provides fast widget management from the command line.
  with .    zero-dependency execution.
: //usr/binartifacts/linux-x64/mytool/usr/bin/mytool/usr/bin/mytool//control: }.debversion.descriptionA  tool  managing widgetshomepage/1./mytool-.-win-x64.ziphashabc123...arm64url/1./mytool-.-win-arm64.ziphashdef456...binmytool.execheckvergithub//mytool--win-x64.ziparm64url//mytool--win-arm64.ziputf-///nuspecexpression- - ..)...../../.md/ void /src//.cs