# Agent Skills Repository

Claude Code用のAgent Skillsを管理するリポジトリです。

## 収録スキル

| スキル名 | 説明 |
|----------|------|
| **requirement-designer** | 要件定義を支援するスキル |
| **spec-driven-dev** | 仕様駆動開発を支援するスキル |
| **ui-designer** | UIデザインを支援するスキル |

---

## スキルのインストール方法

### 方法1: skillportを使用（推奨）

[skillport](https://github.com/gotalab/skillport)はClaude Code、Cursor、Copilotなど複数のAIエージェントでスキルを一元管理できるCLIツールです。

#### skillportのインストール

```bash
# uvを使用（推奨）
uv tool install skillport

# または pip
pip install skillport
```

#### このリポジトリからスキルを追加

```bash
# Claude Codeのスキルディレクトリに直接追加
skillport --skills-dir ~/.claude/skills add https://github.com/TakukiN/skillport_tmp

# 特定のスキルのみ追加する場合
skillport --skills-dir ~/.claude/skills add https://github.com/TakukiN/skillport_tmp/tree/main/requirement-designer
skillport --skills-dir ~/.claude/skills add https://github.com/TakukiN/skillport_tmp/tree/main/spec-driven-dev
skillport --skills-dir ~/.claude/skills add https://github.com/TakukiN/skillport_tmp/tree/main/ui-designer
```

#### skillportの主要コマンド

```bash
skillport list              # インストール済みスキル一覧
skillport search <query>    # スキル検索
skillport show <skill-id>   # スキル詳細表示
skillport remove <skill-id> # スキル削除
```

---

### 方法2: 手動インストール（Git clone）

#### 個人用スキルとしてインストール

全プロジェクトで使用可能になります。

```bash
# Windowsの場合
git clone https://github.com/TakukiN/skillport_tmp.git %USERPROFILE%\.claude\skills

# Mac/Linuxの場合
git clone https://github.com/TakukiN/skillport_tmp.git ~/.claude/skills
```

#### プロジェクト用スキルとしてインストール

特定プロジェクトのみで使用する場合（チームで共有可能）。

```bash
cd your-project
git clone https://github.com/TakukiN/skillport_tmp.git .claude/skills

# .gitignoreに追加するか、サブモジュールとして追加
git submodule add https://github.com/TakukiN/skillport_tmp.git .claude/skills
```

---

### 方法3: 手動コピー

1. リポジトリをダウンロード
2. 必要なスキルフォルダをコピー

```
# コピー先（個人用）
~/.claude/skills/
├── requirement-designer/
│   └── SKILL.md
├── spec-driven-dev/
│   └── SKILL.md
└── ui-designer/
    └── SKILL.md
```

---

## スキルの配置場所

Claude Codeは以下の場所からスキルを自動読み込みします：

| 種類 | パス | 用途 |
|------|------|------|
| 個人用 | `~/.claude/skills/` | 全プロジェクトで利用可能 |
| プロジェクト用 | `.claude/skills/` | 特定プロジェクトのみ |

---

## スキルの使い方

インストール後、Claude Codeで自然言語で呼び出せます：

```
# 例
「requirement-designerスキルを使って要件を整理して」
「spec-driven-devで仕様書を作成して」
「ui-designerでUIをデザインして」
```

---

## 新しいスキルの作成

### ディレクトリ構成

```
skill-name/
├── SKILL.md           # 必須: スキルの説明と指示
└── references/        # オプション: 参照ファイル
    ├── template.md
    └── examples.md
```

### SKILL.mdの基本構造

```markdown
---
description: スキルの短い説明（Claude Codeが表示に使用）
---

# スキル名

## 概要
このスキルが何をするか

## 使用方法
どのように使うか

## 指示
Claudeへの具体的な指示
```

---

## 参考リンク

- [Claude Code Skills公式ドキュメント](https://code.claude.com/docs/en/skills)
- [skillport GitHub](https://github.com/gotalab/skillport)
- [Anthropic公式スキルリポジトリ](https://github.com/anthropics/skills)