skill-create

目的

このスキルでは、AI エージェントが新しいスキルを作成し、共有 skills リポジトリ（https://github.com/sourman/skills）に追加する方法を説明します。

リポジトリの場所

skills リポジトリの場所は次のとおりです。

• リモート： https://github.com/sourman/skills
• ローカルの作業コピー： /tmp/skills（環境によっては ~/skills）

スキルの構成

各スキルは、リポジトリのルートにある SKILL.md ファイルを含むディレクトリです。

skills/
├── skill-name-1/
│   └── SKILL.md
├── skill-name-2/
│   └── SKILL.md
└── README.md

SKILL.md ファイルには、次の内容が必要です。

1. name と description を含む YAML フロントマター
2. AI エージェント向けの指示を記述した Markdown コンテンツ

新しいスキルの作成

ステップ 1：リポジトリに移動する

cd /tmp/skills
# OR if it doesn't exist:
git clone [email protected]:sourman/skills.git /tmp/skills
cd /tmp/skills

ステップ 2：スキルのディレクトリを作成する

mkdir <skill-name>

スキル名には kebab-case を使用してください（例：react-best-practices、typescript-eslint、docker-workflow）。

ステップ 3：SKILL.md ファイルを作成する

次の構成で <skill-name>/SKILL.md を作成します。

---
name: skill-name
description: Brief one-line description of what this skill teaches the AI agent
---

# Skill Title

A clear, concise description of what this skill covers.

## What This Skill Covers

- Topic area 1
- Topic area 2
- Topic area 3

## Key Commands

```bash
# Example commands relevant to this skill
command --option value

詳細な手順

詳細な手順、ベストプラクティス、ワークフローをここに記載します。

このスキルを使用するタイミング

次の場合にこのスキルを使用します。

• 条件 1
• 条件 2

**Frontmatter Requirements:**
- `name`: Must match the directory name (kebab-case)
- `description`: One-line summary for the skills directory

## Step 4: Add and Commit to Git

```bash
# Ensure you're on the master branch
git checkout master

# Add the new skill
git add <skill-name>/

# Commit with a descriptive message
git commit -m "Add <skill-name> skill"

# If the master branch doesn't exist, you might be on main:
git checkout main

ステップ 5：GitHub にプッシュする

# Push the changes
git push origin master
# OR if on main:
git push origin main

例：新しいスキルの作成

git-workflow というスキルを作成する完全な例を示します。

# 1. Navigate to repo
cd /tmp/skills

# 2. Create directory
mkdir git-workflow

# 3. Create SKILL.md
cat > git-workflow/SKILL.md << 'EOF'
---
name: git-workflow
description: Git best practices, branching strategies, and commit conventions
---

# Git Workflow

This skill covers Git best practices for collaborative development.

## Branch Naming

Use descriptive branch names:
- `feature/add-user-authentication`
- `fix/login-page-bug`
- `refactor/database-connection`

## Commit Messages

Follow conventional commits:
- `feat: add user authentication`
- `fix: resolve login redirect issue`
- `docs: update API documentation`
EOF

# 4. Commit
git add git-workflow/
git commit -m "Add git-workflow skill"

# 5. Push
git push origin master

既存のスキルの更新

既存のスキルを更新するには、次の手順に従います。

cd /tmp/skills

# Edit the skill file
vim <skill-name>/SKILL.md

# Commit and push
git add <skill-name>/SKILL.md
git commit -m "Update <skill-name> skill: describe changes"
git push origin master

スキルの確認

プッシュ後、スキルにアクセスできることを確認します。

1. GitHub を確認します：https://github.com/sourman/skills/tree/main/
2. 別のプロジェクトでインストールをテストします。

   bun x skills add sourman/skills/<skill-name>
   

重要な注意事項

1. スキルのディレクトリ名には 必ず kebab-case を使用してください
2. フロントマターの name はディレクトリ名と 一致させてください
3. わかりやすい説明を記述してください。エージェントがスキル一覧を表示するときに、この説明を確認します
4. 別のプロジェクトにインストールして、スキルをテストしてください
5. スキルの対象を絞ってください。各スキルでは、特定のドメインやテクノロジーを扱います

トラブルシューティング

Git Push の失敗

「remote does not support password authentication」というエラーでプッシュが失敗する場合：

# Ensure SSH is set up correctly
ssh -T [email protected]

ブランチ名の問題

現在のブランチがわからない場合：

git branch
# Use 'main' or 'master' accordingly

権限が拒否された場合

プッシュできない場合：

1. sourman/skills へのプッシュ権限があることを確認します
2. 正しいユーザーとして認証されていることを確認します：gh auth status