# SkillsDotNet

> 仓库地址：https://github.com/PederHP/skillsdotnet
> 作者/组织：PederHP
> 成熟度：beta
> 分析日期：2026-04-15

## 一句话总结
agentskills.io 标准的 C# 实现，通过 MCP SDK 提供 skill 的 progressive discovery、加载和分发能力。

## 项目定位与架构
SkillsDotNet 将 agentskills.io 标准带入 .NET 生态，通过 MCP（Model Context Protocol）SDK 实现 skill 的发现和加载。双包架构：`SkillsDotNet`（核心 parsing/validation/scanning）+ `SkillsDotNet.Mcp`（MCP 传输层 + server/client extensions）。

URI 资源约定标准化了 skill 暴露方式：`skill://{name}/SKILL.md`（完整内容）、`skill://{name}/_manifest`（JSON manifest）、`skill://{name}/files/{path}`（支持文件）。

## 关键技术特性
- **Progressive Disclosure**：frontmatter discovery（50-100 tokens）→ full skill → supporting files
- **Dual-package Architecture**：Core types + MCP transport layer 分离
- **Vendor Shortcuts**：内置 Claude、Cursor、Copilot、Codex、Gemini、Goose、OpenCode 的快捷配置
- **URI Resource Convention**：三种标准化资源路径
- **Dependency Resolution**：client 端支持 skill 依赖的 recursive resolution
- **Microsoft.Extensions.AI Integration**：动态 skill 加载集成

## 设计亮点与创新
Vendor shortcuts 是贴心设计——一行配置即可为特定 agent 产品优化 skill 暴露方式。双包架构保持了核心逻辑与传输层的干净分离。

## 局限性与风险
- .NET 生态在 AI agent 领域的份额较小，潜在用户群有限
- MCP SDK 的成熟度和标准化程度仍在演进中
- 单人维护的开源项目，长期可持续性待观察

## 与生态系统的关联
与 pydantic-ai-skills（Python）共同证明了 agentskills.io 标准的**跨语言可移植性**。为 .NET 企业应用接入 Hermes skill 生态提供了基础设施。