skills
CLAUDE.md1 starsChanged 4 months agoApache-2.0View on GitHub
~/.claude/skills を git 管理したもの。Claude Code のパーソナル Agent Skills 集で、public リポジトリとして公開する前提。各スキルは <name>/SKILL.md を核に、必要に応じて references/・scripts/・assets/ を持つ。SKILL.md の frontmatter(name / description)が起動トリガーで、description は「いつ使うか」を具体的に列挙する設計。 このリポジトリの中心的な制約は 会社固有情報を絶対にコミットしないこと。スキルの機能改善よりこの制約が優先される。 コミット前・公開前に必ず守る: .gitignore: - *手順そのものが社内業務であるスキル*は丸ごと除外している(ディレクトリ単位)。汎用化して公開はしない。 - 各スキルの */evals/(eval fixture に実データ)、*/docs/plans/(開発メモ)、*-workspace/(eval ハーネスの作業ディレクトリ・巨大)。 - __pycache__/・*.pyc・.DS_Store・/.secret-patterns。 .git/info/exclude(ローカルのみ・リポジトリと一緒には複製されない): - 除外したいパス*自体に固有名詞が含まれる*場合(特定プロジェクト専用の reference ファイル等)は、公開される .gitignore ではなくこちらに書く。除外指定に固有名詞を残さないため。
In this repository9 other files it gives its agents.
- ai-updatesSkill
- brew-upgradeSkill
- claude-code-updatesSkill
- draft-prSkill
- go-updatesSkill
- read-google-sheetSkill
- summarize-blogSkill
- summarize-go-issueSkill
- watch-ciSkill
The file
Files
CLAUDE.md
This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
What this repository is
~/.claude/skills を git 管理したもの。Claude Code のパーソナル Agent Skills 集で、public リポジトリとして公開する前提。各スキルは <name>/SKILL.md を核に、必要に応じて references/・scripts/・assets/ を持つ。SKILL.md の frontmatter(name / description)が起動トリガーで、description は「いつ使うか」を具体的に列挙する設計。
このリポジトリの中心的な制約は 会社固有情報を絶対にコミットしないこと。スキルの機能改善よりこの制約が優先される。
社内情報を漏らさない仕組み(最重要)
コミット前・公開前に必ず守る:
- コミットは pre-commit フックで検査される。
git config core.hooksPath .githooksが有効なら、scripts/check-secrets.sh --stagedが禁止パターンを含む変更のコミットを止める(緊急時のみgit commit --no-verify)。 - 全ファイルのフルスキャン:
bash scripts/check-secrets.sh(追跡済み + 未追跡を gitignore 尊重で検査。ヒットで exit 1)。スクリプトはリポジトリのどこから呼んでも動く(cwd 非依存)。 - 禁止パターンは
.secret-patterns(gitignore・非公開)に外出ししてある。リストそのものが隠したい固有名詞なのでコミットしない。見本の.secret-patterns.exampleだけ公開している。 - 例示に出す識別子はすべて汎用プレースホルダ(
OWNER/REPO・PROJ-123・<workspace>・@reviewer-a)にする。実在の会社名・リポジトリ名・Slack/Notion/Linear の ID・同僚のハンドルや実名は書かない。
追跡から外しているもの
.gitignore:
- 手順そのものが社内業務であるスキルは丸ごと除外している(ディレクトリ単位)。汎用化して公開はしない。
- 各スキルの
*/evals/(eval fixture に実データ)、*/docs/plans/(開発メモ)、*-workspace/(eval ハーネスの作業ディレクトリ・巨大)。 __pycache__/・*.pyc・.DS_Store・/.secret-patterns。
.git/info/exclude(ローカルのみ・リポジトリと一緒には複製されない):
- 除外したいパス自体に固有名詞が含まれる場合(特定プロジェクト専用の reference ファイル等)は、公開される
.gitignoreではなくこちらに書く。除外指定に固有名詞を残さないため。
スキルの構造とメタスキル
<name>/SKILL.md— frontmatter がトリガー。本文からreferences/*.md(コマンド一覧・プラットフォーム別の注意など詳細)を参照する。scripts/— スキルが呼ぶ補助スクリプト。assets/— HTML テンプレート等。- メタスキル:
skill-evolve(セッションのフリクションを分析し改訂案と eval を提案)とskill-fix(蒸留済みフリクションログを現行SKILL.mdに反映)は、スキル自体を保守する。 - eval ハーネス(
*-workspace/・*/evals/)は gitignore なので公開リポには入らない。スキルの検証は各自のローカルで行う。
セットアップ
git clone git@github.com:k3forx/skills.git ~/.claude/skills
cd ~/.claude/skills
git config core.hooksPath .githooks # コミット前の社内情報チェックを有効化
cp .secret-patterns.example .secret-patterns # 自分の非公開パターンに書き換えるDoes it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

