본문으로 건너뛰기
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 雛形生成などへ広げない。

리뷰

아직 리뷰가 없습니다. 사용해 본 소감을 남겨 주세요.

댓글

로그인 없이 쓸 수 있습니다. 사용 후기, 질문, 작동하지 않은 환경 등을 편하게 남겨 주세요.

아직 댓글이 없습니다. 첫 댓글을 남겨 보세요.

보내면 바로 공개됩니다. 이메일 주소나 전화번호 같은 개인 정보는 쓰지 마세요. URL은 2개까지입니다.

0 / 1,000자

이 양식은 reCAPTCHA로 보호되며 Google 개인정보처리방침 및 서비스 약관이 적용됩니다.

같은 저장소의 스킬

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월 22일 업데이트

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월 22일 업데이트

変更をコミットしてドラフト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월 22일 업데이트

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

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

hodanov/my-pde32026년 10월 22일 업데이트

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

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

hodanov/my-pde32026년 10월 22일 업데이트

依存パッケージ(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월 22일 업데이트

hodanov의 스킬 모두 보기

이 스킬의 문제 신고