https://github.com/mackysoft/agent-skills
Agent Skills generation and distribution tooling.
https://github.com/mackysoft/agent-skills
Last synced: 30 days ago
JSON representation
Agent Skills generation and distribution tooling.
- Host: GitHub
- URL: https://github.com/mackysoft/agent-skills
- Owner: mackysoft
- License: mit
- Created: 2026-05-18T19:25:32.000Z (about 2 months ago)
- Default Branch: master
- Last Pushed: 2026-05-19T17:16:39.000Z (about 2 months ago)
- Last Synced: 2026-05-19T18:48:45.690Z (about 2 months ago)
- Language: C#
- Homepage:
- Size: 205 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
- Agents: AGENTS.md
Awesome Lists containing this project
README
# Agent Skills
Agent Skills provides reusable .NET services and a CLI tool for product-owned agent skill packages. Product repositories keep their SKILL definitions and generated package outputs, while this repository owns the canonical package format, host materialization rules, install/update/uninstall/export operations, and doctor diagnostics.
## Packages
| Package | Purpose |
| --- | --- |
| `MackySoft.AgentSkills` | Runtime library for reading generated packages, materializing them for supported hosts, and running install/export/doctor workflows. |
| `MackySoft.AgentSkills.Cli` | .NET tool that generates canonical packages from `skills/definitions` into `skills/generated`. |
Both packages are versioned together.
## Product Layout
Each product repository owns its source definitions and generated outputs.
```text
skills/
definitions/
/
skill.json
SKILL.md.template
references/
*.md.template
generated/
/
SKILL.md
agent-skill.json
agents/
openai.yaml
references/
*.md
```
`skills/definitions` is the source of truth. `skills/generated` is deterministic build output; do not edit it manually.
## CLI Tool
Install the CLI through a .NET tool manifest in each product repository.
```bash
dotnet new tool-manifest
dotnet tool install MackySoft.AgentSkills.Cli --version 0.2.0
```
Generate canonical packages.
```bash
dotnet tool run agent-skills -- build \
--definitionsRoot skills/definitions \
--generatedRoot skills/generated
```
Build options:
- `--definitionsRoot`: directory that contains one subdirectory per source SKILL definition.
- `--generatedRoot`: canonical generated package root, normally `skills/generated`.
The CLI validates definition metadata, computes deterministic digests, writes `agent-skill.json`, and emits host artifact metadata for every supported host.
## Runtime Library
Use the library from product CLI or application code that needs to list, export, install, update, uninstall, or diagnose generated agent skills.
```bash
dotnet add .csproj package MackySoft.AgentSkills --version 0.2.0
```
Equivalent project file reference:
```xml
```
The canonical package manifest file is `agent-skill.json`. Generated package directories are canonical package inputs; runtime materialization converts those packages into host-specific install/export contents.
Supported host keys:
- `openai`
- `claude`
- `copilot`