Claude Code Skills
revsystem/claude-code-skills
Skills, agentes e hooks personalizáveis para Claude Code com versionamento Git
Ver no GitHubRepositório de gerenciamento de skills, agentes e hooks para Claude Code via Git. Inclui skills para geração de notas de handover, planejamento de pesquisa, um agente de revisão Terraform e hooks para automação de contexto.
Instalação
npx convez-ai revsystem/claude-code-skills1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
Casos de uso
- Gerar notas estruturadas de transição entre sessões
- Revisar código Terraform com foco em segurança e custos
- Automatizar fluxos de pesquisa, planejamento e anotação antes de implementação
- Gerenciar lembretes automáticos quando contexto atinge limites
Veredito

Coleção pragmática de extensões para Claude Code com foco em continuidade de contexto e qualidade de revisão. Bem estruturada para workflows técnicos, especialmente útil para equipes que precisam manter continuidade entre sessões e aplicar revisões padronizadas.
README
A tradução para o português deste README ainda está na fila.
Claude Code Skills - 個人スキル・フック管理リポジトリ
Claude Code のパーソナルスキル、エージェント、フックスクリプトを Git 管理するリポジトリです。スキルは gh skill install でインストールし、~/.claude/skills/ にファイルがコピーされます。エージェントとフックは install.sh でインストールし、~/.claude/agents/ および ~/.claude/hooks/ にシンボリックリンクが作成されてリポジトリ上の変更が即時反映されます。
スキル一覧
| スキル | 概要 | 使い方 | 備考 |
|---|---|---|---|
handover | セッション終了時に構造化された引き継ぎノートを生成し、次セッションへの文脈継続を支援する | /handover または「引き継ぎノートを生成して」 | Stop フックと連携 |
research-plan-annotate | 実装前に「調べる → 計画する → 注釈で磨く」を回し、research.md / plan.md を成果物とする | /research-plan-annotate |
スキルは Claude Code 上でインライン実行されます(自然言語や /name で起動)。
エージェント一覧
| エージェント | 概要 | 起動 | モデル |
|---|---|---|---|
terraform-code-reviewer | Terraform のセキュリティ・ベストプラクティス・パフォーマンス・コストの観点からレビュー | .tf がある文脈で「この Terraform をレビューして」など自然言語 | inherit |
inherit は Claude Code の実行モデルを継承します。~/.claude/agents/ に配置されたエージェントは description に基づき自律 spawn され、settings.json への追記は不要です。terraform-code-reviewer は read-only 構成(Read, Grep, Glob)で、ファイルの修正適用は行わず分析と改善提案までを担います。
推奨ポリシー(任意)
~/.claude/CLAUDE.md に以下を追記すると、Terraform レビューを read-only サブエージェントへ委譲する運用を固定できます。自律 spawn の起動を確実にし、レビュー役がファイルを書き換えないことで客観的な視点を保ちます。
## コードレビュー方針
- Terraform(.tf)のレビューは read-only の terraform-code-reviewer エージェントに委譲する
- レビュー役はファイルを修正しない。提案の適用は呼び出し元のセッションが行う
フック一覧
| フック | 種別 | 役割 |
|---|---|---|
stop-handover-reminder.sh | Stop | コンテキスト使用率が閾値(既定 70%)を超えたとき、1 セッション 1 回だけ /handover 実行を促す |
インストール
前提条件
- Claude Code がインストールされていること
jqがインストールされていること(フックスクリプトが使用)uvxがインストールされていること(terraform-code-reviewerエージェントの MCP サーバー起動に使用)
uvをインストールする場合
curl -LsSf https://astral.sh/uv/install.sh | sh
gh skill でインストール(スキルのみ)
GitHub CLI v2.90.0 以降の gh skill コマンドでスキルをインストールできます。以下はClaude Codeのスキルとしてインストールする場合の例です。Github CopilotやGemini CLIなどその他のコーディングエージェントのスキルとしてインストールする場合は、--agent引数にそのエージェント名を指定してください。プロジェクトスコープにインストールする場合は、--scope引数にprojectを指定します。 詳細は公式ドキュメント gh skill install を参照してください。
すべてのスキルをインストールする場合
gh skill install revsystem/claude-code-skills --agent claude-code --scope user
個別のスキルを指定する場合
gh skill install revsystem/claude-code-skills handover --agent claude-code --scope user
インストール済みスキルを最新化する場合
gh skill update --all
エージェントとフックは gh skill の管理対象外です。これらも含めた完全なセットアップには、以下の install.sh を使用してください。
install.sh でインストール(hooks と agents)
- リポジトリをクローンする
git clone https://github.com/revsystem/claude-code-skills.git
cd claude-code-skills
- インストールスクリプトを実行する
./install.sh
以下のシンボリックリンクが作成されます(全件インストール時)。
~/.claude/agents/terraform-code-reviewer.md → {REPO}/agents/terraform-code-reviewer.md
~/.claude/hooks/stop-handover-reminder.sh → {REPO}/hooks/stop-handover-reminder.sh
- フックを
~/.claude/settings.jsonに設定する
{
"hooks": {
"Stop": [
{
"hooks": [
{
"type": "command",
"command": "bash ~/.claude/hooks/stop-handover-reminder.sh",
"timeout": 5
}
]
}
]
}
}
- CLAUDE.md にセッション引き継ぎの指示を追加する
~/.claude/CLAUDE.md に以下を追加します。
# セッション引き継ぎ
- セッション開始時にプロジェクトルートの `.claude/handovers/` ディレクトリを確認し、ファイルが存在すれば最新のものを読み込む
- コンテキスト使用率が高くなると Stop フックが `/handover` の実行を促す
- 任意のタイミングで `/handover` を実行すれば手動でも引き継ぎノートを生成できる
使用方法
handover
レスポンス終了ごとに Stop フックがコンテキスト使用率(トランスクリプトの usage トークン数から算出)を監視し、既定 70% を超えた時点で /handover 実行を促します。手動で生成したい場合は Claude に依頼します。
/handover
CLAUDE.md の指示により、次のセッション開始時に Claude が自動で最新の引き継ぎノートを確認します。
引き継ぎノートの例
.claude/handovers/
├── 2026-03-08_2130.md
├── 2026-03-07_1845.md
└── 2026-03-06_1200.md
# セッション引き継ぎノート
日時: 2026-03-08 21:30
## 今回やったこと
- handover スキルをプラグインリポジトリで管理する方式を設計・実装
## 決定事項
- スキルはリポジトリで管理し、symlink で ~/.claude/skills/ に配置する方式を採用
## 捨てた選択肢と理由
- Plugin Agent 方式: sub-agent は親の会話履歴にアクセスできず、context handoff が必要になるため質が落ちる
## 次にやること
- GitHub にリモートリポジトリを作成して push する
## 関連ファイル
- ~/.claude/skills/handover/SKILL.md
- ~/.claude/hooks/stop-handover-reminder.sh
- ~/.claude/settings.json
research-plan-annotate
コードを書く前に「調べる → 計画する → 注釈で磨く」を回すワークフロースキルです。
/research-plan-annotate <タスクの説明>
アーキテクチャ
claude-code-skills/
├── install.sh # hooks・agents セットアップスクリプト
├── skills/
│ ├── handover/
│ │ └── SKILL.md # handover スキル定義
│ └── research-plan-annotate/
│ └── SKILL.md # 調査・計画・注釈サイクルスキル定義
├── agents/
│ └── terraform-code-reviewer.md # terraform-code-reviewer エージェント定義
└── hooks/
└── stop-handover-reminder.sh # Stop フック(コンテキスト監視)
agents/{agent-name}.md を編集すると、シンボリックリンク経由で即時反映されます。新しいエージェントを追加した後は ./install.sh を再実行してリンクを作成してください。
ライセンス
このプロジェクトは MIT License の下で公開されています。