create-skill

blueif16's avatarfrom blueif16

创建新的skill，如果需要会自动初始化插件结构

⭐0stars🔀0forks📁View on GitHub🕐Updated Dec 31, 2025
[Developer Tools]

When & Why to Use This Skill

The create-skill tool is a specialized developer utility designed to streamline the creation and management of Claude agent capabilities. It automates the scaffolding of new skills by generating standardized directory structures and SKILL.md templates, while also handling the automatic initialization of the .claude plugin environment. By enforcing naming conventions and metadata requirements, it ensures consistency and reduces manual boilerplate work for developers building complex agentic workflows.

Use Cases

  • Rapid Scaffolding: Quickly bootstrap a new Claude skill with the correct folder structure and metadata templates to jumpstart development.
  • Environment Initialization: Automatically set up the necessary .claude directory architecture (skills, agents, commands, hooks) for new projects.
  • Standardization and Validation: Enforce consistent naming conventions and documentation standards across all skills within a plugin to maintain long-term code quality.
  • Workflow Automation: Use the tool to programmatically generate skill definitions, ensuring that all required fields like descriptions and tool permissions are correctly populated.
namecreate-skill
description创建新的skill，如果需要会自动初始化插件结构
allowed-toolsWrite, Read, Bash, Glob

创建Skill

目的

创建新的skill文件，如果插件结构不存在则自动初始化。

执行逻辑

1. 检查插件结构

检查当前目录是否存在 .claude/ 目录
├─ 找到 → 继续到步骤3
└─ 未找到 → 进入步骤2

2. 自动初始化插件（如需要）

  1. 读取 init-plugin skill 获取结构知识
  2. 询问用户："这个插件应该叫什么名字？"
  3. 验证名称格式（小写、连字符）
  4. 创建 .claude/ 结构：
    • .claude/skills/
    • .claude/agents/
    • .claude/commands/
    • .claude/hooks/hooks.json
  5. 继续到步骤3

3. 收集skill信息

询问用户：

  1. "Skill名称？" （验证：小写、连字符、数字）
  2. "描述？"
  3. "需要哪些工具？（逗号分隔，或留空）"

4. 创建skill

  1. 创建目录: .claude/skills/{skill-name}/
  2. 从模板生成 SKILL.md
  3. 插入用户输入（完全按用户提供的内容，不做修改）
  4. 显示成功消息

验证规则

  • Skill名称格式: ^[a-z0-9-]+$
  • 不允许重复名称: 检查现有skills
  • 描述必需: 至少10个字符

成功输出

✅ Skill已创建: {skill-name}
📁 位置: ./.claude/skills/{skill-name}/SKILL.md
🚀 该skill立即可用

错误处理

  • 名称格式无效 → 重新询问
  • 名称重复 → 提示并询问是否覆盖
  • 无写入权限 → 报告错误

示例

用户: "创建一个reddit-upvote skill"

执行流程:

  1. 检查 .claude/ → 未找到
  2. 询问插件名 → "reddit-automation"
  3. 创建 .claude/ 结构
  4. 询问skill信息:
    • 名称: reddit-upvote
    • 描述: Upvote Reddit posts
    • 工具: (留空)
  5. 创建 .claude/skills/reddit-upvote/SKILL.md
  6. 输出成功消息