agentleFS
k3forxk3forx/skills/CLAUDE.md

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 ではなくこちらに書く。除外指定に固有名詞を残さないため。

The file

Files
CLAUDE.md

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  # 自分の非公開パターンに書き換える

Download now (ZIP)

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
What did you use it for? e.g. Reviewing pull requests in a Rails app

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.