humanlayer/skills

条件は狭く、ルールごとに分ける

すべてに当てはまる広い条件は避けます。下は同じ 3 行を、広い条件と狭い条件で書いた対比です。

<!-- BAD: 何にでもマッチする条件 -->
<important if="you are writing or modifying any code">
- Use absolute imports
- Use functional components
- Use camelCase filenames
</important>

<!-- GOOD: ルールごとに狭いトリガー -->
<important if="you are adding or modifying imports">
- Use `@/` absolute imports (see tsconfig.json for path aliases)
</important>

<important if="you are creating new components">
- Use functional components with explicit prop interfaces
</important>

<important if="you are creating new files or directories">
- Use camelCase for file and directory names
</important>

削る対象と残す対象

Storybook・テスト・モック・デモのために広げられた props 型が、実アプリでは起こらない状態まで表現できてしまっている、という状況を対象にします。方針は一貫しています。実コードパス（live code paths）を props 契約の正とし、ストーリーやテストの側を契約に合わせる。逆方向、つまりテストを楽にするために契約を緩めることは禁じます。

呼び出し元の分類

props の判定

optional と nullable は別物として扱います。実コードが常に渡すが値が空になり得る場合は、focusedItem?: FocusedItem | null ではなく focusedItem: FocusedItem | null のように required かつ nullable にします。

手順

繰り返し可能なエージェントタスクを、スケジュール実行・手動実行・その両方で回る仕組みに変えます。構成要素は 4 つです。エージェントの判断を定義する焦点の狭いスキル、リポジトリ固有のプロンプトでコーディングエージェントを起動するワークフロー、実行をまたいで残るエージェントメモリファイル、そしてループごとに開いている PR を 1 本に保つラベル。参照実装として narrow-react-prop-types が挙げられています。

生成されるファイル

設計の 3 問

完了条件は「ジョブを 1 文で言える」ことです。例として Find 5 react-doctor violations, fix them, and verify typecheck and quality pass. が挙げられています。

スキルは空欄のフォームを出さず、リポジトリの調査結果から既定値を推奨してから 9 項目を確認します。コーディングエージェント、実行頻度、タスク、変更を許すスコープ、コミット前に通す検証コマンド、PR の上限、PR メタデータ（ラベル・タイトル接頭辞・ブランチ接頭辞）、最終応答の書式、/iterate コメントの扱い。

開いている PR を 1 本に保つ

推奨既定値は「ループごとに開いている PR は 1 本」です。上限を設けないと、日次のエージェントが 1 週間で 5 本以上のレビュー待ち PR を作り、レビュー疲れとコンフリクトを生みます。ワークフローはループごとのラベルで自分の PR を識別し、スケジュール実行のときだけ上限を確認して何もせず終了します。手動の workflow_dispatch は上限チェックを迂回します。

# ワークフロー冒頭のゲート（テンプレートより）
EXISTING_PR=$(gh pr list --repo "$GITHUB_REPOSITORY" --state open \
  --label "$AGENT_LABEL" --json number,url --limit 1)

# 実行後：ラベルを用意して PR を作り、ラベルを付ける
gh label create "$AGENT_LABEL" --description "Recurring agent PR" --color "0E8A16" || true
PR_URL=$(gh pr create --title "[$(date +%m/%d)] <Task Title>" --body-file /tmp/pr-body.md)
gh pr edit "$PR_URL" --add-label "$AGENT_LABEL"

PR タイトルの推奨形は [MM/DD][Agent: <Agent Name>]: <Concise Description>。エージェントの最終応答は出力形式が異なる（JSON、stream-json、プレーンテキスト）ため、エージェント別の抽出処理で /tmp/pr-body.md に落としてから PR 本文に使います。

会話中の話題を視覚的に理解させるスキルです。前置きを飛ばし、散文を短く保ち、要点が伝わる最小の表現を選びます。用意されている型は次のとおりです。

HTML を書く場合は、対象プロダクトの色・書体・余白・コンポーネントに合わせ、実際のラベルとデータを使い、デスクトップとモバイルの両方に対応させ、最後に開いて見せます。

Bash(open path/to/show-me-{description}.html)

• GitHub: humanlayer/skills — 本リポジトリ（MIT）
• HumanLayer — 公開元。CodeLayer は同社の軽量エージェントハーネス
• Agent Skills Specification — 生成スキルが参照する仕様
• Claude Code ドキュメント — CLAUDE.md とスキルの前提
• GitHub Actions: ワークフローのトリガー — schedule / workflow_dispatch / issue_comment