Skip to content

add:SKILL追加#1

Open
yoshida-takeshi-classmethod wants to merge 2 commits intoclassmethod:mainfrom
yoshida-takeshi-classmethod:add/claude
Open

add:SKILL追加#1
yoshida-takeshi-classmethod wants to merge 2 commits intoclassmethod:mainfrom
yoshida-takeshi-classmethod:add/claude

Conversation

@yoshida-takeshi-classmethod

Summary

  • Claude CodeでMarp資料を効率的に作成するためのワークフローとSKILLSを追加
  • 3つのスキル(organize-content、slide-design、marp-creator)により、メモから完成スライドまで段階的に作成可能
  • 各ステップで中間成果物を確認でき、手戻りを減らせる構成

追加内容

ワークフロードキュメント:

  • workflow-README.md: フロー全体の説明、SKILLSの使い方、フォルダ構成例

Claude Code SKILLS:

  • organize-content: メモや箇条書きを構造化Markdownに整理(ステップ1)
  • slide-design: 整理済み内容からスライド設計書を作成(ステップ2-A)
  • marp-creator: 設計書に基づきMarp形式のスライドを生成(ステップ2-B)

想定される利用シーン

提案書や勉強会資料の作成時に、内容の整理とスライド化を分離して進められる。各工程でフィードバックを受けやすく、品質を段階的に高められる。

Copy link
Collaborator

@ShuntaToda ShuntaToda left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

コメントしました!

@@ -0,0 +1,276 @@
# Marp資料作成フロー
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

このスキル達の目的はmarpのスライドを作成することなので一つにまとめられると思います。

こちらのベストプラクティスに従ってまとめていただきたいです
https://arc.net/l/quote/akyosrwp

marp-creatorという一つのskillにまとめるときの例(名前は自由でOKです)

.claude/
└─ skills/
   └─ marp-creator
      ├─ organize-content.md
      ├─ slide-design.md
      ├─ build-marp.md
      ├─ get-sample-slide.md
      └─ SKILL.md

@@ -0,0 +1,375 @@
---
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

サンプルスライドはアップデートにより変更されるかもしれないので最新のデータを取得するようにしていただきたいです
curlコマンドを利用すると公開されているサンプルスライドのコメントまで全て取得できるようになります

取得の指示の例

## テーマのサンプルスライドの取得方法

必ずこのコマンドを実行してサンプルスライドを取得してください。

curl -s https://raw.githubusercontent.com/classmethod/classmethod-marp-theme/main/sample-slide.md

Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

https://github.com/classmethod/classmethod-marp-theme/pull/1/changes#r2814703488

このコメントと同じでget-sample-slide.mdのような取得方法の記載をしたファイルを作るといい気がします(参考程度で🙏)

@yoshida-takeshi-classmethod
Copy link
Author

@ShuntaToda

概要

marp-creatorスキルをClaude Codeのベストプラクティス(段階的開示パターン)に従って再構成しました。

参考: https://platform.claude.com/docs/ja/agents-and-tools/agent-skills/best-practices

変更内容

1. SKILL構成の統合

3つの独立したSKILLフォルダを1つに統合しました。

変更前:

  • .claude/skills/marp-creator/
  • .claude/skills/organize-content/
  • .claude/skills/slide-design/

変更後:

  • .claude/skills/marp-creator/ に統合
    • SKILL.md(概要とナビゲーション)
    • organize-content.md(ステップ1の詳細)
    • slide-design.md(ステップ2の詳細)
    • build-marp.md(ステップ3の詳細)
    • get-sample-slide.md(サンプル取得方法)

2. その他の変更

項目 変更内容
サンプルスライド ローカルコピー → curlで最新版を取得
出力先 ユーザー確認 → 入力ファイルと同じフォルダに自動配置
ステップ番号 1, 2-A, 2-B → 1, 2, 3(ファイル連番と整合)

確認してほしい点

  • SKILLの分割粒度は適切か
  • ワークフローの説明は分かりやすいか
  • 不足している情報はないか

Copy link
Collaborator

@ShuntaToda ShuntaToda left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

修正ありがとうございます。
追加で一点だけコメントしました

Comment on lines +10 to +23
## ワークフロー

3つのステップで資料を作成する。

```
メモ・要件(任意の形式・ファイル名)
[ステップ1] 内容整理 → 01_organized_*.md
[ステップ2] スライド設計 → 02_slide-design_*.md
[ステップ3] Marp資料作成 → 03_marp_*.md(最終成果物)
```

Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

一度使ってみたところステップ1から3まで勝手に進んでしまいました。
そのためワークフローを人間のチェックを確実に入れるように修正した方がいいと思いました。
他にも少しだけ注意書きを増やしたほうがいいかもしれません。

メモ・要件(任意の形式・ファイル名)
    ↓
[ステップ1] 内容整理 → 01_organized_*.md
    ↓
※ ユーザー確認(内容の過不足、構成の修正)
    ↓
[ステップ2] スライド設計 → 02_slide-design_*.md
    ↓
※ ユーザー確認(スライド構成、レイアウト、枚数)
    ↓
[ステップ3] Marp資料作成 → 03_marp_*.md(最終成果物)

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@yoshida-takeshi-classmethod
自分がテストした際は、一つずつ確認しながら実行してくれたんですけどね。。。
ちょっと実際の挙動を確認させてください。

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants