本文へ移動
cccskills
無料GitHub で公開

skill-scaffold

新しいスキルの雛形(ディレクトリ + SKILL.md)を本リポジトリの規約どおりに生成する。

frontmatter(name / description / 任意の argument-hint・disable-model-invocation・metadata.version)と 本文(# /SKILL_NAME スキル → Goal / Workflow / Notes)を対話的に埋め、 `.claude/rules/skill-authoring.md` の判断軸で置き場所(ai-agents/skills / ai-agents/personal/skills / .claude/skills)を選んで配置する。

新しいスキルを新規作成・立ち上げたいときに `/skill-scaffold <スキル名> [用途の一言]` で呼び出す。

インストール方法を見る

含まれるファイル(1)

  • SKILL.md5.1 KB

SKILL.md(原文)

インストールする前に、エージェントに与えられる指示の中身を確認できます。

/skill-scaffold スキル

Goal

規約準拠のスキル雛形(ディレクトリ + SKILL.md)を最小手数で生成し、skill-improve が扱いやすい綺麗な初期状態を作る。 改善サイクル(Observe → Inspect → Amend → Evaluate)の手前にある「Create(新規スキルの立ち上げ)」フェーズを担う。

Workflow

Step 1: 引数パース

$ARGUMENTS を以下のように解釈する:

  • 第1引数: 生成するスキル名(以降 SKILL_NAME)
  • 第2引数以降: そのスキルの用途の一言(自由記述、省略可)

引数なしの場合は対話でスキル名と用途を尋ねる。

Step 2: スキル名のバリデーション

SKILL_NAME が以下を満たすか検証する。満たさない場合は修正案を提示して確認する。

  • lowercase + ハイフン(a-z, 0-9, -)のみ
  • 64 文字以内
  • 予約語(claude / anthropic)を含まない

Step 3: 衝突チェック(最重要)

ai-agents/skills/SKILL_NAME/、ai-agents/personal/skills/SKILL_NAME/、.claude/skills/SKILL_NAME/ の いずれにも存在しないこと を必ず確認する。

  • 既存の場合は 作成せず中断 し、既存スキルへの追記または /skill-improve を案内する(既存 SKILL.md を絶対に上書きしない)。

Step 3.5: 置き場所の決定

.claude/rules/skill-authoring.md の判断軸に従い、次の 3 ルートから 1 つ選ぶ(以降 SKILL_ROOT)。判断が割れる場合はユーザーに確認する。

ルート選ぶ条件
ai-agents/skillsどのリポジトリでも実行できる汎用スキル(既定)
ai-agents/personal/skillsどこでも動くが、仕事ではなく趣味・私生活のためのスキル
.claude/skillsai-agents/** routines/** など my-pde のパスを書き換えるもの

Step 4: description のドラフト

ベストプラクティスに沿った description をドラフトしてユーザー確認を取る。

  • 「何をするか」+「いつ使うか(トリガー)」 を必ず両方含める(モデルの自動起動判断に必要)。
  • 1024 文字以内、簡潔に。

Step 5: frontmatter の確定

  • argument-hint(引数を取るスキルのみ)と disable-model-invocation(明示呼び出し専用にするか)の要否を確認する。
  • metadata.version: 1 を付与する。

Step 6: 本文の生成

# /SKILL_NAME スキル を見出しに、## Goal / ## Workflow / ## Notes の骨組みを生成する。

  • 各セクションはプレースホルダ+最小限の骨組みに留め、中身の作り込みはユーザーに委ねる(SKILL.md は簡潔さが重要)。

Step 7: 書き出しとデプロイ案内

SKILL_ROOT/SKILL_NAME/SKILL.md に書き出し、内容をユーザーに表示して確認する。

  • デプロイは自動実行せず、mise run skills-copy で 2 エージェント(codex / claude)へ配布される旨を案内するに留める。
  • SKILL_ROOT が .claude/skills の場合は配布不要。コミットするだけでローカルにもクラウド Routine にも載る旨を案内する。

Notes

  • 既存スキルの上書き防止が最重要。Step 3 の非存在確認を必ず先に行い、衝突時は作成せず中断する。
  • 本スキルは「新規作成(Create)」専任。既存スキルの改善(Inspect / Amend)には踏み込まず、/skill-improve と役割を分担する。
  • skills は 2 エージェントへ配布されるため、特定エディタ依存の機能やスクリプトは使わず、モデル駆動の純 Markdown 手順に留める(移植性確保)。
  • 新規 skill のため hook 配線(settings.json / hook の .sh)は不要。scripts/copy-entries.sh の skills モードが skills/ 直下を総当りでコピーするため、ai-agents/skills と ai-agents/personal/skills はディレクトリを置くだけで mise run skills-copy にそのまま乗る。
  • 雛形は最小限に留め、過剰生成を避ける。スコープを「スキル作成」に絞り、hook 雛形生成などへ広げない。

レビュー

まだレビューはありません。使ってみた感想をお寄せください。

同じリポジトリのスキル

概要と使いどころ

Convert Claude markdown subagent files to Codex CLI TOML format. Parses YAML frontmatter and body, applies model/permission/tool mappings, and outputs to agents/codex/<name>.toml.

日本語の概要は準備中です。原文の説明を表示しています。

hodanov/my-pde32026年10月12日 更新

Create or update a Markdown blog draft from recent work and export it with `YYYY-MM-DD_slug.md` naming. Output directory can be set via environment variable or CLI option; if missing, ask the user and pass it explicitly.

日本語の概要は準備中です。原文の説明を表示しています。

hodanov/my-pde32026年10月12日 更新

commit-and-draft-pr

無料日本語概要

変更をコミットしてドラフトPRを作成する一連のGit/ghワークフロー。ユーザーが「コミットして」「PR作って」「draft PR」等を求めたときに使用し、status/diff確認・命令形コミット・push・gh pr create --draft(--assignee hodanov)まで実行する。ユーザーの明示リクエストが無くても、実装完了後にcommitやPRが必要になった場面(dev-workflowのcommitフェーズ等)では必ずこれを使う。`git commit` や `gh pr create` を単体でBash直接実行しない。

hodanov/my-pde32026年10月12日 更新

commit-split

無料日本語概要

1 つの作業ツリーに混ざった差分を、変更理由ごとの意味単位のコミットへ分割する。ユーザーが「コミットを分割して」「意味単位で分けて」「commit-split」等を求めたとき、または機能追加・付随リファクタ・設定/ドキュメント修正が 1 コミットに混在していると気づいたときに使用する。分割案を提示して承認を得てからステージし、コミットごとに単独で成立することを確認する。メッセージ規約・push・PR の作成は commit-and-draft-pr へ委譲する。

hodanov/my-pde32026年10月12日 更新

credential-leak-prevention

無料日本語概要

gitleaks + pre-commit を使ってローカルコミット時のクレデンシャル混入を機械的にブロックする。「クレデンシャル漏洩防止」「シークレット混入対策」「gitleaks」「pre-commit シークレット」「credential leak prevention」に言及した場合に使用する。

hodanov/my-pde32026年10月12日 更新

dependency-update

無料日本語概要

依存パッケージ(Go modules / npm / Terraform provider / GitHub Actions / pre-commit 等)の アップグレードを、outdated 検出 → CHANGELOG・破壊的変更の確認 → 更新 → lint/test 検証 → コミットまで一連の手順で安全に適用する。「依存更新」「パッケージを上げて」「dependency update」 「go get -u」「npm update」「provider を上げる」等に言及されたときに使用する。

hodanov/my-pde32026年10月12日 更新

hodanov のスキルをすべて見る

このスキルの問題を報告する