creating-skills

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Creating Skills

创建Skills

Overview

概述

All personal skills live in
~/repos/arjit-skills/skills/<skill-name>/
. Skills are symlinked into
~/.agents/skills/
and
~/.claude/skills/
so all agents can discover them.
所有个人skill都存储在
~/repos/arjit-skills/skills/<skill-name>/
目录下。Skill会被符号链接到
~/.agents/skills/
~/.claude/skills/
目录,以便所有agent都能发现它们。

Process

操作流程

  1. Create the skill directory and files:
    ~/repos/arjit-skills/skills/<skill-name>/
      SKILL.md              # Required
      supporting-file.*     # Only if needed
  2. Symlink into both agent directories:
    bash
    ln -sf ~/repos/arjit-skills/skills/<skill-name> ~/.agents/skills/<skill-name>
    ln -sf ~/repos/arjit-skills/skills/<skill-name> ~/.claude/skills/<skill-name>
  3. Update the repo README (
    ~/repos/arjit-skills/README.md
    ):
    • Add the new skill to the Skills section in alphabetical order
    • Include a one-line description
  4. Commit and push:
    bash
    cd ~/repos/arjit-skills
    git add skills/<skill-name>
    git commit -m "Add <skill-name> skill"
    git push
  1. 创建skill目录及文件:
    ~/repos/arjit-skills/skills/<skill-name>/
      SKILL.md              # 必填文件
      supporting-file.*     # 仅在需要时添加
  2. 将目录符号链接到两个agent目录:
    bash
    ln -sf ~/repos/arjit-skills/skills/<skill-name> ~/.agents/skills/<skill-name>
    ln -sf ~/repos/arjit-skills/skills/<skill-name> ~/.claude/skills/<skill-name>
  3. 更新仓库README文件
    ~/repos/arjit-skills/README.md
    ):
    • 按字母顺序将新skill添加到Skills章节
    • 附上一行描述
  4. 提交并推送代码:
    bash
    cd ~/repos/arjit-skills
    git add skills/<skill-name>
    git commit -m "Add <skill-name> skill"
    git push

Rules

规则

  • Never create skills directly in
    ~/.claude/skills/
    or
    ~/.agents/skills/
    — always in the repo, then symlink.
  • Never create a standalone repo per skill — everything goes in
    arjit-skills
    .
  • Skill names use lowercase letters, numbers, and hyphens only.
  • If adapting someone else's skill, credit the original in the repo README and in a comment in SKILL.md.
  • 绝对不要直接在
    ~/.claude/skills/
    ~/.agents/skills/
    目录下创建skill——务必先在仓库中创建,再通过符号链接部署。
  • 绝对不要为每个skill单独创建仓库——所有skill都必须放在arjit-skills仓库中。
  • Skill名称只能使用小写字母、数字和连字符。
  • 如果改编他人的skill,需在仓库README和SKILL.md的注释中注明原作者信息。