はじめに
Claude Code Skillsを自作したいけど、どう設計すればいいかわからない...そんな悩みはありませんか?
今回紹介するskillboxは、superpowersにインスパイアされた5つのユーティリティスキル集です。Star数は少ないですが、**スキル設計のパターン分類(A-E)**という独自の視点が光ります。
特にgenerate-skillとrate-skillの組み合わせで、スキル作成→品質評価のフィードバックループが完結するのが特徴です。
評価スコア: 47/50 (Rank S)
基本情報
| 項目 | 内容 |
|---|---|
| リポジトリ | https://github.com/AntJanus/skillbox |
| 作者 | Antonin Januska (AntJanus) |
| Star数 | 1 |
| スキル数 | 5 |
| 形式 | スキルコレクション |
ファイル構成
skillbox/
├── README.md
├── CLAUDE.md # プロジェクト指針
├── AGENTS.md # エージェント設定
└── skills/
├── track-session/
│ └── SKILL.md # セッション進捗管理
├── git-worktree/
│ └── SKILL.md # Git Worktree並列開発
├── generate-skill/
│ └── SKILL.md # スキル自動生成(619行)
├── ideal-react-component/
│ └── SKILL.md # Reactコンポーネント構造(587行)
└── rate-skill/
└── SKILL.md # スキル品質評価
含まれるスキル
| スキル | 機能 | 行数 |
|---|---|---|
| track-session | セッション進捗管理・TODO追跡 | 約200行 |
| git-worktree | Git Worktreeによる並列開発支援 | 約150行 |
| generate-skill | パターン分類に基づくスキル自動生成 | 619行 |
| ideal-react-component | Reactコンポーネント設計パターン | 587行 |
| rate-skill | スキル品質の10項目評価 | 約300行 |
主要機能
1. パターン分類体系(Pattern A-E)
generate-skillでは、スキルを5つのパターンに分類しています。
Pattern A: Workflow (手順型)
- 明確なステップバイステップの手順
- 例: TDD、コードレビュー
Pattern B: Knowledge Base (知識ベース型)
- ドメイン固有の知識を提供
- 例: API仕様、コーディング規約
Pattern C: Tool Integration (ツール統合型)
- 外部ツールとの連携
- 例: Playwright、Docker
Pattern D: Quality Gate (品質ゲート型)
- 品質チェックポイント
- 例: セキュリティ監査、パフォーマンス検証
Pattern E: Meta-skill (メタスキル型)
- スキル自体を生成・評価
- 例: generate-skill、rate-skill
この分類により、目的に応じたスキル設計テンプレートを選択できます。
2. generate-skill + rate-skill のフィードバックループ
[generate-skill]
↓
スキル生成
↓
[rate-skill]
↓
品質評価(10項目×10点=100点満点)
↓
改善点の特定
↓
[generate-skill で修正]
この循環により、スキル開発のTDD(テスト駆動開発)が実現します。
3. 記法パターンの標準化
各スキルで統一された記法パターンが使用されています。
Good/Bad タグ
### Good
- 具体的な例
- 推奨パターン
### Bad
- アンチパターン
- 避けるべき例
Red Flags セクション
## Red Flags
| Pattern | Resolution |
|---------|------------|
| No tests | Add unit tests |
| any type | Add proper typing |
hooksフィールド(YAML frontmatter)
---
name: my-skill
description: ...
hooks:
- PreToolUse: validate
- PostToolUse: format
---
4. CLAUDE.md + AGENTS.md の二重構造
CLAUDE.md: プロジェクト全体の指針・ルール
AGENTS.md: 各エージェント(Claude)の役割・制約
この分離により、AIのオンボーディングが体系化されています。
各スキル詳細
track-session
セッション中のタスク進捗を追跡。
## Current Session
- [x] Task 1: Implement login
- [ ] Task 2: Add validation
- [ ] Task 3: Write tests
## Blockers
- API spec not finalized
git-worktree
Git Worktreeを活用した並列開発支援。
# 新しいworktreeを作成
git worktree add ../feature-branch feature-branch
# 一覧表示
git worktree list
# 削除
git worktree remove ../feature-branch
ideal-react-component
Reactコンポーネントの設計パターン集(587行)。
- Atomic Design原則
- Props設計のベストプラクティス
- 状態管理の選択基準
- テスト戦略
rate-skill
スキルの品質を10項目で評価。
| 評価項目 | 最大点 |
|---|---|
| 目的の明確さ | 10 |
| ワークフロー設計 | 10 |
| ユーザーインタラクション | 10 |
| 出力定義 | 10 |
| 再利用性 | 10 |
| 拡張性 | 10 |
| 補助ファイル | 10 |
| エッジケース | 10 |
| ドキュメント品質 | 10 |
| 独自性 | 10 |
合計100点満点でスキルを評価します。
注意点
- 500行ルール違反: 作者自身が定めた「スキルは500行以内」ルールを、generate-skill(619行)とideal-react-component(587行)が違反しています
- Star数が少ない: まだ認知度は低いですが、設計思想は優れています
- superpowers依存: 一部の思想はsuperpowersから継承されています
評価詳細
| 評価項目 | 点数 | コメント |
|---|---|---|
| 明確な目的定義 | 5/5 | 各スキルの目的が明確 |
| ファイル構成の論理性 | 5/5 | skills/以下に整理 |
| ワークフロー設計 | 5/5 | パターン分類が体系的 |
| 参照ファイルの有用性 | 5/5 | CLAUDE.md+AGENTS.mdの二重構造 |
| 記法・フォーマットの一貫性 | 5/5 | Good/Bad、Red Flags統一 |
| 再利用性 | 4/5 | 一部superpowers依存 |
| エラーハンドリング | 4/5 | rate-skillで品質評価 |
| ドキュメント品質 | 5/5 | 詳細な説明 |
| 拡張性 | 5/5 | パターン追加容易 |
| 実用性 | 4/5 | 500行ルール違反が気になる |
合計: 47/50 (Rank S)
まとめ
skillboxは「スキルをどう設計するか」を学ぶのに最適なリポジトリです。
- **パターン分類(A-E)**でスキル設計を体系化
- generate-skill + rate-skillでフィードバックループ完結
- Good/Bad、Red Flags等の記法パターンが参考になる
- CLAUDE.md + AGENTS.mdの二重構造でAIオンボーディング
自分でスキルを作りたい方は、まずこのリポジトリの設計思想を学ぶことをおすすめします。