claudeers.
// Claude Skills

agent-settings

Best Practices for Claude Code Configuration

// Claude Skills[ cli ][ api ][ claude ]#claude#ai#ai-agents#claude-code#claude-skill#codex#codex-cli#llm#skills◷ MIT$open-sourceupdated 27 days ago
Actively maintained
100/100
last commit 12 days ago
last release none
releases 0
open issues 0

Install with your AI

Paste into Claude Code, Cursor, or any agent — it reads the repo and wires the tool into your project.

Install and set up agent-settings (git-clone project) into my current project.
Found on https://claudeers.com/agent-settings
Repo: https://github.com/nokonoko1203/agent-settings
Homepage/docs: —
Detected install method: git-clone → git clone https://github.com/nokonoko1203/agent-settings
Category: skills. Platforms: cli, api.
Read the repo's README for exact setup and env vars, then install it and wire it into my project.

Claudeers Health Verdict:
active; community-verified: false. Confirm the source before running anything.
// or clone
git clone https://github.com/nokonoko1203/agent-settings

// compatibility

Platformscli, api
Operating systems—
AI compatibilityclaude
LicenseMIT
Pricingopen-source
LanguagePython

Get your FREE $2.50 API credits to access TickAtlas financial data ↗

Claude CodeとCodexの個人設定集

軽い設定を勧めていた旧版は、タグv1にあります。エージェントに任せる範囲が広がり、作業の重さの判断・hook・証拠・レビューで品質を担保する仕組みが必要になったため、方針を変えました。

Claude CodeとCodexで使う設定、ルール、hook、スキルをまとめています。claude/とcodex/は同じ開発フローとスキルセットで揃えており、codex/AGENTS.mdはclaude/CLAUDE.mdと同じ内容です。

開発フロー

  1. 作業の前に重さ(E/0/1/2/R)を決めてharness-log triageで記録する。マイグレーション・認可・公開API・データ削除・課金・本番反映はレベル2以上。
  2. 調査はimozuru・research、既存コードの理解はhow・why。
  3. 動かさないと分からない実装はspike-rebuildで、試作して捨ててから作り直す。
  4. 設計はspecで、受け入れ条件に[test]・[check]・[human]の印を付ける。レベル1・2はplaybookの手順書に沿う。
  5. 実装は、Claude CodeからcodexスキルでCodex(Sol)に頼める(「solで実装して」のように頼んだときだけ使われる)。ゴール・完了条件・範囲・背景・出力・止まる条件をまとめた指示書はClaude Code(Opus)に書かせる。Solの報告だけで完了とせず、差分とテスト結果はClaude Codeが自分で確かめる。
  6. 実装中はhookが危険な操作を止め、終わる前にmake checkと証拠(.tmp/evidence/<task>/evidence.md)を確かめる。
  7. コード変更後はreviewerサブエージェントでレビューし、PRを作る。マージは人が行う。
  8. 指摘はharness-log correctionで記録し、同じ間違いが続いたらcorrectで再発を防ぐ。記録はharness-reportで集計する。

詳細はclaude/CLAUDE.mdを参照してください。

構成

.
├── README.md
├── LICENSE
├── MANIFEST.txt
├── claude/                 # ~/.claude/ に展開する
│   ├── CLAUDE.md
│   ├── settings.json       # hook・権限・環境変数
│   ├── agents/             # reviewer
│   ├── bin/                # harness-log, harness-report
│   ├── hooks/
│   ├── references/         # evidence.mdの形式など
│   ├── rules/
│   └── skills/
└── codex/                  # ~/.codex/ に展開する
    ├── AGENTS.md
    ├── config.toml
    ├── hooks.json
    ├── hooks/
    ├── rules/
    └── skills/

詳細なファイル一覧はMANIFEST.txtを参照してください。

必要なツール

ツール用途
uvharness-reportの実行
python3Python製hookの実行
jqhookでのJSON処理
makestop-check.shがmake checkを実行する
shasumstop-check.sh・evidence-check.shの状態管理(Linuxではperlのshasumが必要な場合がある)
git、ghブランチ保護のhook、PR作成
codexcodexスキル(Claude CodeからCodexに作業を頼む)
op(1Password CLI)シークレットの注入(rules/secrets-1password.md)
ctx7Context7でライブラリの最新仕様を確かめる。npmパッケージctx7で、bunx ctx7 library <name> <query>のように実行できる。CLAUDE.mdはctx7コマンドで呼ぶので、PATHの通る場所にbunx ctx7 "$@"を実行するラッパーを置くか、各自インストールする

使い方

claude/の中身を~/.claude/に、codex/の中身を~/.codex/に配置します。以下は、このリポジトリのルートで実行する例です。既存の設定があれば、先にバックアップを取ります。

cp -a ~/.claude ~/.claude.backup.$(date +%Y%m%d%H%M%S)
cp -a ~/.codex ~/.codex.backup.$(date +%Y%m%d%H%M%S)

まだ存在しないディレクトリのバックアップは不要です。設定先を作り、設定ファイル以外をコピーします。

mkdir -p ~/.claude ~/.codex
rsync -a --exclude settings.json claude/ ~/.claude/
rsync -a --exclude config.toml codex/ ~/.codex/
chmod +x ~/.claude/bin/* ~/.claude/hooks/*

claude/settings.jsonとcodex/config.tomlには、hook・権限・モデルなどの設定が入っています。

  • 初めて使う場合は、それぞれ~/.claude/settings.jsonと~/.codex/config.tomlへコピーします。
  • 既存の設定がある場合は、内容を比較して必要な設定を取り込みます。通知、テーマ、プラグイン、MCPサーバー、信頼するプロジェクトなどの設定は、自分の環境に合わせて残します。
  • codex/config.tomlのモデルが使えない環境では、modelとdefault_subagent_modelを利用できるモデルへ変更します。

rsyncは古いファイルを削除しません。以前の設定から更新する場合は、不要になったファイルが残っていないか確認してください。

hook

イベントhook内容
PreToolUse(Bash)block-dangerous-commands.shrm -rfなどの取り返しのつかないコマンドを止める
PreToolUse(Bash)block-main-commit.pymainへの直接コミットを止める
PreToolUse(Bash)allow-git-off-main.pymain以外のブランチでのgit操作を自動で許可する
PreToolUse(Bash)enforce-package-manager.pyロックファイルと違うパッケージマネージャーを止める(ロックファイルがなければbun・uv)
PreToolUse・PostToolUse(Bash)xlsx-guard.pyコマンドが書き換えた.xlsxを検証する
PreToolUse(Edit・Write)block-env-edit.sh.envの作成・編集を止める
Stopstop-check.shmake checkを実行し、落ちたら直させる(3回まで)
Stopevidence-check.sh振る舞いが変わる変更なのに証拠が古ければ止める(既定で見るのはSvelte・CSSなど。ほかの言語はリポジトリの.claude/evidence-pathsで対象を指定する)
Stopcheck-reply-links.py返信中のファイルリンクが開けるか確かめる
Stopcheck-reply-language.py返信が英語なら日本語で書き直させる

Codexではpre_tool_use_guard.pyが、特権コマンド(sudoなど)、環境変数の出力(env、printenv)、source .env、./.env・./secrets/・~/.ssh/などのパスを含むコマンドを止めます。コマンドの文字列で判定するだけなので、cat .envのような書き方は止まりません。

スキル

claude/skills/とcodex/skills/には同じスキルセットを入れています。

段階スキル内容
進め方playbook不具合の修正・機能の追加・リファクタリング・性能の改善・調査の手順書
調査imozuru関連する用語・人・場を芋づる式にたどり、原文を集める
調査research技術選定や仕様比較を根拠付きで.tmp/research/にまとめる
調査how既存のコードが今どう動いているかを説明する
調査why既存のコードや設計がなぜ今の形なのかを、記録から調べる
設計spec受け入れ条件と確かめ方を決めた契約・仕様書を作る
設計spike-rebuild試作して測り、仕様を作ってから作り直す
実装codexCodex CLIに、モデル・effortを指定して作業を頼む
レビューcode-reviewerPR・差分を、再現条件と根拠のある不具合に絞ってレビューする
保守運用harness-initリポジトリにmake check・CI・AGENTS.mdを整える
保守運用create-verification-skillアプリを利用者と同じ操作で確かめる、プロジェクト専用の検証スキルを作る
保守運用maintain-verification-skill検証スキルと機能一覧を、アプリの現状に合わせて点検する
保守運用correct繰り返す間違いを、効く一番上の層(設計・型・lint・テスト・文書)で防ぐ
文書sanitize-artifacts生成文書から会話・指示の混入を取り除く
文書yomiyasuAIが生成した日本語を推敲する

更新

設定やスキルを更新したら、マニフェストを再生成します。

find . -type f \
  -not -path './.git/*' \
  -not -path './.tmp/*' \
  -not -name '.DS_Store' \
  | sort > MANIFEST.txt

claude/skills/とcodex/skills/は同じスキルセットになるように更新してください。

ライセンス

このリポジトリはMITライセンスです。Copyright (c) 2025 nokonoko1203。

一部のスキルは第三者のMITライセンスのコードを含みます。帰属表示とライセンス条件は、各スキル内のNOTICE.md(NOTICE-pstack.mdを含む)やLICENSEを参照してください。Unicode由来のデータについては、同梱のUNICODE-LICENSE.txtも参照してください。

// faq

What is agent-settings?

Best Practices for Claude Code Configuration. It is open-source on GitHub.

Is agent-settings free to use?

agent-settings is open-source under the MIT license, so it is free to use.

What category does agent-settings belong to?

agent-settings is listed under skills in the Claudeers registry of Claude-compatible tools.

9 views
★ 92 stars
unclaimed
updated 27 days ago

// embed badge

agent-settings on Claudeers
[![Claudeers](https://claudeers.com/api/badge/agent-settings.svg)](https://claudeers.com/agent-settings)

// retro hit counter

agent-settings hit counter
[![Hits](https://claudeers.com/api/counter/agent-settings.svg)](https://claudeers.com/agent-settings)

// reviews

// guestbook

0/500

// related in Claude Skills

🔓

An agentic skills framework & software development methodology that works.

// skillsobra/⟨Shell⟩★ 314,126◷ MIT[ claude ]
🔓

Public repository for Agent Skills

// skillsanthropics/⟨Python⟩★ 188,182[ claude ]
🔓

AI coding assistant skill (Claude Code, Codex, OpenCode, Cursor, Gemini CLI, and more). Turn any folder of code, SQL schemas, R scripts, shell scripts, docs,…

// skillsGraphify-Labs/⟨Python⟩★ 149,064◷ MIT[ claude ]
🔓

💫 Toolkit to help you get started with Spec-Driven Development

// skillsgithub/⟨Python⟩★ 148,200◷ MIT[ claude ]
→ see how agent-settings connects across the ecosystem