Communityコーディング&開発github.com

steipete/agent-scripts

エージェント向けスクリプト集。Peter のワークスペース間で共有しています。

agent-scripts とは?

このリポジトリは、Claude Code や Codex といった AI エージェント向けの共有設定、スキル、軽量ヘルパースクリプトを提供します。`AGENTS.MD` により全ワークスペースで共通のハードルールを適用し、`skills/` ディレクトリ以下に配置された再利用可能なスキルがエージェントの動作をルーティングします。`scripts/sync-skills` を使うと、Codex 向けのシンボリックリンクミラーや Claude Code 向けのフラットなスキルリンクを自動構築でき、複数リポジトリにまたがるスキルの一元管理が可能です。また、`scripts/committer` や `scripts/validate-skills` といったヘルパーにより、コミット前の検証やスキル定義のバリデーションを自動化できます。

対応✓Claude Code✓Codex CLI~Cursor
npx skills add steipete/agent-scripts

Installed? Explore more コーディング&開発 skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

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

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

ドキュメント

Agent Scripts

Peter のローカルワークスペース向けに共有されるエージェント指示、スキル、小型ポータブルヘルパーをまとめたリポジトリです。

このリポジトリは以下の正規の保管場所です。

  • AGENTS.MD: Codex/Claude 系エージェント向けの共有ハードルール
  • skills/: 再利用可能なワークフロースキル(シンボリックリンクで公開されるリポジトリ所有スキルを含む)
  • scripts/: プロジェクト横断で使う依存関係の少ないヘルパー
  • hooks/: スキルバリデーションなどのローカルガードレール

スキル

スキルは主要なルーティング層です。各 skills/<name>/SKILL.md は YAML フロントマターを持ちます。

---
name: skill-name
description: "短い汎用トリガーフレーズ"
---

ルール:

  • 説明は短く汎用的に保ち、ドキュメントではなくルーティングを最適化する。
  • スキル本体は簡潔かつ実用的に保つ。
  • 繰り返し実行されるコマンドがあるワークフローでは、skills/<name>/scripts/ 以下にヘルパースクリプトを置くことを推奨。
  • 編集後は scripts/validate-skills で検証する。
  • フロントマターの description は引用符で囲む。

グローバルな検出は scripts/sync-skills によって構築されます(冪等。クローン後またはスキル追加後、各 Mac で実行)。

  • Codex は入れ子のディレクトリをスキャンするため、ルート全体へのリンクを得ます: ~/.codex/skills/agent-scripts -> ~/Projects/agent-scripts/skills、~/.codex/skills/manager -> ~/Projects/manager/skills。
  • Claude Code は ~/.claude/skills/<name>/SKILL.md のみを読み込みます(正確に1階層深く、エントリごとのシンボリックリンクは追跡されますが、カテゴリサブフォルダはスキャンされません — バージョン2.1.197で確認済み)。両方のリポジトリに加えてマシンローカルの ~/.codex/skills/<name> の拡張部分をカバーするフラットなスキルごとのリンクミラーを取得します。
  • 名前の衝突は agent-scripts > manager > codex-local の優先順位で解決します。スクリプトはスキップされた重複を表示し、壊れたり古い管理リンクを削除します。

共有の個人スキルは skills/ 内の実フォルダとして存在します。公開の OpenClaw 共有スキルは ../agent-skills にあり、追跡された相対シンボリックリンクでここから公開されます。リポジトリ所有スキルは自身のリポジトリで正規の状態を保ち、同じ方法でここから公開されます。例:

skills/autoreview -> ../../agent-skills/skills/autoreview
skills/discrawl -> ../../discrawl/.agents/skills/discrawl

現在シンボリックリンクされているリポジトリ所有スキル: birdclaw, discrawl, gog, imsg, slacrawl, wacli, wacrawl。

エージェント指示

共有ハードルールは AGENTS.MD にあります。

グローバル設定(scripts/sync-skills でも管理されています。Claude Code は CLAUDE.md のみを読み込むため、共有 AGENTS.MD にリンクします):

  • ~/.codex/AGENTS.md -> ~/Projects/agent-scripts/AGENTS.MD
  • ~/.claude/CLAUDE.md -> ~/Projects/agent-scripts/AGENTS.MD
  • ~/.claude/AGENTS.md -> ~/Projects/agent-scripts/AGENTS.MD

下流のリポジトリはポインター形式の AGENTS.MD を使用する必要があります:

READ ~/Projects/agent-scripts/AGENTS.MD BEFORE ANYTHING (skip if missing).

リポジトリ固有のルールはそのポインターの下に記述します。共有ブロックを下流リポジトリにコピーしてはいけません。

ヘルパー

scripts/committer

  • 指定されたファイルのみをステージします。
  • 空でないコミットメッセージを必須とします。
  • コミット前にスキルのバリデーションを実行します。

scripts/sync-skills

  • マシンごとのスキルミラーを構築します: Codex 向けルート全体リンク、Claude 向けフラットなスキルごとのリンク、共有 AGENTS.MD ポインター。
  • 冪等。変更のみを表示し、壊れた古い管理リンクを削除し、実ファイルを上書きしません。

scripts/validate-skills

  • すべての skills/*/SKILL.md をチェックします。
  • YAML フロントマターと必須の name および description を検証します。
  • git config core.hooksPath hooks でローカルフックとして有効にできます。

scripts/docs-list.ts

  • docs/ を走査します。
  • summary と read_when のフロントマターを必須とします。
  • これを組み込んだリポジトリに対してオンボーディングサマリーを出力します。

scripts/browser-tools.ts

  • スタンドアロンの Chrome DevTools ヘルパー。
  • よく使うコマンド: start --profile, nav <url>, eval '<js>', screenshot, console, network, search --content "<query>", content <url>, inspect, kill --all --force。
  • オプションのバイナリを bun build scripts/browser-tools.ts --compile --target bun --outfile bin/browser-tools でビルドできます。

同期

このリポジトリを共有エージェントルールとポータブルヘルパースクリプトの正規の保管場所として扱います。

下流リポジトリを同期する際は:

  • まずここで最新を pull します。
  • 各ターゲットリポジトリがポインター形式の AGENTS.MD で始まっていることを確認します。
  • ポインターの下にあるリポジトリローカルルールは保持します。
  • ヘルパーの変更は、そのヘルパーがバイト単位で同一であるべき場合にのみ双方向にコピーします。
  • スクリプトは依存関係がなくポータブルに保ちます。リポジトリ固有のインポートやパスエイリアスは使用しません。

サブモジュールについては、各サブリポジトリ内でポインターの確認を繰り返し、それらの変更をプッシュし、その後親リポジトリのサブモジュール SHA を更新します。

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

steipete/agent-transcript

GitHub PR/issue agent transcripts: redact, preview, and insert safely.

steipete/beeper

Beeper cache: contact hints, room lookup, WhatsApp/iMessage traces, FTS.

steipete/browser-use

Existing Chrome automation: Chrome plugin first, mcporter fallback.

steipete/clawsweeper-status

ClawSweeper status: URLs, workflow health, active workers, ops snapshot.

steipete/clickclack

ClickClack ops: chat app, Hetzner deploy, DNS/docs/app, Docker rollout.

steipete/cloudflare-registrar

Cloudflare Registrar: domain availability, prices, registration via mcporter.

steipete/codex-debugging

Codex debugging: codex-rs core/tui/exec/cli/app-server/config.

steipete/create-cli

CLI UX/spec: args, flags, help, output, errors, config, dry-run.

steipete/discord-clawd

Discord-backed OpenClaw agent/session relay; not archive search.

steipete/domain-dns-ops

DNS/domain ops: registrars, zones, redirects, DNS/HTTP verify, manager truth.

steipete/frontend-design

Frontend UI: pages, apps, components, polished non-generic design.

steipete/github-author-context

GitHub contributor context: identity, activity, trust, company/team signal.

steipete/github-cache-hygiene

GitHub quota/cache hygiene: gh, ghx, xcache, gitcrawl, mirrors, limits.

steipete/github-deep-review

GitHub deep review: bugs, PRs, best fix, stale-or-real, read code first.

steipete/github-project-triage

GitHub issue/PR triage: queues, CI, blockers, risk, proof, next actions.

steipete/hopper-debugger

Hopper debugging: macOS/iOS binaries, ObjC/Swift symbols, dyld, LLDB.

steipete/instruments-profiling

Instruments/xctrace profiling: macOS/iOS traces, binaries, args, exports.

steipete/mac-maintenance

Mac upkeep: brew update/upgrade, pull clean repos, empty Trash.

steipete/maintainer-orchestrator

Open-source maintainer orchestration: Codex app workers, work recovery, dependencies, vision, releases.

steipete/markdown-converter

Markdown conversion: PDF, Office, HTML, data, OCR, audio, ZIP, YouTube.

関連スキル