Menü
Skill creation template and guidelines for writing properly formatted skills
Mit Codex oder Claude installieren Kopieren Sie diesen Prompt, fügen Sie ihn in Codex, Claude oder einen anderen Assistant ein und lassen Sie die Skill-Seite prüfen und installieren.
Basierend auf der SOC-Berufsklassifikation
| name | skill-writer |
| description | Skill creation template and guidelines for writing properly formatted skills |
| license | MIT |
| user-invocable | true |
本技能提供标准技能文件格式模板和编写规范，帮助开发者正确创建新的技能文件，避免格式错误导致系统无法加载。 核心用途：
| 关键词 | 描述 |
|---|---|
创建技能, 新建技能, 写技能 | 创建新技能文件 |
技能模板, skill template | 获取标准技能模板 |
技能格式, skill format | 检查技能格式是否正确 |
YAML front matter | 获取 YAML 头部格式规范 |
技能目录结构 | 获取技能文件夹结构要求 |
全局技能, 项目技能 | 创建技能前确认技能作用域并选择正确目录 |
格式错误, 加载失败 | 诊断技能格式问题 |
本技能涵盖以下功能：
以下功能不在本技能范围内：
---
name: skill-name
description: Brief description of what this skill does
license: MIT
user-invocable: true
---
# Skill Title
## Overview
Brief overview of the skill's purpose and capabilities.
## Routing Table
| Keyword | Description |
|---------|-------------|
| `keyword1` | What it triggers |
| `keyword2` | What it triggers |
## Scope
List of capabilities covered by this skill:
1. Capability 1
2. Capability 2
3. Capability 3
## Out of Scope
List of capabilities NOT covered:
1. ? Not covered 1
2. ? Not covered 2
## Usage Examples
### Example 1: Basic Usage
Description of the example.
### Example 2: Advanced Usage
Description of the advanced example.
## Resources
- `resource-name` - Description of the resource
## Scripts
- `script-name.ps1` - Description of the script
---
name: skill-name # 必需：技能名称（英文，小写，连字符分隔）
description: Description # 必需：简短描述（英文）
license: MIT # 必需：许可证类型
user-invocable: true # 必需：是否允许用户调用（true/false）
---
| 字段 | 类型 | 要求 | 示例 |
|---|---|---|---|
name | string | 必需，英文小写，连字符分隔 | skill-writer, dotnet-api |
description | string | 必需，英文简短描述 | Skill creation template |
license | string | 必需，通常 MIT | MIT, Apache-2.0 |
user-invocable | boolean | 必需，true 或 false（小写） | true, false |
| 错误写法 | 正确写法 | 说明 |
|---|---|---|
name: Skill-Name | name: skill-name | 必须小写 |
user-invocable: True | user-invocable: true | 布尔值必须小写 |
没有 --- 分隔符 | 必须有 --- 包裹 | YAML 必须用三横线包裹 |
| YAML 不在文件第一行 | YAML 必须在开头 | 前面不能有空行或内容 |
当用户要求创建技能时，必须先询问用户要创建哪一种技能：
创建技能前必须调用以下工具获取实际目录，不要手写或猜测路径：
| 技能类型 | 必须调用的工具 | 目录用途 |
|---|---|---|
| 项目技能 | sys_get_workspace_skills_directory | 获取当前工作目录技能目录 |
| 全局技能 | sys_get_user_skills_directory | 获取当前用户全局技能目录 |
推荐流程：
要创建全局技能还是项目技能？sys_get_workspace_skills_directory 获取项目技能目录。sys_get_user_skills_directory 获取全局技能目录。{skill-name}\SKILL.md。skill-name
├── SKILL.md # 必需：技能定义文件
├── resources/ # 可选：资源文件夹
│ ├── references.md
│ └── assets/
└── scripts/ # 可选：脚本文件夹
└── script.ps1
创建技能后，请检查以下项目：
--- 正确包裹（开头和结尾）name 字段为英文小写，使用连字符description 字段为英文描述license 字段存在user-invocable 为 true 或 false（小写）SKILL.md（大写）sys_get_workspace_skills_directory 获取工作目录技能目录sys_get_user_skills_directory 获取全局技能目录# ? 错误：没有分隔符
name: my skill
description: My skill
# ? 正确
---
name: my-skill
description: My skill
license: MIT
user-invocable: true
---
# ? 错误
user-invocable: True
# ? 正确
user-invocable: true
# ? 错误
name: My-Skill
# ? 正确
name: my-skill
# ? 错误：前面有内容
# 一些注释
---
name: my-skill
---
# ? 正确：YAML 在第一行
---
name: my-skill
---
用户: "帮我创建一个新的技能，用于处理 WordPress 插件开发"
步骤:
要创建全局技能还是项目技能？sys_get_workspace_skills_directory 获取工作目录技能目录。sys_get_user_skills_directory 获取全局技能目录。{全局技能目录}\wp-plugin-dev{工作目录技能目录}\wp-plugin-devSKILL.mdSKILL.mdname 为 wp-plugin-devdescription 为 WordPress plugin development skill用户: "检查一下我的技能格式对不对"
步骤:
用户: "我的技能加载失败了，帮我修复"
步骤:
template - 标准技能模板（本文件即模板）checklist - 格式检查清单examples - 常见技能示例参考validate-skill.ps1 - 技能格式验证脚本create-skeleton.ps1 - 创建技能骨架脚本dotnet-ui）复制结构dotnet-* 系列技能的格式sys_get_workspace_skills_directory 和 sys_get_user_skills_directory 获取目录Version: 1.0 Last Updated: 2026-05-08
Madorin 插件开发入口技能。用于统一编排 Native、MCP、Process 三类通道，约束工程规范、外部包 AOT 校验、发布安装与运行时更新流程。触发关键词：插件开发、Native 插件、MCP 插件、Process 插件、进程插件、发布插件、安装插件。
Madorin Native 插件开发子技能。位置：subskills/native。用于 Native AOT 插件创建、Startup 组合、Tool 编写、JsonContext、后台服务、AOT 规则。触发关键词：Native 插件、AOT 插件、Startup.Configure、ToolAttribute、原生插件。
Madorin Process 插件开发子技能。位置：subskills/process。用于开发以独立 exe 进程运行的插件，支持 JIT self-contained 和 AOT exe 两种发布方式，通过 stdin/stdout JSON 协议与宿主通信。触发关键词：Process 插件、进程插件、exe 插件、JIT 插件、进程隔离插件。
Madorin PluginBus WebSocket 接入。用于生成 /internal 单端点、cortana.plugin-bus、conversation topic、chat.message.send、chat.generation.stop、system.notice、ping/pong 的 C# 客户端代码与样板。关键词：WebSocket、PluginBus、/internal、chat.message.send、ping、pong。
Madorin 插件工程规范子技能。位置：subskills/architecture。用于插件架构设计、职责分离、依赖注入、AOT 安全编码、配置与日志、质量门禁。触发关键词：插件架构、职责分离、依赖注入、工程规范、AOT 安全、插件设计。
Madorin MCP 通道子技能。位置：subskills/mcp。用于接入和校验外部 MCP Server 的 stdio、sse、streamable-http 配置。触发关键词：MCP、Model Context Protocol、stdio、sse、streamable-http。