skill-librarian-commands

スキルライブラリの管理、検索、一覧表示、構造検証を行うコマンド群を提供するスキル。スキルの発見、品質検証、使用状況の記録を効率化し、スキルエコシステムの健全性を維持する。Anchors:• The Pragmatic Programmer (Hunt & Thomas) / 適用: 自動化・ツール設計 / 目的: 効率的なスキル管理• 18-skills.md / 適用: スキル構造・検証基準 / 目的: 品質基準の担保• Unix Philosophy / 適用: 小さなツールの組み合わせ / 目的: 柔軟なコマンド設計Trigger:Use when listing skills, validating skill structure, searching for skills, or managing skill metadata.skill list, skill search, skill validation, skill management, librarian commands

⭐3stars🔀0forks📁View on GitHub🕐Updated Jan 10, 2026

When & Why to Use This Skill

The Skill Librarian Commands is a comprehensive management toolkit designed to maintain the health and efficiency of a Claude skill ecosystem. It provides a standardized framework for discovering, searching, and validating skill structures while tracking usage data to ensure high-quality agent performance and prevent redundant development.

Use Cases

  • Skill Discovery and Inventory Management: Use the list and search commands to navigate large skill repositories, helping developers identify existing capabilities and avoid 'reinventing the wheel'.
  • Automated Quality Assurance: Implement the validation command in development workflows to ensure all new skills adhere to the 18-skills.md structural specifications and quality standards.
  • Performance Monitoring and Observability: Utilize the usage recording feature to log success and failure rates, providing critical data for debugging and optimizing skill reliability over time.
  • Ecosystem Standardization: Maintain a clean and professional skill library by enforcing Unix-style modularity and consistent metadata across all integrated tools.
nameskill-librarian-commands
description|
• The Pragmatic Programmer (Hunt & Thomas) / 適用自動化・ツール設計 / 目的: 効率的なスキル管理
• 18-skills.md / 適用スキル構造・検証基準 / 目的: 品質基準の担保
• Unix Philosophy / 適用小さなツールの組み合わせ / 目的: 柔軟なコマンド設計

Skill Librarian Commands

概要

スキルライブラリの管理・検索・検証を行うコマンド群を提供するスキル。 スキルの発見性向上、品質維持、使用状況追跡をサポートする。


ワークフロー

list-skills → search-skills → validate-skill → record-usage

Task 1: スキル一覧(list-skills)

利用可能なスキルの一覧を表示する。

Task: agents/list-skills.md を参照

Task 2: スキル検索(search-skills)

キーワードや条件でスキルを検索する。

Task: agents/search-skills.md を参照

Task 3: スキル検証(validate-skill)

スキルの構造が18-skills.md仕様に準拠しているか検証する。

Task: agents/validate-skill.md を参照

Task 4: 使用記録(record-usage)

スキルの使用状況を記録する。

Task: agents/record-usage.md を参照


Task仕様(ナビゲーション)

Task 責務 入力 出力
list-skills スキル一覧表示 なし/フィルタ条件 スキル一覧
search-skills スキル検索 検索キーワード 該当スキルリスト
validate-skill 構造検証 スキルパス 検証レポート
record-usage 使用記録 スキル名・結果 LOGS.md更新

詳細仕様: 各Taskの詳細は agents/ ディレクトリの対応ファイルを参照 注記: 1 Task = 1 責務。必要なコマンドのみ実行する。


コマンドリファレンス

スキル一覧表示

node .claude/skills/skill-librarian-commands/scripts/list-skills.mjs
node .claude/skills/skill-librarian-commands/scripts/list-skills.mjs --format table
node .claude/skills/skill-librarian-commands/scripts/list-skills.mjs --filter "database"

スキル検証

node .claude/skills/skill-librarian-commands/scripts/validate-skill.mjs .claude/skills/<skill-name>
node .claude/skills/skill-librarian-commands/scripts/validate-skill.mjs .claude/skills/<skill-name> --verbose

使用記録

node .claude/skills/skill-librarian-commands/scripts/log_usage.mjs --skill <skill-name> --result success
node .claude/skills/skill-librarian-commands/scripts/log_usage.mjs --skill <skill-name> --result failure --reason "エラー詳細"

ベストプラクティス

すべきこと

推奨事項 理由
新規スキル作成後は必ず検証を実行する 品質基準の担保
スキル使用後は使用記録を残す フィードバックループの維持
定期的にスキル一覧を確認する 重複スキルの発見
検索機能で類似スキルを確認する 再発明の防止

避けるべきこと

禁止事項 問題点
検証なしでスキルを公開する 品質基準違反のリスク
使用記録を残さない 改善のためのデータ不足
スキル名の重複を放置する 発見性の低下

リソース参照

scripts/(決定論的処理)

スクリプト 用途 使用例
list-skills.mjs スキル一覧表示 node scripts/list-skills.mjs --format table
validate-skill.mjs 構造検証 node scripts/validate-skill.mjs .claude/skills/xxx
log_usage.mjs 使用記録 node scripts/log_usage.mjs --skill xxx --result ok

references/(詳細知識)

リソース パス 読込条件
コマンド詳細 references/command-reference.md コマンドオプション詳細が必要時
スキル構造ガイド references/skill-structure-guide.md 検証基準の詳細が必要時

assets/(テンプレート)

アセット 用途
assets/resource-template.md リソースファイル作成テンプレート

変更履歴

Version Date Changes
2.0.0 2026-01-02 18-skills.md仕様準拠で全面改訂
1.0.0 2025-12-24 初版作成