Menú
Skill creation template and guidelines for writing properly formatted skills
Instalar con Codex o Claude Copia este prompt, pégalo en Codex, Claude u otro asistente, y deja que revise la página de la skill y la instale por ti.
Basado en la clasificación ocupacional SOC
| 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。