# Setup Agentskills Sdk > Setup or onboard a .NET library project onto AgentSkills.Sdk so its NuGet package ships an agent skill. Use when a maintainer says "setup AgentSkills.Sdk", "add agent skills to my package", "ship a SKILL.md in my nupkg", or asks how to wire AgentSkillBodyFile / AgentSkillReferenceFiles. - **Type:** Skill - **Install:** `agentstack add skill-rebel028-agentskills-sdk-setup-agentskills-sdk` - **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior - **Seller:** [Rebel028](https://agentstack.voostack.com/s/rebel028) - **Installs:** 0 - **Category:** [Agent Skills](https://agentstack.voostack.com/c/agent-skills) - **Latest version:** 0.1.0 - **License:** MIT - **Upstream author:** [Rebel028](https://github.com/Rebel028) - **Source:** https://github.com/Rebel028/AgentSkills.Sdk/tree/master/skills/setup-agentskills-sdk ## Install ```sh agentstack add skill-rebel028-agentskills-sdk-setup-agentskills-sdk ``` Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent. ## About # Setup AgentSkills.Sdk Onboard a Maintainer's library project onto [AgentSkills.Sdk](https://www.nuget.org/packages/AgentSkills.Sdk): package reference, doc-source wiring in the `.csproj`, pack verification. The full property surface is in [references/property-table.md](references/property-table.md) — read it before step 4. ## Step 1 — Pick the target project List `*.csproj` files in the repo (skip `bin/`, `obj/`, test projects). If exactly one packable library project exists, or the conversation already names one, use it. Otherwise ask the Maintainer which project to set up — do not guess. **Done when:** one `.csproj` path is chosen. ## Step 2 — Install the package Check the csproj for ` package AgentSkills.Sdk ``` No version pin — latest stable. Then make sure the reference carries `PrivateAssets="all"` (add it if `dotnet add` didn't). **Done when:** the csproj contains the reference with `PrivateAssets="all"`. ## Step 3 — Version drift guard ```bash dotnet restore ls ~/.nuget/packages/agentskills.sdk/ ``` Compare the installed version's major against the version documented at the top of [references/property-table.md](references/property-table.md). If the majors differ, read `~/.nuget/packages/agentskills.sdk//README.md` and treat it as the authoritative property surface instead of the table. **Done when:** you know which property reference you're working from. ## Step 4 — Choose doc sources Scan the repo for `.md` files (exclude `bin/`, `obj/`, `node_modules/`, `.git/`). Offer candidates: - **Skill Body** (`AgentSkillBodyFile`): one markdown file of agent-facing usage instructions, no frontmatter. Leaving it unset is valid if `` or `` are set — the body is then scaffolded from them. - **Reference docs** (`AgentSkillReferenceFiles`): API docs, guides — propose a glob like `docs/**/*.md`. Ask the Maintainer to confirm or adjust. If no suitable `.md` files exist or they are **outdated**, **inconclusive** or clearly **too small to cover the project**. Ask the Maintainer, and invoke the `author-skill-docs` skill (the Authoring Skill, sibling Maintainer Skill in this repo) to draft them, then continue with the files it produced. **Done when:** a body-file decision (path or scaffold) and a reference-file glob list are agreed. ## Step 5 — Wire the csproj Add to the target csproj. The paths below are **examples only** — substitute the actual paths agreed in step 4; omit `AgentSkillBodyFile` if scaffolding was chosen: ```xml $(MSBuildProjectDirectory)/../docs/agent-instructions.md ``` Then offer the optional extras — one short question each, skip anything declined; details in [references/property-table.md](references/property-table.md): - `AgentSkillAssetFiles` / `AgentSkillScriptFiles` — config templates, diagnostic scripts - `AgentSkillIncludeXmlDocs` — ship the compiler XML doc file as a greppable `references/api-docs.xml` (auto-enables doc generation, suppresses CS1591) - `AgentSkillNameOverride` / `AgentSkillDescriptionOverride` — identity tuning - `AgentSkillUserInvocable` / `AgentSkillContextStrategy` — Claude Code extensions - `AgentSkillsConsumerFlag` — rename the Consumer Flag **Done when:** the csproj edits are saved and every extra was offered exactly once. ## Step 6 — Verify the pack ```bash dotnet pack -c Release unzip -l .nupkg | grep -E 'agent-assets/|build/' ``` The nupkg must contain `agent-assets/SKILL.claude.md`, `agent-assets/SKILL.agents.md`, and `build/.targets` (plus `agent-assets/payload/references/...` when reference files were wired). On an AGSK error, apply the fix and re-pack: | Error | Fix | |---|---| | AGSK001 | Skill name over 64 chars — set `AgentSkillNameOverride` to a short `[a-z0-9-]` name | | AGSK002 | Override violates name rules — 1–64 chars, `[a-z0-9-]`, no leading/trailing/double hyphens | | AGSK003 | `AgentSkillBodyFile` points at a missing file — fix the path | | AGSK004 | Description over 1024 chars — shorten `AgentSkillDescriptionOverride` | | AGSK005 | `AgentSkillFullFile` points at a missing file — fix the path | | AGSK006 | Both `AgentSkillFullFile` and `AgentSkillBodyFile` set — remove one | **Done when:** pack succeeds and both `agent-assets/` entries and the `.targets` file are listed. ## Step 7 — Hand over the consumer snippet Tell the Maintainer the Consumer Flag name (PackageId minus non-alphanumerics + `AgentSkills`, unless renamed) and show the opt-in their consumers use: ```xml claude-code;universal ``` **Done when:** the snippet with the real flag name has been shown to the Maintainer. ## Source & license This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code. - **Author:** [Rebel028](https://github.com/Rebel028) - **Source:** [Rebel028/AgentSkills.Sdk](https://github.com/Rebel028/AgentSkills.Sdk) - **License:** MIT Install and usage instructions live in the source repository linked above. ## Pricing - **Free** — Free ## Security capabilities Automated source analysis of v0.1.0 — what this tool can access: - **Network access:** no - **Filesystem access:** no - **Shell / process execution:** no - **Environment & secrets:** no - **Dynamic code execution:** no *"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.* ## Versions - **0.1.0** — security scan: passed — Imported from the upstream source. ## Links - Listing page: https://agentstack.voostack.com/l/skill-rebel028-agentskills-sdk-setup-agentskills-sdk - Seller: https://agentstack.voostack.com/s/rebel028 - Browse the marketplace: https://agentstack.voostack.com/browse --- Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.