- Open-source yang dikemas oleh Director AI Google Cloud, Addy Osmani, menjadi skill terstruktur setara workflow engineer senior untuk mengatasi masalah agen coding AI yang melewati spesifikasi, pengujian, dan review keamanan
- Terdiri dari 7 slash command dan 19 skill yang mencakup seluruh siklus hidup pengembangan (definisi→perencanaan→build→verifikasi→review→deploy)
/spec mendefinisikan apa yang akan dibuat: "spesifikasi sebelum kode"/plan merencanakan cara implementasi: "pecah menjadi tugas atomik kecil"/build implementasi bertahap: "hanya satu slice dalam satu waktu"/test membuktikan bahwa fitur bekerja: "tes adalah bukti"/review quality gate sebelum merge: "meningkatkan kesehatan kode"/code-simplify menyederhanakan kode: "kejelasan lebih penting daripada kecerdikan"/ship deploy ke production: "semakin cepat, semakin aman"
- Skill yang tepat akan aktif otomatis sesuai konteks. Contoh:
api-and-interface-design saat mendesain API, frontend-ui-engineering saat membuat UI
- Prinsip inti budaya engineering Google (Hyrum's Law, Beyonce Rule, Chesterton's Fence, Shift Left, dll.) ditanamkan langsung ke workflow di tiap tahap
Daftar lengkap 19 skill
-
Define (memperjelas apa yang akan dibuat)
- idea-refine: menstrukturkan pemikiran divergen/konvergen untuk mengubah ide yang samar menjadi proposal konkret
- spec-driven-development: menulis PRD sebelum coding yang mencakup tujuan, perintah, struktur, gaya kode, pengujian, dan batasan
-
Plan (dekomposisi)
- planning-and-task-breakdown: memecah spesifikasi menjadi tugas kecil yang dapat diverifikasi dengan kriteria penerimaan dan urutan dependensi
-
Build (menulis kode)
- incremental-implementation: implementasi, pengujian, verifikasi, dan commit dengan pendekatan vertical slice tipis, mendukung feature flag dan perubahan yang ramah rollback
- test-driven-development: menerapkan Red-Green-Refactor, piramida tes (80/15/5), DAMP over DRY, dan Beyonce Rule
- context-engineering: memberikan informasi yang tepat kepada agen pada waktu yang tepat (file rules, context packing, integrasi MCP)
- frontend-ui-engineering: arsitektur komponen, design system, manajemen state, responsive design, aksesibilitas WCAG 2.1 AA
- api-and-interface-design: desain contract-first, Hyrum's Law, One-Version Rule, semantik error, validasi batas
-
Verify (membuktikan bahwa fitur bekerja)
- browser-testing-with-devtools: data runtime real-time lewat Chrome DevTools MCP (inspeksi DOM, log konsol, trace jaringan, profiling performa)
- debugging-and-error-recovery: triase 5 tahap (reproduksi→lokalisasi→reduksi→perbaikan→pertahanan), aturan stop-the-line
-
Review (quality gate sebelum merge)
- code-review-and-quality: review 5 sumbu, ukuran perubahan (~100 baris), label tingkat keparahan (Nit/Optional/FYI), standar kecepatan review
- code-simplification: Chesterton's Fence, Rule of 500, mengurangi kompleksitas sambil mempertahankan perilaku yang tepat
- security-and-hardening: pencegahan OWASP Top 10, pola autentikasi, pengelolaan secret, audit dependensi, sistem batas 3 lapis
- performance-optimization: pendekatan measure-first, target Core Web Vitals, workflow profiling, analisis bundle
-
Ship (deploy)
- git-workflow-and-versioning: trunk-based development, commit atomik, ukuran perubahan (~100 baris), pola commit-as-savepoint
- ci-cd-and-automation: Shift Left, Faster is Safer, feature flag, pipeline quality gate
- deprecation-and-migration: mindset code-as-debt, metode deprecation wajib/rekomendatif, menghapus zombie code
- documentation-and-adrs: Architecture Decision Records, dokumentasi API, standar dokumentasi inline (mendokumentasikan 'mengapa')
- shipping-and-launch: checklist pra-rilis, lifecycle feature flag, rollout bertahap, prosedur rollback, pengaturan monitoring
Persona agen
- Tiga persona ahli sudah dikonfigurasi lebih dulu untuk review yang ditargetkan
- code-reviewer: perspektif senior staff engineer, review kode 5 sumbu dengan standar "apakah ini layak disetujui oleh staff engineer?"
- test-engineer: perspektif spesialis QA, strategi pengujian, analisis cakupan, pola Prove-It
- security-auditor: perspektif security engineer, deteksi kerentanan, threat modeling, evaluasi OWASP
Checklist referensi
- Empat materi referensi cepat yang dirujuk skill saat diperlukan
- testing-patterns.md: struktur tes, penamaan, mocking, contoh React/API/E2E, antipola
- security-checklist.md: pengecekan sebelum commit, autentikasi, validasi input, header, CORS, OWASP Top 10
- performance-checklist.md: target Core Web Vitals, checklist frontend/backend, perintah pengukuran
- accessibility-checklist.md: navigasi keyboard, screen reader, desain visual, ARIA, alat pengujian
Prinsip desain skill
- Proses, bukan prosa: skill adalah workflow yang diikuti agen, mencakup langkah, checkpoint, dan kriteria selesai, bukan dokumen referensi
- Mencegah rasionalisasi: setiap skill dibekali alasan umum yang sering dipakai agen untuk melewati langkah ("nanti saya tambahkan tes") beserta logika bantahannya
- Verifikasi tidak bisa dinegosiasikan: semua skill diakhiri dengan syarat bukti (tes lulus, output build, data runtime), dan "sepertinya berhasil" tidak cukup
- Pengungkapan bertahap:
SKILL.md adalah titik masuk, sementara referensi pendukung hanya dimuat saat perlu untuk meminimalkan penggunaan token
Cara instalasi (alat yang didukung)
- Claude Code (disarankan):
/plugin marketplace add addyosmani/agent-skills lalu /plugin install agent-skills@addy-agent-skills
- Pengembangan lokal: setelah
git clone, jalankan claude --plugin-dir /path/to/agent-skills
- Cursor: salin
SKILL.md mana pun ke .cursor/rules/ atau rujuk seluruh direktori skills/
- Gemini CLI:
gemini skills install https://github.com/addyosmani/agent-skills.git
- Windsurf: tambahkan isi skill ke pengaturan rules Windsurf
- GitHub Copilot: gunakan definisi agen di
agents/ sebagai persona Copilot, dan isi skill di .github/copilot-instructions.md
- Codex dan agen lainnya: karena skill berupa Markdown biasa, ia kompatibel dengan semua agen yang mendukung system prompt atau file instruksi
Belum ada komentar.