Agent skill

Skill Creator

by yohey-w in yohey-w/multi-agent-shogun

Claude Codeスキル(SKILL.md)の設計・作成・バリデーション・レビュー. An agent skill from yohey-w/multi-agent-shogun.

MITAuto-check passedAgent Workflows

Install Skill Creator

skills CLI
$ npx skills add yohey-w/multi-agent-shogun --skill skill-creator -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install yohey-w/multi-agent-shogun skill-creator --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/yohey-w/multi-agent-shogun.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/skill-creator .claude/skills/skill-creator && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
skill-creator
GitHub stars
1.4k
Token cost
~1.8k tokens
SKILL.md length
382 words
Files
1
Skills in repo
8
Repo updated
First seen
Licence
MIT

At a glance

Claude Codeスキル(SKILL.md)の設計・作成・バリデーション・レビュー. An agent skill from yohey-w/multi-agent-shogun.

  • Works in 3 steps: Triggering Test(発火テスト) → Functional Test(機能テスト) → Performance Test(性能テスト)
  • : スキルの実行・呼び出し(それは各スキル自体が行う)
  • SKILL.md covers North Star, Frontmatter Reference(全フィールド), Description設計(最重要 — 発火品質を決める) and 3つのユースケースカテゴリー, plus 6 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Skill Creator is an agent skill from yohey-w/multi-agent-shogun. Claude Codeスキル(SKILL.md)の設計・作成・バリデーション・レビュー。 Anthropic公式ガイド(2026-03)準拠。新規スキル作成、既存スキルの改善、 description品質チェック、トリガーテスト設計に使用。 「スキル作って」「スキル設計」「SKILL.md作成」「スキルレビュー」で起動。 Do NOT use for: スキルの実行・呼び出し(それは各スキル自体が行う)。

Its SKILL.md is about 1.8k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Agent Workflows, covering Skill authoring. The repository describes itself as: Samurai-inspired multi-agent system for Claude Code. Orchestrate parallel AI tasks via tmux with shogun → karo → ashigaru hierarchy. The licence is MIT.

When your agent uses it

  • : スキルの実行・呼び出し(それは各スキル自体が行う)
  • Tasks that involve Skill authoring

Example prompts

  • “/skill-creator”

Workflow steps

3 steps, taken from the step headings in SKILL.md.

  1. Triggering Test(発火テスト)
  2. Functional Test(機能テスト)
  3. Performance Test(性能テスト)

What it can do on your machine

Read from SKILL.md and the folder at commit aff8dc8. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md (its code samples are yaml, markdown and bash).

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Skill Creator loads about 1.8k tokens when it runs. Until then it costs about 55 tokens; SKILL.md has 382 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~55
When it runs · the whole SKILL.md, loaded when a task matches
~1.8k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from yohey-w/multi-agent-shogun at commit aff8dc8, republished under its MIT licence (© yohey-w). 382 words, ~1,811 tokens.

Download SKILL.mdSave it as .claude/skills/skill-creator/SKILL.md (or your agent's skills folder).
name
skill-creator
description
Claude Codeスキル(SKILL.md)の設計・作成・バリデーション・レビュー。 Anthropic公式ガイド(2026-03)準拠。新規スキル作成、既存スキルの改善、 description品質チェック、トリガーテスト設計に使用。 「スキル作って」「スキル設計」「SKILL.md作成」「スキルレビュー」で起動。 Do NOT use for: スキルの実行・呼び出し(それは各スキル自体が行う)。
argument-hint
[skill-name or description]

Skill Creator — Claude Code Skills Design & Generation v2.0

Anthropic公式 "The Complete Guide to Building Skills for Claude" (2026-03) に完全準拠。 Agent Skills Open Standard (agentskills.io) にも対応し、Claude Code以外のAIツールでも動作するスキルを設計する。

North Star

再利用可能で高品質なスキルを最短で設計・作成すること。 スキルの価値 = 発火精度 × 出力品質 × 保守性。

Frontmatter Reference(全フィールド)

yaml
---
# === 必須フィールド ===
name: skill-name              # kebab-case, max 64 chars. 省略時はディレクトリ名
                               # "claude" / "anthropic" を含む名前は禁止(予約語)
description: |                 # 【最重要】発火判断の唯一の材料。1024文字以内
  What + When を明記。トリガーワードを含める。
  ネガティブトリガー(Do NOT use for...)で誤発火防止。

# === 任意フィールド ===
argument-hint: "[target]"      # 補完時のヒント表示。引数ありスキル用
disable-model-invocation: false # true = 手動 /name でのみ起動(副作用あるスキル向け)
user-invocable: true           # false = /メニュー非表示(背景知識スキル向け)
allowed-tools: Read, Grep, Bash # 許可ツール。指定すると制限にもなる。省略=全ツール継承
model: sonnet                  # スキル実行時のモデル指定(省略=親から継承)
context: fork                  # fork = サブエージェントで隔離実行
agent: general-purpose         # fork時のエージェント種別: Explore, Plan, general-purpose
license: MIT                   # OSSスキル用。MIT, Apache-2.0 等
compatibility: |               # 環境要件(1-500文字)
  Claude Code + tmux + WSL2
metadata:                      # カスタムメタデータ
  author: your-name
  version: 1.0.0
  mcp-server: server-name      # MCP連携スキル用
hooks:                         # スキル内フック定義
  PostToolUse:
    - matcher: "Edit|Write"
      hooks:
        - type: command
          command: "./scripts/lint.sh"
---
Frontmatter セキュリティ制約
  • XML角括弧 < > 禁止(プロンプトインジェクション防止)
  • nameに "claude" / "anthropic" は使用禁止(予約語)
  • フロントマターはシステムプロンプト内に展開される → 悪意あるコンテンツは危険

Description設計(最重要 — 発火品質を決める)

descriptionはClaude Codeが「このスキルを使うか否か」を判断する唯一の材料。 本文は発火判定に使われない。1024文字以内。

構造: [What] + [When] + [Negative trigger]
yaml
# Good — 具体的、トリガーあり、ネガティブトリガーあり
description: |
  Figmaデザインファイルを分析し、開発者向けハンドオフドキュメントを生成。
  .figファイルアップロード時、「デザインスペック」「コンポーネント文書」
  「デザインからコードへ」と言われた時に起動。
  Do NOT use for: 一般的な画像処理やUI設計(interface-designスキルを使え)。

# Bad — 曖昧、トリガーなし
description: ドキュメント処理
7項目チェックリスト
#チェック悪い例良い例
1What: 何をするか明記"ドキュメント処理""PDFからテーブルを抽出しCSVに変換"
2When: いつ使うか明記(なし)"データ分析ワークフローで使用"
3トリガーワード含有(なし)"「記事QC」「バリデーション」で起動"
4具体的なアクション動詞"管理する""抽出・変換・検証する"
5長さ: 1024文字以内1単語 or 長すぎ2-3文で概要+トリガー+除外
6既存スキルと差別化他スキルと被る独自の守備範囲を明示
7ネガティブトリガーなし(誤発火リスク)"Do NOT use for: ..."
Descriptionデバッグ手法

発火しない場合、Claudeに聞け:

「When would you use the [skill-name] skill?」

Claudeがdescriptionを引用して答える。足りない要素が見える。

3つのユースケースカテゴリー

スキル設計前に、どのカテゴリーか特定する:

カテゴリ用途例
1. Document & Asset Creation成果物生成(PDF, コード, 記事等)shogun-seo-writer
2. Workflow Automationステップバイステップの自動化shogun-git-release
3. MCP EnhancementMCPツール+ワークフロー知識shogun-github-reviewer

5つの設計パターン

Pattern 1: Sequential Workflow(順序付き処理)

ステップ間に依存関係あり。各ステップにバリデーション + 失敗時ロールバック。

Pattern 2: Multi-Service Coordination(複数サービス連携)

フェーズ分離 + データ受け渡し + フェーズ間バリデーション。

Pattern 3: Iterative Refinement(品質ループ)

生成 → 検証スクリプト → 改善 → 再検証。品質閾値で停止。

Pattern 4: Context-aware Selection(条件分岐)

コンテキストに応じてツール/手法を動的選択。判断理由をユーザーに説明。

Pattern 5: Domain Intelligence(専門知識埋め込み)

ドメイン固有ルールをロジックに組み込む。コンプライアンス・監査証跡。

Dynamic Features(動的機能)

引数置換
/my-skill 結婚 kekkon
  • $ARGUMENTS → 結婚 kekkon(全引数)
  • $0 → 結婚(第1引数)
  • $1 → kekkon(第2引数)

$ARGUMENTS を本文で使わない場合、末尾に自動追加される。

動的コンテキスト !command``

スキル読み込み前にシェルコマンドを実行し、結果を埋め込む:

markdown
## 現在のブランチ
!`git branch --show-current`

## 最近のコミット
!`git log --oneline -5`

Execution Patterns(実行パターン)

Pattern A: インライン実行(デフォルト)

メイン会話内で直接実行。ガイドライン型・短いタスク向け。

Pattern B: Fork実行(隔離)

context: fork でサブエージェント実行。重い処理・大量出力向け。 注意: ガイドラインだけのスキルにforkを使うな。サブエージェントには明確なタスクが必要。

Pattern C: 手動専用(副作用あり)

disable-model-invocation: true でClaude自動発火を禁止。/name でのみ起動。

File Structure(ファイル構成)

~/.claude/skills/skill-name/
├── SKILL.md              # 必須。5,000語(約500行)以内。case-sensitive
├── scripts/              # 任意。バリデーション等の実行スクリプト
├── references/           # 任意。詳細なAPI仕様・ルール集
├── assets/               # 任意。テンプレート、フォント、アイコン
└── examples/             # 任意。入出力サンプル
命名規則
  • フォルダ名: kebab-case(notion-project-setup ✅ / Notion_Setup ❌)
  • SKILL.md は大文字小文字厳密(skill.md ❌ / SKILL.MD ❌)
  • README.md禁止(スキルフォルダ内)。ドキュメントはSKILL.md or references/に
Progressive Disclosure(3層構造)
層内容読み込みタイミング
L1YAML frontmatter常時(システムプロンプト内)
L2SKILL.md本文スキル関連と判断された時
L3references/, scripts/必要に応じてClaudeが参照

SKILL.md本体は5,000語以内。詳細はreferences/に分離。

テスト戦略(3領域)

1. Triggering Test(発火テスト)
Should trigger:
- "新しいスキルを作りたい"
- "SKILL.mdのレビュー"
- "スキル設計して"

Should NOT trigger:
- "スキルを実行して"
- "天気教えて"
- "コード書いて"
Show full SKILL.md (153 more words)Show less
2. Functional Test(機能テスト)
  • 正しい出力が生成されるか
  • エラーハンドリングが動作するか
  • エッジケースが処理されるか
3. Performance Test(性能テスト)

スキルあり/なしの比較:

  • ツール呼び出し回数
  • トークン消費量
  • ユーザーの手戻り回数

Pro Tip: まず1つの難しいタスクで反復。成功したアプローチをスキル化。 その後テストケースを広げる。

Creation Workflow(作成フロー)

スキル作成時、以下を順に実行:

  1. ユースケース特定: 2-3個の具体的シナリオを定義
  2. カテゴリ判定: Document / Workflow / MCP Enhancement
  3. description設計: 7項目チェック + ネガティブトリガー + 1024文字以内
  4. 既存スキルとの重複チェック: ls ~/.claude/skills/ で確認
  5. 実行パターン選択: インライン / fork / 手動専用
  6. allowed-tools設計: 必要最小限に制限
  7. 引数設計: $0, $1 → argument-hint 記載
  8. 動的コンテキスト: !command`` で事前取得すべきデータ検討
  9. SKILL.md執筆: 5,000語以内。重要指示はファイル上部に配置
  10. バリデーションスクリプト化: クリティカルなチェックはscripts/に(コードは決定的、言語は非決定的)
  11. テスト: Triggering / Functional / Performance の3領域
  12. 設置: ~/.claude/skills/skill-name/ に配置

バリデーションスクリプト推奨

公式ガイドの最重要Tips: クリティカルなバリデーションはスクリプトで行え。 コードは決定的、言語の解釈は非決定的。

bash
# scripts/validate.sh の例
#!/bin/bash
# 出力ファイルの品質チェック
if [ $(wc -w < "$1") -lt 100 ]; then
  echo "ERROR: Output too short (min 100 words)"
  exit 1
fi

将軍システム固有ルール

  • 保存先: ~/.claude/skills/shogun-{skill-name}/
  • スキル候補は足軽が発見 → 家老経由で将軍に報告 → 将軍が設計 → 殿が承認 → 家老が作成
  • 将軍システム連携(inbox_write, task YAML等)が必要なスキルは allowed-tools に Bash を含めよ
  • north_star はフロントマターでなく本文に記載(フロントマターのカスタムフィールドはClaude Codeに無視される)

Anti-Patterns(やってはいけないこと)

NG理由代わりに
SKILL.md 5,000語超読み込みコスト爆増、応答品質低下references/ に分離
description が曖昧発火しない or 誤発火What + When + ネガティブトリガー
description 1024文字超フロントマター制限超過簡潔に3文以内
description に < >セキュリティ違反角括弧不使用
ネガティブトリガーなし類似スキル間で誤発火"Do NOT use for: ..." 追加
context: fork + ガイドラインのみサブエージェントが迷走インライン実行
disable-model-invocation + user-invocable: false誰も起動できないどちらか片方
allowed-tools 未指定で重い処理意図しないツール使用必要なツールのみ列挙
フロントマターに独自フィールドClaude Codeに無視される本文のMarkdownに記載
スキルフォルダにREADME.md仕様違反SKILL.md or references/
同時有効スキル50個超コンテキスト圧迫選択的有効化

© yohey-w, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in skills/skill-creator of yohey-w/multi-agent-shogun.

Open the folder on GitHubat commit aff8dc8

Compare with similar skills

Skill Creator next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Skill Creator compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Skill Creator this skillyohey-w/multi-agent-shogun1.4k—~1.8kAutomated safety check: PassMIT
Skill CreatorAzure/azqr79589 repos~8.2kAutomated safety check: PassApache-2.0
Claude Code Skill Developer Guidediet103/claude-code-infrastructure-showcase10k11 repos~3.5kAutomated safety check: PassMIT
Darwin Skill Optimizeralchaincyf/darwin-skill6.2k1 repos~4.7kAutomated safety check: PassMIT
Claude Code Command Developmentanthropics/claude-plugins-official38k10 repos~4.8kAutomated safety check: PassApache-2.0
Claude Code Plugin Structureanthropics/claude-plugins-official38k10 repos~3.4kAutomated safety check: PassApache-2.0

Similar skills

  • Skill Creator

    Azure/azqr

    Official

    Create new skills, modify and improve existing skills, and measure skill performance.

    795 GitHub starsUsed in 89 repos~8.2k tokens
    Agent WorkflowsAuto-check passed
  • Claude Code Skill Developer Guide

    diet103/claude-code-infrastructure-showcase

    A guide to creating and managing Claude Code skills with auto-activation: skill-rules.json triggers, hooks, enforcement levels, YAML frontmatter and progressive disclosure.

    10k GitHub starsUsed in 11 repos~3.5k tokens
    Agent WorkflowsAuto-check passed
  • Darwin Skill Optimizer

    alchaincyf/darwin-skill

    Scores SKILL.md files on a nine-dimension rubric, then improves them in a keep-or-revert loop with independent judge agents, test prompts, git history and human checkpoints.

    6.2k GitHub starsUsed in 1 repo~4.7k tokens
    Agent WorkflowsAuto-check passed
  • Claude Code Command Development

    anthropics/claude-plugins-official

    Official

    Explains how to write Claude Code slash commands: Markdown files with YAML frontmatter, arguments, file references, bash context and interactive prompts.

    38k GitHub starsUsed in 10 repos~4.8k tokens
    Agent WorkflowsAuto-check passed
  • Claude Code Plugin Structure

    anthropics/claude-plugins-official

    Official

    Explains the directory layout, plugin.json manifest and component organization of a Claude Code plugin, including auto-discovery and portable paths.

    38k GitHub starsUsed in 10 repos~3.4k tokens
    Agent WorkflowsAuto-check passed
  • Skill Release Gate

    rohitg00/ai-engineering-from-scratch

    Evaluates an Agent Skill bundle before release for structure, trigger quality, artifact improvement, script correctness, safety, installed-tree integrity and host portability.

    66k GitHub stars~1k tokensUpdated today
    Agent WorkflowsAuto-check passed

More from yohey-w/multi-agent-shogun

All 8 skills in this repo
  • Shogun Screenshot

    yohey-w/multi-agent-shogun

    スクリーンショットの取得・加工を行う。ローカルスクショから最新画像を取得、 PlaywrightでWebページをキャプチャ、画像のトリミング・リサイズ、機微情報を黒塗りマスキング。

    1.4k GitHub stars~901 tokensUpdated 2 mo ago
    Auto-check: notes
  • Shogun Bloom Config

    yohey-w/multi-agent-shogun

    Interactive wizard: guided questions with multiple-choice options about subscriptions, then outputs a ready-to-paste capabilitytiers YAML + fixed agent model assignments.

    1.4k GitHub stars~3.1k tokensUpdated 2 mo ago
    Auto-check passed
  • Shogun Model List

    yohey-w/multi-agent-shogun

    All AI CLI tools × available models × required subscriptions × Bloom max capability.

    1.4k GitHub stars~1.3k tokensUpdated 2 mo ago
    Auto-check passed
  • Shogun Model Switch

    yohey-w/multi-agent-shogun

    エージェントのCLI/モデルをライブ切替するスキル。settings.yaml更新→/exit→新CLI起動→ pane metadata更新を一発で実行。Thinking有無も制御。

    1.4k GitHub stars~1.1k tokensUpdated 2 mo ago
    Auto-check passed
  • Shogun Readme Sync

    yohey-w/multi-agent-shogun

    README.md(英語)とREADMEja.md(日本語)の同期を確認・実行するスキル。README変更時に両言語版を必ず同時更新するために使用。「README更新」「README同期」「readme sync」で起動。

    1.4k GitHub stars~528 tokensUpdated 2 mo ago
    Auto-check passed
  • Inbox Write

    yohey-w/multi-agent-shogun

    別エージェントのinboxにメッセージを送信する。agent-to-agent通信の唯一の手段. An agent skill from yohey-w/multi-agent-shogun.

    1.4k GitHub stars~186 tokensUpdated 2 mo ago
    Auto-check passed

Categories

Questions about Skill Creator

What does Skill Creator do?

Claude Codeスキル(SKILL.md)の設計・作成・バリデーション・レビュー. An agent skill from yohey-w/multi-agent-shogun. Skill Creator is an agent skill from yohey-w/multi-agent-shogun.

When should I use Skill Creator?

Skill Creator fits situations like: : スキルの実行・呼び出し(それは各スキル自体が行う); tasks that involve Skill authoring.

How do I install Skill Creator in Claude Code?

Run `npx skills add yohey-w/multi-agent-shogun --skill skill-creator -a claude-code`. Or copy the skill folder (skills/skill-creator in yohey-w/multi-agent-shogun) into .claude/skills/skill-creator in your project. Claude Code loads it when a task matches its description.

How do I install Skill Creator in Codex?

Run `npx skills add yohey-w/multi-agent-shogun --skill skill-creator -a codex`. Or copy the skill folder (skills/skill-creator in yohey-w/multi-agent-shogun) into .agents/skills/skill-creator in your project. Codex loads it when a task matches its description.

Can I use Skill Creator in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add yohey-w/multi-agent-shogun --skill skill-creator -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/skill-creator, .gemini/skills/skill-creator, .github/skills/skill-creator and .opencode/skills/skill-creator in your project.

What does Skill Creator need to run?

SKILL.md names no scripts, command-line tools or credentials: Skill Creator is instructions for the agent only.

Does Skill Creator access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Skill Creator safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Skill Creator use?

Skill Creator is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Skill Creator use?

About 1.8k tokens (SKILL.md is roughly 7.2k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Skill Creator?

Skills that share tags, products or a category with Skill Creator: Skill Creator (Azure/azqr, 795 stars), Claude Code Skill Developer Guide (diet103/claude-code-infrastructure-showcase, 10k stars), Darwin Skill Optimizer (alchaincyf/darwin-skill, 6.2k stars) and Claude Code Command Development (anthropics/claude-plugins-official, 38k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Skill Creator?

yohey-w (a GitHub user) maintains it in yohey-w/multi-agent-shogun, which has 1,424 GitHub stars. The repository holds 8 skills in this directory. The repository was last updated on August 6, 2026.

Source: yohey-w/multi-agent-shogun on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.