Skills · Claude Code · Agent Skills

スキルはソフトウェアパッケージ:バージョン、ゲート、リリース — 交渉の余地なし。

カタログのスキルを、完全な構成、簡潔な description、4 か所で揃ったバージョン、赤ケース付きでテスト済みのスクリプト、ゲートが緑のときだけのリリースで作成・保守する。

v0.2.0Disciplina · Autoria de skillsgithub.com/schematizeme/skill-skill-dev

メンテナー Lucas Andrade

schematize-skill-dev · v0.2.0bash
$ schematize install skill-dev
GitHub →スキル (.zip) をダウンロード/skill-dev-help · github.com/schematizeme/schematize-cli

譲れない基準

「速くするため」に無効化しない。完全な一覧はスキルに。

スキルごとに 1 リポジトリ

ディレクトリは skill-[slug]、name は schematize-[slug]、専用の公開リポジトリ、コマンド接頭辞はカタログ内で一意。

完全な構成

SKILL.md、skill.toml、VERSION、CHANGELOG、README、LICENSE、install.sh、assets、references、scripts、versions/ のスナップショット。パッケージ内に zip を置かない。

境界を示す短い description

350 文字以内の >- ブロック:何であるか、具体的な利用トリガー、隣接スキルとの境界。他スキルの領域は主張しない。

4 か所で同じバージョン

VERSION、skill.toml、frontmatter、SKILL.md のバージョン行が一致し、CHANGELOG が理由を説明し、skills.json も追随する。

継承ブロックは手で触らない

元は schematize-engineering。そこで変更して sync を実行し、スキル内の継承ブロックを直接編集しない。

全スクリプトに赤と緑のテスト

赤のケースが通る前に失敗するのを確認する。落とせないゲートは飾りにすぎない。

ゲートが緑のときだけリリース

クリーンなツリー、同期済みの main、明示リストでの git add、注釈付きタグ、トップレベルが schematize-[slug]/ の zip、その後グラフと skills.json を再生成。

コマンド

.claude/commands/ にインストール。いつでも /skill-help を実行。

/skill-bump4 か所のバージョンを上げ、スナップショットを作り、CHANGELOG の記載を求める。
/skill-ccContext compact:コンテキストとチェックリストをアーカイブに書き出し、/compact を実行。
/skill-claude常時オンの skill-dev 用 CLAUDE.md をルートに作成またはマージ(他スキルのブロックは上書きしない)。
/skill-handoffコンパクトせずにコンテキストの handoff を作成 — セッション終了やタスク切り替え。
/skill-helpすべてのコマンドを一覧表示。
/skill-load規範の全文を強制ロード:構成、description、継承ブロック、lint とテスト、リリース、カタログ。
/skill-newすでにゲートを通る新スキルの完全なひな形を作る。
/skill-releaseリリース手順:ゲート、bump、スナップショット、zip、タグ、GitHub Release、グラフ、skills.json。
/skill-reviewスキルを基準に照らして監査:ゲート、カタログ lint、機械が読めない部分の確認。

AI エージェント向け

人手を介さずにインストール。メタデータは llms.txt。

  • 実行: git clone https://github.com/schematizeme/skill-skill-dev.git && ./skill-skill-dev/install.sh
  • またはダウンロード: https://github.com/schematizeme/skill-skill-dev/releases/latest/download/skill-skill-dev.zip を .claude/skills/ に展開
  • assets/CLAUDE.md をリポジトリのルートにコピー(常時オンのルール)。
  • /skill-help で確認。

インストールしたくない?

完全な規約を読み、そのままプロジェクトにコピーできます。あるいはスキルをインストールすれば、エージェントが自動で適用します。