Skills, SKILL.md, dan CLAUDE.md

Kenapa Bagian Ini Penting

Kalau Projects membuat Claude lebih paham konteks, maka Skills dan CLAUDE.md membuat Claude lebih konsisten dalam cara bekerja.

Ringkasnya:

Komponen	Fungsi
Projects	Menyimpan konteks kerja, file, dan instruksi workspace
Skills	Menyimpan prosedur task-specific yang bisa dipanggil saat relevan
CLAUDE.md	Menyimpan aturan proyek untuk Claude Code
MCP / Connectors	Memberi akses ke tools dan data eksternal

Apa Itu Skills

Skills adalah folder berisi instruksi, template, script, dan resource yang membantu Claude menjalankan tugas tertentu dengan pola yang lebih disiplin.

Skills cocok untuk:

• review kontrak dengan standar kantor
• membuat memo dengan format baku
• membuat presentasi sesuai brand guideline
• analisis spreadsheet berulang
• workflow riset, drafting, QA, atau audit

Struktur Skill yang Praktis

my-skill/
|-- SKILL.md
|-- templates/
|   |-- memo_template.md
|   `-- checklist.md
|-- references/
|   `-- style_guide.md
`-- scripts/
    `-- helper.py

Komponen Wajib SKILL.md

1. Nama skill.
2. Deskripsi kapan skill dipakai.
3. Tujuan.
4. Input yang diharapkan.
5. Langkah kerja.
6. Format output.
7. Do / Don't.
8. Escalation rules.
9. Contoh.
10. File referensi jika ada.

Template SKILL.md

---
name: workflow-review-id
description: |
  Gunakan skill ini saat user meminta review, audit, atau penyusunan ulang
  dokumen/workflow profesional dengan struktur standar.
allowed-tools:
  - Read
  - Write
  - Edit
  - Grep
  - Glob
---

# Workflow Review

## Tujuan
Membantu review output secara sistematis, tajam, dan usable.

## Kapan skill ini dipakai
- review dokumen
- audit output
- perbaikan struktur
- ringkasan risiko
- rekomendasi revisi

## Input yang diharapkan
- dokumen atau kutipan yang direview
- konteks penggunaan
- audiens akhir
- fokus review

## Langkah kerja
1. Identifikasi jenis dokumen dan tujuan.
2. Petakan risiko utama.
3. Tandai bagian yang kabur, lemah, atau tidak lengkap.
4. Susun temuan prioritas.
5. Beri rekomendasi revisi.

## Aturan output
- Ringkas tapi tajam.
- Bedakan fakta, asumsi, dan rekomendasi.
- Tandai hal yang perlu verifikasi manusia.

## Escalation rules
Hentikan dan minta verifikasi manusia jika:
- data belum lengkap
- domain high-stakes
- ada konsekuensi hukum, finansial, atau operasional besar

Apa Itu CLAUDE.md

CLAUDE.md adalah file instruksi kerja di root repo/proyek. Isinya menjelaskan konteks proyek, aturan coding, command, struktur folder, dan hal yang tidak boleh dilakukan sembarangan.

Template CLAUDE.md

# Project Overview
Nama proyek: [nama proyek]
Status: [aktif / maintenance / prototype]
Tujuan: [1-3 kalimat]

## Current Priorities
- [prioritas 1]
- [prioritas 2]
- [prioritas 3]

## Tech Stack
- Frontend: [...]
- Backend: [...]
- Database: [...]
- Infra / hosting: [...]

## Repository Map
- `/src` = kode utama
- `/components` = komponen UI
- `/docs` = dokumentasi
- `/scripts` = utilitas

## Critical Rules
- Jangan commit secrets atau API keys.
- Jangan ubah schema database tanpa approval eksplisit.
- Untuk perubahan besar, tampilkan rencana dulu.
- Untuk bugfix, jelaskan root cause sebelum memperbaiki.
- Jangan menghapus file kecuali jelas aman dan relevan.

## Commands
- Dev: `npm run dev`
- Test: `npm run test`
- Build: `npm run build`
- Lint: `npm run lint`

## Review Checklist
- Apakah ada risiko breaking change?
- Apakah test/lint lolos?
- Apakah ada debug code tertinggal?
- Apakah dokumentasi perlu diperbarui?

Strategi Kombinasi

Kombinasi	Cocok Untuk
Projects + Skills	Admin, legal, research, content, SOP
Claude Code + CLAUDE.md	Developer, automation builder, dashboard engineer
Claude Code + CLAUDE.md + Skills	Audit code, bug triage, release checklist, docs generation
Projects + Skills + MCP	Workflow enterprise dan agentic work lintas tools

Best Practice

• Jangan buat skill terlalu umum.
• Jangan isi CLAUDE.md dengan esai panjang.
• Pisahkan aturan proyek dari prosedur tugas.
• Revisi skill berdasarkan task nyata.
• Untuk domain high-stakes, tambahkan escalation rules.