# Xs Skill Creator

> スキルの作成・改善を行うスキル。既存スキルの分析から抽出したパターンとテンプレートで統一感のあるスキルを効率的に作成。スキルを作りたい、新しいスキルを追加したい、スキルを改善したい、SKILL.mdを書きたい場合に使用。

- **Type:** Skill
- **Install:** `agentstack add skill-karaage0703-ai-assistant-workspace-xs-skill-creator`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [karaage0703](https://agentstack.voostack.com/s/karaage0703)
- **Installs:** 0
- **Category:** [Agent Skills](https://agentstack.voostack.com/c/agent-skills)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [karaage0703](https://github.com/karaage0703)
- **Source:** https://github.com/karaage0703/ai-assistant-workspace/tree/main/skills/xs-skill-creator

## Install

```sh
agentstack add skill-karaage0703-ai-assistant-workspace-xs-skill-creator
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# スキルクリエイター

ワークスペースの既存スキル群と統一感のあるスキルを作成・改善する。

## 絶対遵守事項

- 対話は日本語で行う
- 作成するスキルのSKILL.mdも日本語で記述

## プロンプト設計原則（制約少なめ・例多め）

過剰特定された制約は memorized shortcut を誤発火して品質を下げる（Akli et al., 2026, arXiv:2604.24712）。SKILL.md を書くときは：

- 「禁止」「絶対」「必ず」を並べるより、Do の例（コマンド例・入出力例・テンプレート）で示す
- スキル全体での禁止系制約は3つ程度を目安。それ以上は構造（章立て・例示）で表現する
- 残す制約には「なぜそれを避けるか」を1行で添える（理由なしの禁止は誤解されやすい）

詳細とBefore/After例は `[SKILL_DIR]/references/patterns.md` の「9. 制約少なめ・例多めの原則」を参照。

## スキル作成フロー

### Step 1: ヒアリング

ユーザーに以下を確認（わかっている情報はスキップ）：

1. **何をするスキル？** → 主機能の把握
2. **どんな時に使う？** → トリガー条件の特定
3. **入力と出力は？** → データフローの明確化
4. **スクリプトは必要？** → Python/Bash等の自動化有無

### Step 2: 分類と設計

4分類のどれに該当するか判定し、適切なテンプレートを選択：

| 分類 | 特徴 | 例 |
|------|------|-----|
| 対話型 | ユーザーとの対話で成果物を生成 | ブログ記事生成、プレゼン企画 |
| 自動実行型 | 指示一つで取得→加工→出力 | ニュース取得、サイト巡回 |
| ツール連携型 | 外部ツール/APIとの連携 | API操作、DB管理 |
| 思考支援型 | 構造化された思考フレームワーク提供 | ブレスト支援、調査整理 |

テンプレートの詳細は `[SKILL_DIR]/references/templates.md` を参照。

### Step 3: ディレクトリ作成

```bash
# スキル名はケバブケースで
mkdir -p [WORKSPACE]/skills/

# 必要に応じてサブディレクトリ作成
mkdir -p [WORKSPACE]/skills//scripts
mkdir -p [WORKSPACE]/skills//references
mkdir -p [WORKSPACE]/skills//assets
```

### Step 4: スクリプト作成（該当する場合）

スクリプトが必要な場合：
1. `scripts/` にPython/Bashスクリプトを配置
2. **必ず `uv run` で実行する**（`python3` 直接実行は禁止。外部依存ゼロでも `uv run` を使う。理由: python未インストール環境でもuvがPythonを自動解決するため）
3. `--help` オプションを実装
4. **実際に `uv run` でテスト実行して動作確認**

### Step 5: SKILL.md作成

テンプレートに従い作成。以下の要素を必ず含める：

**フロントマター（必須）:**
```yaml
---
name: xs-
description: [50-200文字。何をするか＋いつ使うか＋トリガーフレーズ]
---
```

**本文の構成:**
1. **H1タイトル** - スキル名
2. **1行概要** - 何をするスキルか
3. **絶対遵守事項**（必要な場合）
4. **手順** - Step/STEP形式で番号付き
5. **出力フォーマット** - 期待する出力形式
6. **使用例** - 具体的なトリガーフレーズ

**パス規則:**
- `[SKILL_DIR]` - SKILL.mdがあるディレクトリ
- `[WORKSPACE]` - ワークスペースルート
- ハードコードパス禁止

**保存機能がある場合:**
- note-takingスキルがあればそちらへの委譲を記述
- 直接保存ロジックを書かない

### Step 6: 品質チェック

`[SKILL_DIR]/references/checklist.md` の全項目を確認。

### Step 7: 登録確認

スキルの配置場所がシンボリックリンクで管理されている場合（例: `.claude/skills/` → `skills/`）、`skills/` にフォルダを作るだけで自動認識される。

そうでない場合は、AIツールの設定に新しいスキルを登録する。

### Step 8: README更新

`[WORKSPACE]/skills/README.md` があれば、スキル一覧に追加。

### Step 9: Git同期

```bash
cd [WORKSPACE] && git add -A && git commit -m "Add skill: " && git push
```

### Step 10: 完了報告

```
スキル作成完了！

skills//
- SKILL.md（XX行）
- scripts/（あれば）
- references/（あれば）
```

---

## スキル改善フロー

既存スキルの改善を依頼された場合：

### Step 1: 現状分析

```bash
# 対象スキルを読む
cat [WORKSPACE]/skills//SKILL.md

# 行数を確認
wc -l [WORKSPACE]/skills//SKILL.md
```

### Step 2: チェックリスト適用

`[SKILL_DIR]/references/checklist.md` で問題点を洗い出し。

### Step 3: パターン参照

`[SKILL_DIR]/references/patterns.md` でベストプラクティスと照合。

### Step 4: 改善実施

問題点を修正し、品質チェックを再実行。

### Step 5: Git同期と報告

---

## 参考資料

- `[SKILL_DIR]/references/patterns.md` - スキルの設計パターン集
- `[SKILL_DIR]/references/templates.md` - 分類別テンプレート
- `[SKILL_DIR]/references/checklist.md` - 品質チェックリスト
- `[WORKSPACE]/skills/README.md` - スキル一覧と作成ガイド

## 使用例

```
新しいスキルを作りたい
スキル作って：Twitterトレンド取得
このスキルを改善して
スキルのレビューして
```

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [karaage0703](https://github.com/karaage0703)
- **Source:** [karaage0703/ai-assistant-workspace](https://github.com/karaage0703/ai-assistant-workspace)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-karaage0703-ai-assistant-workspace-xs-skill-creator
- Seller: https://agentstack.voostack.com/s/karaage0703
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.