Skip to content
cccskills
FreePublished on 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 <スキル名> [用途の一言]` で呼び出す。

The English summary is being prepared. Showing the original description.

See how to install

Files included (1)

  • SKILL.md5.1 KB

SKILL.md (original)

Review the instructions the agent will receive before you install.

/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 雛形生成などへ広げない。

Reviews

No reviews yet. Tell others what you thought.

Comments

No login needed. Share how it worked for you, ask a question, or note where it did not run.

No comments yet. Be the first to write one.

Comments are published right away. Do not include personal information such as email addresses or phone numbers. Up to 2 URLs.

0 / 1,000 characters

This form is protected by reCAPTCHA, and the Google Privacy Policy and Terms of Service apply.

More skills from this repository

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.

The English summary is being prepared. Showing the original description.

hodanov/my-pde3Updated Oct 18, 2026

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.

The English summary is being prepared. Showing the original description.

hodanov/my-pde3Updated Oct 18, 2026

変更をコミットしてドラフト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直接実行しない。

The English summary is being prepared. Showing the original description.

hodanov/my-pde3Updated Oct 18, 2026

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

The English summary is being prepared. Showing the original description.

hodanov/my-pde3Updated Oct 18, 2026

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

The English summary is being prepared. Showing the original description.

hodanov/my-pde3Updated Oct 18, 2026

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

The English summary is being prepared. Showing the original description.

hodanov/my-pde3Updated Oct 18, 2026

See all skills by hodanov

Report a problem with this skill