Skill diff-skill
Membandingkan dua versi instruksi skill untuk mendeteksi degradasi instruksi dan regresi kompleksitas.
- Bintang GitHub
- 155
- File
- 14
- Commit terakhir
- 10 Nov 2026
- Lisensi
- —
- Tool yang diizinkan
- —
Apa fungsi skill diff-skill?
diff-skill adalah agent skill. Membandingkan dua versi instruksi skill untuk mendeteksi degradasi instruksi dan regresi kompleksitas.
Ringkasan dibuat dari SKILL.md skill ini.
Tentang skill diff-skill
Developer yang sedang meninjau perubahan pada instruksi skill dapat menggunakan tool ini untuk mengidentifikasi degradasi instruksi atau regresi kompleksitas. Tool ini berfungsi sebagai pengecekan asimetris, yang berarti ia akan mengabaikan penambahan atau klarifikasi yang bermanfaat dan hanya berfokus pada perubahan negatif seperti constraint yang hilang, langkah verifikasi yang melemah, atau referensi yang rusak. Agent harus memuat skill ini saat pengguna meminta untuk melakukan diff, membandingkan, atau meninjau perubahan pada instruksi markdown sebuah skill.
Secara default, tool ini membandingkan versi HEAD dengan working tree, dengan menelusuri seluruh set file yang dapat dijangkau melalui link markdown mulai dari file SKILL.md. Tool ini menghasilkan file laporan detail yang terletak di docs/reviews/diff-skill/ dan memberikan ringkasan inline yang berisi verdict serta jumlah temuan. Jika tool mendeteksi adanya degradasi atau regresi kompleksitas, ia akan mengindeks temuan tersebut di bawah kk:review-findings. Tool ini mengandalkan file diff-process.md untuk memandu fase eksekusi sekuensialnya.
Apa yang bisa dilakukan agent dengannya
- 1Deteksi degradasi instruksiMemeriksa apakah pengeditan pada instruksi markdown sebuah skill secara tidak sengaja menghapus instruksi utama atau melemahkan sebuah constraint.
- 2Identifikasi regresi kompleksitasMenentukan apakah perubahan terbaru membuat sebuah skill menjadi lebih sulit diikuti oleh large language model.
- 3Generate laporan review otomatisMembuat laporan markdown yang mendokumentasikan perbedaan antara dua versi dokumentasi sebuah skill.
- 4Audit perubahan instruksi skillMeninjau perbedaan antara HEAD saat ini dengan working tree untuk skill tertentu.
Ditulis dari SKILL.md milik skill tersebut. Setiap use case diverifikasi dengan kutipan darinya.
Cara install skill diff-skill
Setiap perintah menyalin folder skill ke direktori skills client. Restart client atau mulai sesi baru untuk memuatnya.Install skill diff-skill di Plugin
/plugin marketplace add serpro69/claude-toolbox /plugin install kk@claude-toolbox
Install skill diff-skill di Claude Code
~/.claude/skills/diff-skill/SKILL.md
$ npx degit serpro69/claude-toolbox/klaude-plugin/skills/diff-skill ~/.claude/skills/diff-skillInstall skill diff-skill di Claude Code (project)
.claude/skills/diff-skill/SKILL.md
$ npx degit serpro69/claude-toolbox/klaude-plugin/skills/diff-skill .claude/skills/diff-skillInstall skill diff-skill di Codex
~/.agents/skills/diff-skill/SKILL.md
$ npx degit serpro69/claude-toolbox/klaude-plugin/skills/diff-skill ~/.agents/skills/diff-skillInstall skill diff-skill di Gemini CLI
~/.gemini/skills/diff-skill/SKILL.md
$ npx degit serpro69/claude-toolbox/klaude-plugin/skills/diff-skill ~/.gemini/skills/diff-skillInstall skill diff-skill di Claude.ai
npx degit serpro69/claude-toolbox/klaude-plugin/skills/diff-skill diff-skill && zip -r diff-skill.zip diff-skill # claude.ai → Customize → Skills → + → Create skill → Upload a skill → diff-skill.zip
SKILL.md
Lihat di GitHubDiff Skill Instructions
Goal: Detect whether an edit to a skill's markdown instructions introduced degradations or made the skill harder for an LLM to follow.
Two judgment axes:
- Degradation (asymmetric) — load-bearing instruction dropped, constraint weakened, verification step removed, scope narrowed, required output dropped, or reference broken. Content relocated but preserved is neutral.
- Complexity — split into regressions (introduced or worsened by the edit, affects verdict) and pre-existing advisories (exist regardless of the edit, surfaced as improvement opportunities, does NOT affect verdict).
Conventions
- Read capy knowledge base conventions at shared-capy-knowledge-protocol.md.
Required Outputs
- Report written to
docs/reviews/diff-skill/<slug>-<sha-a>-<sha-b>.md - Inline summary presented (under 10 lines: verdict, finding counts, report path)
- Capy indexed under
kk:review-findingsif any degradation or complexity regression findings exist (skip on clean results and pre-existing advisories)
Invocation
/kk:diff-skill <skill-name>
Convenience shortcut: resolves klaude-plugin/skills/<skill-name>/SKILL.md. If not found, asks the user for the skill directory path.
Defaults: HEAD (before) → working tree (after). User can specify different refs in the prompt.
Workflow
Mandatory order — load instructions before acting on subject matter. The phases below are strictly sequential. Do not read skill content, build file sets, or produce judgments until you have loaded and internalized the full process file. The only early contact with the target skill is its name and SKILL.md path — enough to validate, not enough to judge.
See diff-process.md for the detailed step-by-step process.
Berkas dalam skill ini
14Pertanyaan seputar skill diff-skill
Bagaimana cara install skill diff-skill di Claude Code?
Jalankan npx degit serpro69/claude-toolbox/klaude-plugin/skills/diff-skill ~/.claude/skills/diff-skill. Claude Code memuat skill dari ~/.claude/skills (semua proyek) atau .claude/skills (satu proyek) dan menggunakan skill saat deskripsinya cocok dengan tugas.
Client mana saja yang bisa menggunakan skill diff-skill?
Client apa pun yang membaca format Agent Skills: Claude Code, Codex, Gemini CLI, dan claude.ai (unggah sebagai ZIP). Script dalam skill hanya berjalan di client yang mengizinkan eksekusi kode.
Apa yang dianggap sebagai degradasi oleh skill ini?
Degradasi didefinisikan sebagai instruksi utama yang hilang, constraint yang melemah, langkah verifikasi yang dihapus, cakupan yang menyempit, output wajib yang hilang, atau referensi yang rusak.
Bagaimana penambahan dan klarifikasi diperlakukan selama perbandingan?
Penambahan, klarifikasi, dan penguatan instruksi tidak dianggap sebagai degradasi.
Di mana laporan perbandingan disimpan?
Laporan ditulis ke direktori docs/reviews/diff-skill/.