# Kf Pj Skill Agent Handling Rules

> Use this project skill whenever modifying, syncing, or deciding where to edit AI agent skills for this repository. Always use it when a skill change is requested.

- Skill: `melumuccu/kf-pj-skill-agent-handling-rules` (Agent Skill, multi-file: 4 files)
- Install (CLI): `npx skillmds@latest add melumuccu/kf-pj-skill-agent-handling-rules`
- Raw SKILL.md: https://api.skillmd.com/api/skills/melumuccu/kf-pj-skill-agent-handling-rules/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: melumuccu (https://skillmd.com/u/melumuccu)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/melumuccu/kf-pj-skill-agent-handling-rules

---


# skill 編集・同期の取り扱い

このリポジトリの skill を編集・同期・比較するときは、リポジトリ側を正とし、ホームディレクトリ直下の skill は読み取り専用として扱う。
skill は `kf-global` / `kf-global-commands` / `external` / `kf-local` の4バケットに分類する。

## 参照ファイル

- [references/overview.md](references/overview.md): 着手時: 基本原則・適用範囲・完了判定を確認するとき
- [references/repository-layout.md](references/repository-layout.md): 着手時: インストール前提・4バケット・必須 meta を確認するとき
- [references/edit-in-repository.md](references/edit-in-repository.md): 着手時: skill 修正依頼の編集先を決めるとき

## 読み進め方

1. [references/overview.md](references/overview.md) を読み、基本原則と適用範囲を確認する
1. [references/repository-layout.md](references/repository-layout.md) を読み、対象 skill のバケットと必須 meta を確認する
1. skill 修正依頼の場合は [references/edit-in-repository.md](references/edit-in-repository.md) を読み、編集先・禁止事項を確定する
1. 下記「最終チェック」で完了判定する

## 最終チェック

1. skill 修正は `.agents/skills/` 配下（このリポジトリ）だけで行っている
1. 対象 skill のバケットを特定し、必須 meta を満たしている
1. `~/.agent/skills` および `~/.agents/skills` 配下の skill 本体を変更していない
1. main マージ後の同期は vercel-labs/skills 経由であることを前提に説明している
1. リポジトリとホーム間の差分を異常と扱っていない