SuperAPI AI 工具集

skill-writer

设计与创作

查看项目

更新于 10-15 16:46

技能介绍

用途:帮助用户为 Claude Code 创建结构良好、符合最佳实践与校验要求的 Agent Skills。适用于新建技能、编写或更新 SKILL.md、设计技能结构与 frontmatter、排查技能无法被发现的故障,以及把现有提示词或工作流转换为技能。

主要能力:它按步骤引导确定技能范围、选择存放位置、建立目录结构、编写 YAML frontmatter、撰写有效描述、组织正文内容、添加辅助文件、校验与测试技能,并在不生效时给出调试方向。

使用方式:先明确技能提供的具体能力、触发时机、所需工具,以及个人使用还是团队共享,保持一个技能只做一件事。个人技能放 ~/.claude/skills/,项目技能放 .claude/skills/。目录示例:mkdir -p ~/.claude/skills/skill-name 或 mkdir -p .claude/skills/skill-name。多文件技能可包含 SKILL.md、reference.md、examples.md、scripts/、templates/。frontmatter 必填 name 与 description,name 仅限小写字母、数字和连字符,最长 64 字符,须与目录名一致;description 最长 1024 字符,需同时说明做什么和何时使用,并包含具体触发词与文件类型。可选 allowed-tools 限制工具权限,例如 allowed-tools: Read, Grep, Glob。正文建议含快速开始、分步指令、示例、最佳实践和要求,可引用辅助文件实现渐进式披露。

适用场景:个人或团队共享技能开发、只读技能、脚本型技能、多文件技能等。

限制:资料未提供具体收费、价格、平台与版本信息;技能需重启 Claude Code 或使用 claude --debug 调试。目录名与 frontmatter 名必须匹配,YAML 不得使用制表符。