Communityライティング&編集github.com

ayush8620/skillsmith

新しいエージェントスキルを作成し、既存のSKILL.mdファイルをエージェントスキルオープンスタンダード(agentskills.io)に対して検証します。ユーザーがエージェントスキルの作成、スキャフォールディング、リンター、チェック、修正を希望する場合や、SKILL.mdが有効かどうかを尋ねた場合に使用します。生成にはGemini API経由でGoogle Gemma 4(オープンウェイト)を使用し、検証はオフラインで動作します。

skillsmith とは?

SkillSmithは、エージェントスキルの作成と検証を効率化するCLIツールです。ユーザーが一行のアイデアから仕様に準拠した新しいスキルを生成できるほか、既存のSKILL.mdファイルをエージェントスキルオープンスタンダードに照らして検証(名前ルール、説明の長さと「Use when」句、互換性制限、メタデータマップ、本文の長さ、シークレット漏洩のチェック)します。このツールは、Claude Code、Cursor、Codexなど、あらゆるエージェントスキルプラットフォームと互換性があり、ゼロ依存のシングルファイルCLI(cli.js)として提供されるため、インストールや設定の手間がかかりません。スキル生成時にはGemini APIを通じてGoogle Gemma 4(オープンウェイト)モデルを利用し、検証機能は完全にオフラインで動作するため、プライバシーを保ちながら迅速にチェックできます。SkillSmithは、エージェントスキルの標準化を促進し、開発者が高品質で一貫性のあるスキルを簡単に作成・保守できるようにします。

対応✓Claude Code~Codex CLI~Cursor✓Gemini CLI
npx skills add https://github.com/ayush8620/skillsmith/tree/HEAD/skills/skillsmith

Installed? Explore more ライティング&編集 skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

skillsmith は何をしますか?

一行のアイデアから仕様準拠のエージェントスキルをスキャフォールディングし、SKILL.mdファイルをリントします(名前ルール、説明の長さと「Use when」句、互換性制限、メタデータマップ、本文の長さ、シークレット漏洩)。 ゼロ依存のCLIcli.jsがSkillSmithリポジトリのルートにあり、処理を実行します。

使用するタイミング

  • ユーザーがタスク用の新しいスキルを希望する場合(「~するスキルを作って」など)。
  • ユーザーがスキルフォルダやSKILL.mdが標準に従っているかどうかを知りたい場合、または修正を希望する場合。

手順

  1. 検証するには、node <path-to-skillsmith>/cli.js validate <skill-dir>を実行します(複数のフォルダを指定可能)。終了コード0は有効を意味します。
  2. すべてのerrorを報告し、ユーザーのSKILL.mdで修正します:名前を小文字ハイフン区切りに変更し、フォルダ名をnameと一致させ、descriptionを1024文字以内にし、「Use when …」を含めます。その後、手順1を再実行します。
  3. スキルを作成するには、GEMINI_API_KEYが設定されていることを確認し(決して表示しない)、次を実行します: node <path-to-skillsmith>/cli.js new "<機能と使用するタイミング>" --out <skills-dir> --author "<名前>"
  4. 生成されたSKILL.mdをユーザーに表示し、新しいフォルダに対して手順1を実行します。必要に応じて編集します。CLIは既存のSKILL.mdを上書きしません。

例

  • node cli.js validate skills/commitcraft skills/skillsmith
  • node cli.js new "CSVファイルを要約し、グラフを提案する。ユーザーが.csvを共有したときに使用" --out ./skills

注意事項

  • 未知のトップレベルフィールドは警告を生成します。カスタムデータはmetadataの下に配置してください。
  • 仕様では本文を500行未満にすることを推奨しています。長いドキュメントはreferences/に移動してください。

関連スキル