steipete/agent-scripts

Scripts for agents, shared between my repositories.

What it solves

複数のローカルワークスペース間で、共有指示、再利用可能なスキル、ポータブルヘルパースクリプト（特に Codex と Claude Code エージェント）を管理する集中システムを提供します。これにより、個々のプロジェクトリポジトリごとにルールやワークフローを重複させる必要がなくなります。

How it works

プロジェクトは、グローバルエージェントルールを格納する正規リポジトリ（AGENTS.MD）と、YAML フロントマターで定義された SKILL.md ファイル群からなるスキルライブラリを使用します。同期スクリプト（sync-skills）は、エージェントの設定ディレクトリ（例: ~/.codex/ や ~/.claude/）にシンボリックリンクを作成し、ユーザーが現在作業中のプロジェクトに関係なく、さまざまな AI エージェントがこれらの共有スキルとルールを検出・利用できるようにします。

Who it’s for

Claude Code や Codex などの AI エージェントを多数のリポジトリで使用し、ローカル環境全体で一貫した「ハードルール」や運用ワークフロー（スキル）を維持したい開発者向けです。

Highlights

  • Centralized Rule Management: 単一の AGENTS.MD ファイルを使用し、複数のエージェント設定へシンボリックリンクすることで、一貫した動作を保証します。
  • Skill Routing: YAML メタデータを用いた構造化スキルシステムを実装し、短いフレーズでエージェントが特定のワークフローをトリガーできるようにします。
  • Cross-Repo Integration: 他リポジトリのスキルを中央ハブにシンボリックリンクでき、リポジトリ固有のスキルはそのプロジェクト内に正規化されたまま、グローバルに利用可能にします。
  • Portable Helpers: スキル検証、コミット管理、Chrome DevTools 自動化などのタスク向けに、依存性が軽いスクリプトを含みます。