agent-skills - Kumpulan skill engineering tingkat produksi untuk agen coding AI

• 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

[xguru]

Belakangan ini sepertinya sedang tren untuk membagikan skill set buatan sendiri.

Bagaimanapun juga ini cuma file Markdown, jadi tidak perlu langsung mengadopsi semuanya apa adanya.
Semakin banyak isinya, semakin besar juga konsumsi tokennya.
Lebih baik bilang ke agen saya, "analisis ini lalu ambil hanya yang diperlukan."

Begitulah cara kita membangun harness kita sendiri.

[thestackai]

Betul. Saya rasa itu adalah cara terbaik untuk merespons derasnya open source yang terus bermunculan.

[yangeok]

Sepertinya mirip dengan speckit.

[blacksocks]

Saya mendapat arahan di internal perusahaan untuk mencoba mengembangkan hanya dengan vibe coding, jadi saya sempat menerapkan ini-itu. Namun setelah benar-benar dicoba, ternyata skill pengembangan yang hebat tidak serta-merta menjamin kualitas yang tinggi..
Justru kemampuan untuk meninjau dan memahami kode yang dihasilkan AI tampaknya menjadi kunci. Semakin baik alatnya, semakin penting pula “kemampuan membaca dan menilai” ini—sebuah ironi, bisa dibilang.

[ragingwind]

Pemimpin tim Google Chrome, Addy Osmani, pindah ke jabatan Director, Google Cloud AI.

[xguru]

Wah, kapan dipindahkannya ya. Saya terus mengira begitu. Sudah saya perbaiki.

[ragingwind]

Sekarang, orang yang saya kenal di tim Chrome tinggal Paul Kinlan (lead DevRel Chrome). Waktu benar-benar berlalu.