Perluas Claude dengan skills

​

Skill bawaan

​

Memeriksa penyiapan Anda dengan /doctor

• Kesehatan instalasi: instalasi duplikat atau sisa, masalah PATH, file pengaturan yang tidak dapat di-parse, dan apakah versi yang lebih baru tersedia di saluran rilis Anda
• Ekstensi: skill, server MCP, dan plugin yang tidak digunakan dibandingkan dengan biaya konteksnya, serta hook yang lambat
• File CLAUDE.md: file CLAUDE.md lokal yang menduplikasi file yang di-check-in, konten CLAUDE.md yang di-check-in yang dapat disimpulkan Claude dari codebase, dan panduan yang selalu dimuat yang tersisa, yang ditawarkan Claude untuk dimigrasikan ke skill dan file CLAUDE.md bertingkat yang dimuat sesuai kebutuhan
• Izin: tawaran untuk menjadikan auto mode sebagai mode izin default Anda dan untuk menyetujui terlebih dahulu perintah read-only yang sering Anda tolak

​

Menjalankan dan memverifikasi aplikasi Anda

​

Menjalankan pemeriksaan sebelum setiap commit

• Lokasi: skill dimuat dari lokasi enterprise, pribadi, proyek, atau direktori tambahan, atau dari file .claude/commands/ dengan nama tersebut. Resep yang direkam /verify di root repo Anda adalah skill proyek, jadi resep itu terhitung. /verify dan /simplify bawaan, skill plugin, dan skill dari akun claude.ai Anda tidak terhitung.
• Pemanggilan: Claude dapat memanggil skill tersebut. Jika Anda telah mencegah Claude memanggilnya, misalnya dengan disable-model-invocation: true, Claude tidak mendapatkan instruksi tersebut.
• Instruksi Git: Anda belum mematikan includeGitInstructions. Mematikannya akan menghapus instruksi ini bersama dengan instruksi commit dan PR bawaan lainnya.

​

Bekerja pada proyek Claude API

​

Memulai

​

Buat skill pertama Anda

mkdir -p ~/.claude/skills/summarize-changes

---
description: Summarizes uncommitted changes and flags anything risky. Use when the user asks what changed, wants a commit message, or asks to review their diff.
---

## Current changes

!`git diff HEAD`

## Instructions

Summarize the changes above in two or three bullet points, then list any risks you notice such as missing error handling, hardcoded values, or tests that need updating. If the diff is empty, say there are no uncommitted changes.

What did I change?

/summarize-changes

​

Pilih tempat skill dimuat

• Folder symlink: entri <skill-name> di lokasi enterprise, personal, atau proyek dapat berupa symlink ke direktori di tempat lain pada disk. Claude Code membaca SKILL.md dari targetnya dan memuat skill tersebut sekali meskipun beberapa lokasi mengarah ke target yang sama. Skill plugin menangani symlink secara berbeda.
• Nama yang dicadangkan synced: jangan menamai folder skill synced, dalam kapitalisasi apa pun. Claude Code menggunakan ~/.claude/skills/synced/ untuk skill yang diunduh dari claude.ai dan melewati skill yang Anda buat dengan nama tersebut di lokasi enterprise, personal, dan proyek.
• Nama yang dicadangkan anthropic-skills: di luar plugin, folder skill atau file perintah yang bernama anthropic-skills atau diawali dengan anthropic-skills: tidak dimuat. Lihat Nama yang dicadangkan untuk skill yang disinkronkan.
• Karakter dalam nama: di luar plugin, folder skill tidak dimuat jika namanya mengandung karakter seperti zero-width space atau <. Lihat Karakter yang tidak boleh ada dalam nama skill.
• File perintah: file Markdown di .claude/commands/ adalah format lama dan masih berfungsi. File ini mendukung frontmatter yang sama kecuali name dan paths. Untuk mengetahui nama yang Anda ketik untuk memanggilnya, lihat Bagaimana skill mendapatkan nama perintahnya. Utamakan skill untuk pekerjaan baru, karena skill juga mendukung file pendukung.
• Folder skill sebagai plugin: tambahkan .claude-plugin/plugin.json ke folder skill dan folder tersebut dimuat sebagai plugin bernama <name>@skills-dir, sehingga dapat menyertakan agent, hook, dan server MCP. Di .claude/skills/ milik proyek, ini mengharuskan Anda menerima dialog kepercayaan workspace terlebih dahulu.

​

Memuat skill di monorepo dan subdirektori

• /deploy menjalankan skill root. Claude Code juga mencantumkan varian yang dikualifikasi direktori untuk Claude, dengan instruksi untuk memanggil varian yang direktorinya berisi file yang sedang dikerjakan, sehingga skill bersarang tetap berlaku untuk pekerjaan di apps/web/.
• /apps/web:deploy menjalankan skill bersarang secara tersendiri. Deskripsinya menyebutkan direktori tempat skill tersebut berlaku.

​

Memuat skill dari direktori di luar proyek

​

Menyelesaikan skill yang memiliki nama yang sama

​

Menggunakan skill di Cowork dan sesi cloud

• Untuk Cowork dan sesi cloud, aktifkan skill tersebut untuk akun claude.ai Anda. Beberapa sesi di lingkungan self-hosted tidak memuat skill akun Anda.
• Untuk sesi cloud, Anda dapat melakukan commit skill ke .claude/skills/ milik repositori sebagai gantinya. Plugin yang dideklarasikan di .claude/settings.json milik repositori dan plugin yang hanya diaktifkan di pengaturan pengguna Anda tidak dimuat di sesi cloud.

​

Skill yang disinkronkan dari claude.ai

​

Tempat skill yang disinkronkan dimuat

• Saat Anda atau Claude bekerja dalam sesi: pemeriksaan berjalan sekitar setiap 10 menit.
• Saat sesi idle: pemeriksaan berjalan sekitar setiap 40 menit. Saat Anda mengetik lagi di sesi, Claude Code melakukan pemeriksaan dalam beberapa menit jika pemeriksaan terakhir dilakukan lebih dari 10 menit yang lalu.

• Sesi yang tidak menggunakan login yang disimpan oleh /login, seperti sesi yang melakukan autentikasi dengan kunci API, atau sesi tempat ANTHROPIC_AUTH_TOKEN, CLAUDE_CODE_OAUTH_TOKEN, atau skrip apiKeyHelper menyediakan kredensial
• Sesi yang tidak mengambil feature flag, seperti sesi di Amazon Bedrock atau sesi tempat Anda mengatur CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC
• Sesi dalam bare mode atau sesi yang Anda mulai dengan --safe-mode
• Sesi tempat pengaturan terkelola organisasi Anda mengunci skill ke sumber plugin, atau sesi yang Anda mulai dengan daftar --setting-sources yang tidak menyertakan user

​

Ketika nama skill yang disinkronkan cocok dengan perintah lain

• Perintah bawaan atau skill bawaan, termasuk yang tidak tersedia di sesi Anda, misalnya setelah Anda mematikan skill bawaan
• Skill di tingkat lokal mana pun atau file di .claude/commands/
• Skill plugin
• Prompt MCP

​

Nama yang dicadangkan untuk skill yang disinkronkan

• Folder skill, name frontmatter, file atau subfolder di .claude/commands/, atau workflow yang disimpan: tidak dimuat. Pemberitahuan startup menyebutkan item pertama yang perlu diganti namanya atau diedit.
• Plugin bernama anthropic-skills: dimuat. Ketika salah satu skill-nya dan skill yang disinkronkan sama-sama bernama <name>, /anthropic-skills:<name> menjalankan skill yang disinkronkan.
• Server MCP bernama anthropic-skills: terhubung dan tool-nya berfungsi, tetapi prompt-nya tidak muncul sebagai perintah. Ganti nama server di konfigurasi MCP Anda untuk mencantumkannya.

​

Cara Claude Code menangani frontmatter skill yang disinkronkan

• Frontmatter berlaku di setiap jenis sesi, sehingga pemberian allowed-tools melalui alur izin normal. Jika organisasi Anda mengatur allowManagedPermissionRulesOnly, pemberian tersebut tidak berlaku.
• Claude Code membersihkan teks tampilan yang disediakan skill, seperti deskripsinya. Claude Code menghapus karakter kontrol, dan dalam teks yang mencapai Claude, seperti deskripsi, Claude Code juga meng-escape kurung sudut agar teks tidak dapat meniru format internal Claude Code. Pembersihan ini memerlukan Claude Code v2.1.228 atau yang lebih baru.

​

Cara Claude Code menangani isi skill yang disinkronkan

• Dalam sesi cloud, isi skill mempertahankan perilaku yang dimiliki skill lokal, karena sesi berjalan di container yang terisolasi.
• Dalam sesi Cowork di desktop Anda, isi skill mempertahankan perilaku yang dimiliki skill lokal, kecuali bahwa Claude Code mengganti setiap baris perintah ! dengan placeholder disableSkillShellExecution, seperti yang dilakukannya untuk setiap skill yang Anda sediakan di sana.
• Dalam sesi lain mana pun di mesin Anda, Claude Code tidak menjalankan perintah !, tidak melampirkan file yang disebutkan oleh referensi @ seperti yang dilakukannya untuk skill lokal, dan tidak mensubstitusi placeholder ${CLAUDE_PROJECT_DIR} dan ${CLAUDE_SESSION_ID}, sehingga referensi @ dan kedua placeholder tersebut mencapai Claude sebagai teks literal. Baris perintah ! juga mencapai Claude sebagai teks literal, atau sebagai placeholder tersebut ketika disableSkillShellExecution aktif. Penanganan ini memerlukan Claude Code v2.1.228 atau yang lebih baru.

​

Mengedit skill selama sesi

​

Menghapus skill

• Skill personal atau proyek: hapus direktori skill tersebut, ~/.claude/skills/<skill-name>/ atau .claude/skills/<skill-name>/. Claude Code menghapusnya dari /skills di sesi saat ini; konten yang sudah dimuat Claude Code darinya mengikuti siklus hidup konten skill.
• Skill enterprise: administrator menghapus direktori skill dari .claude/skills/ di dalam direktori pengaturan terkelola, misalnya /etc/claude-code/.claude/skills/<skill-name>/ di Linux.
• Skill plugin: nonaktifkan atau hapus instalasi plugin yang menyediakannya, dari menu /plugin atau dengan /plugin uninstall <plugin-name>@<marketplace-name>. Claude Code membongkar skill plugin tersebut saat perubahan berlaku atau saat Anda memulai ulang.
• Skill yang disinkronkan dari claude.ai: matikan skill tersebut untuk akun claude.ai Anda, di tempat yang sama dengan tempat Anda mengaktifkannya. Claude Code menghapusnya dari ~/.claude/skills/synced/ saat berikutnya menyinkronkan skill Anda. Jika Anda menghapus direktori secara manual, sinkronisasi berikutnya akan mengunduhnya lagi selama skill tersebut tetap diaktifkan di claude.ai.
• Skill bawaan: atur disableBundledSkills ke true untuk mematikan skill bawaan, atau atur satu skill ke "off" di skillOverrides untuk menyembunyikannya.

​

Mengonfigurasi skills

​

Jenis konten skill

---
name: api-conventions
description: API design patterns for this codebase
---

When writing API endpoints:
- Use RESTful naming conventions
- Return consistent error formats
- Include request validation

---
name: deploy
description: Deploy the application to production
context: fork
disable-model-invocation: true
---

Deploy the application:
1. Run the test suite
2. Build the application
3. Push to the deployment target

​

Referensi frontmatter

---
name: my-skill
description: What this skill does
disable-model-invocation: true
allowed-tools: Read Grep
---

Your skill instructions here...

​

Menggunakan frontmatter skill di luar Claude Code

Unexpected key(s) in SKILL.md frontmatter: argument-hint. Allowed properties are: allowed-tools, compatibility, description, license, metadata, name

​

Bagaimana skill mendapatkan nama perintahnya

​

Karakter yang tidak boleh ada dalam nama skill

• Spasi lebar-nol (zero-width space) atau karakter kontrol
• Karakter private-use atau karakter yang belum ditetapkan, seperti glyph dari font ikon
• Karakter yang mengubah arah teks di sekitarnya
• Karakter kosong selain satu spasi biasa di antara kata, seperti no-break space, dua spasi berturut-turut, atau spasi di awal atau akhir
• < atau >

• Folder di direktori skills/ plugin atau di path skills manifesnya: Anda tidak perlu mengganti nama folder. Karakter-karakter ini menjadi tanda hubung dalam nama perintah skill, jadi ketik perintah dengan tanda hubung tersebut.
• Frontmatter name: menu / tidak menampilkan nilai name dan mengetiknya tidak memanggil skill. Edit baris name: untuk menghapus karakter-karakter tersebut.

​

Substitusi string yang tersedia

---
name: render-chart
description: Render a chart from a CSV file
allowed-tools: Bash(${CLAUDE_SKILL_DIR}/scripts/render.sh *)
---

Run `${CLAUDE_SKILL_DIR}/scripts/render.sh <csv-file>` to render the chart.

---
name: session-logger
description: Log activity for this session
---

Log the following to logs/${CLAUDE_SESSION_ID}.log:

$ARGUMENTS

​

Menambahkan file pendukung

my-skill/
├── SKILL.md (required - overview and navigation)
├── reference.md (detailed API docs - loaded when needed)
├── examples.md (usage examples - loaded when needed)
└── scripts/
    └── helper.py (utility script - executed, not loaded)

## Additional resources

- For complete API details, see [reference.md](reference.md)
- For usage examples, see [examples.md](examples.md)

​

Mengontrol siapa yang memanggil skill

• disable-model-invocation: true: Claude tidak dapat memanggil skill atas inisiatifnya sendiri. Gunakan ini untuk alur kerja yang memiliki efek samping atau yang waktunya ingin Anda kontrol, seperti /commit, /deploy, atau /send-slack-message. Anda tidak ingin Claude memutuskan untuk men-deploy karena kode Anda terlihat siap.
• user-invocable: false: Hanya Claude yang dapat memanggil skill. Gunakan ini untuk pengetahuan latar belakang yang tidak dapat dijalankan sebagai perintah. Skill legacy-system-context menjelaskan cara kerja sistem lama. Claude perlu mengetahui hal ini ketika relevan, tetapi /legacy-system-context bukanlah tindakan yang bermakna bagi pengguna.

---
name: deploy
description: Deploy the application to production
disable-model-invocation: true
---

Deploy $ARGUMENTS to production:

1. Run the test suite
2. Build the application
3. Push to the deployment target
4. Verify the deployment succeeded

​

Tempat Anda menulis nama skill

​

Siklus hidup konten skill

​

Menyetujui tool terlebih dahulu untuk skill

---
name: commit
description: Stage and commit the current changes
disable-model-invocation: true
allowed-tools: Bash(git add *) Bash(git commit *) Bash(git status *)
---

​

Ketika hanya aturan izin terkelola yang berlaku

​

Meneruskan argumen ke skills

---
name: fix-issue
description: Fix a GitHub issue
disable-model-invocation: true
---

Fix GitHub issue $ARGUMENTS following our coding standards.

1. Read the issue description
2. Understand the requirements
3. Implement the fix
4. Write tests
5. Create a commit

---
name: migrate-component
description: Migrate a component from one language to another
---

Migrate the $ARGUMENTS[0] component from $ARGUMENTS[1] to $ARGUMENTS[2].
Preserve all existing behavior and tests.

---
name: migrate-component
description: Migrate a component from one language to another
---

Migrate the $0 component from $1 to $2.
Preserve all existing behavior and tests.

​

Pola lanjutan

​

Injeksi konteks dinamis

---
name: pr-summary
description: Summarize changes in a pull request
context: fork
agent: Explore
allowed-tools: Bash(gh *)
---

## Pull request context
- PR diff: !`gh pr diff`
- PR comments: !`gh pr view --comments`
- Changed files: !`gh pr diff --name-only`

## Your task
Summarize this pull request...

## Environment
```!
node --version
git status --short
```

​

Bagaimana perintah yang diinjeksi berjalan

• shell: powershell, dengan alat PowerShell diaktifkan: perintah berjalan melalui alat PowerShell.
• shell: bash ketika bash tidak tersedia: invokasi gagal sebelum perintah apa pun berjalan. Ini terjadi di Windows tanpa Git Bash. Claude Code menampilkan Skill <name> requires bash (`shell: bash` in frontmatter) but Git Bash was not found.
• Kombinasi lainnya: perintah berjalan melalui alat Bash ketika bash tersedia. Ketika tidak, mereka berjalan melalui alat PowerShell.

• Direktori kerja: Claude Code menjalankan setiap perintah di direktori kerja shell sesi saat ini. Direktori itu bergerak ketika Claude menjalankan cd. Gunakan ${CLAUDE_SKILL_DIR} atau ${CLAUDE_PROJECT_DIR} dalam path yang harus diselesaikan dengan cara yang sama setiap kali.
• stderr: dengan shell bash default, Claude Code menggabungkan stderr ke stdout. Apa pun yang ditulis perintah ke stderr muncul dalam teks yang diinjeksi.
• Timeout: setiap perintah berjalan di bawah timeout default 2 menit alat Bash. Ketika alat Bash memindahkan perintah yang kedaluwarsa ke latar belakang, skill masih dirender. Teks yang diinjeksi melaporkan perpindahan dan menamai tugas latar belakang dan file yang mengumpulkan output perintah. Ketika perintah adalah salah satu yang tidak pernah dilatarbelakangkan oleh alat Bash, Claude Code membunuhnya pada timeout. Kegagalan itu membatalkan invokasi.
• Ukuran output: output melampaui batas inline alat Bash tiba sebagai jalur file plus pratinjau singkat, bukan teks terpotong. Output limits mencakup batas dan cara menyesuaikan setiap batas.

​

Ketika perintah yang diinjeksi gagal

• Shell bash default: perintah yang tercantum di bawah Output limits
• shell: powershell, ketika alat PowerShell diaktifkan: set berbeda yang mencakup grep dan git diff tetapi bukan find atau diff

​

Karakter kontrol dalam perintah yang diinjeksi

​

Pemeriksaan izin pada perintah yang diinjeksi

​

Jalankan skills dalam subagent

• Dalam mode non-interaktif, dengan flag -p atau Agent SDK
• Ketika Anda menetapkan CLAUDE_CODE_DISABLE_BACKGROUND_TASKS ke 1, yang juga mematikan semua fitur tugas latar belakang lainnya
• Ketika Anda menginvokasi skill yang di-fork sementara invokasi sebelumnya dari skill yang sama masih berjalan
• Ketika tugas terjadwal diaktifkan dengan skill sebagai promptnya

​

Contoh: Skill penelitian menggunakan agen Explore

---
name: deep-research
description: Research a topic thoroughly
context: fork
agent: Explore
---

Research $ARGUMENTS thoroughly:

1. Find relevant files using Glob and Grep
2. Read and analyze the code
3. Summarize findings with specific file references

1. Konteks terisolasi baru dibuat
2. Subagent menerima konten skill sebagai promptnya (instruksi “Research $ARGUMENTS thoroughly”)
3. Field agent menentukan lingkungan eksekusi (model, alat, dan izin)
4. Subagent merangkum hasilnya dan mengembalikannya ke percakapan utama Anda ketika selesai

​

Batasi akses skill Claude

# Add to deny rules:
Skill

# Allow only specific skills
Skill(commit)
Skill(review-pr *)

# Deny specific skills
Skill(deploy *)

• Skill(anthropic-skills:pdf) menyetujui skill pdf yang disinkronkan
• Skill(anthropic-skills *) menyetujui setiap skill yang disinkronkan
• Skill(anthropic *) tidak mencakup anthropic-skills:pdf, karena awalan di luar namespace tidak cocok dengan nama di dalamnya

​

Ganti visibilitas skill dari pengaturan

{
  "skillOverrides": {
    "legacy-context": "name-only",
    "deploy": "off"
  }
}

​

Temukan skills yang tidak digunakan

​

Evaluasi dan iterasi pada sebuah skill

• Personal atau project skill: atur ke "off" dalam skillOverrides.
• Skill yang disediakan plugin: skillOverrides tidak berlaku untuk skill plugin. Gunakan claude plugin eval sebagai gantinya, yang mengulangi setiap run tanpa plugin yang dimuat.

​

Jalankan evals dengan skill-creator

/plugin install skill-creator@claude-plugins-official

• Marketplace "claude-plugins-official" not found: tambahkan marketplace dengan /plugin marketplace add anthropics/claude-plugins-official, kemudian coba ulang instalasi.
• Plugin tidak ditemukan di marketplace: periksa nama plugin.

• Test cases: menyimpan prompt, file input, dan perilaku yang diharapkan dalam evals/evals.json di dalam direktori skill
• Isolated runs: menjalankan subagent per test case sehingga setiap run dimulai dengan konteks bersih, dan mencatat jumlah token dan durasi
• Grading: memeriksa setiap assertion terhadap output dan menulis pass atau fail dengan bukti ke grading.json
• Benchmark: mengagregasi pass rate, waktu, dan token untuk with-skill versus without-skill ke dalam benchmark.json sehingga Anda dapat membandingkan peningkatan pass-rate terhadap overhead token dan waktu
• Version comparison: menjalankan blind A/B antara dua versi skill sehingga Anda dapat mengkonfirmasi edit adalah peningkatan sebelum melakukan commit
• Description tuning: menghasilkan prompt should-trigger dan should-not-trigger, mengukur hit rate, dan mengusulkan edit deskripsi saat skill diaktifkan pada permintaan yang salah
• Review viewer: membuka laporan HTML di mana Anda memeriksa setiap output dan mencatat umpan balik kualitatif yang dibaca iterasi berikutnya

​

Bagikan skills

• Project skills: Commit .claude/skills/ ke version control
• Plugins: Buat direktori skills/ di plugin Anda
• Managed: Terapkan di seluruh organisasi melalui managed settings

​

Hasilkan output visual

mkdir -p ~/.claude/skills/codebase-visualizer/scripts

---
name: codebase-visualizer
description: Generate an interactive collapsible tree visualization of your codebase. Use when exploring a new repo, understanding project structure, or identifying large files.
allowed-tools: Bash(python3 *)
---

# Codebase Visualizer

Hasilkan tampilan pohon HTML interaktif yang menunjukkan struktur file proyek Anda dengan direktori yang dapat diciutkan.

## Penggunaan

Jalankan skrip visualisasi dari root proyek Anda:

```bash
python3 ${CLAUDE_SKILL_DIR}/scripts/visualize.py .
```

Ini membuat `codebase-map.html` di direktori saat ini dan membukanya di browser default Anda.

## Apa yang ditampilkan visualisasi

- **Direktori yang dapat diciutkan**: Klik folder untuk memperluas/menciutkan
- **Ukuran file**: Ditampilkan di sebelah setiap file
- **Warna**: Warna berbeda untuk jenis file berbeda
- **Total direktori**: Menunjukkan ukuran agregat setiap folder

• Sidebar ringkasan yang menampilkan jumlah file, jumlah direktori, ukuran total, dan jumlah jenis file
• Bagan batang yang memecah codebase berdasarkan jenis file (8 teratas berdasarkan ukuran)
• Pohon yang dapat diciutkan di mana Anda dapat memperluas dan menciutkan direktori, dengan indikator jenis file berkode warna

#!/usr/bin/env python3
"""Generate an interactive collapsible tree visualization of a codebase."""

import json
import sys
import webbrowser
from html import escape
from pathlib import Path
from collections import Counter

IGNORE = {'.git', 'node_modules', '__pycache__', '.venv', 'venv', 'dist', 'build'}

def scan(path: Path, stats: dict) -> dict:
    result = {"name": path.name, "children": [], "size": 0}
    try:
        for item in sorted(path.iterdir()):
            if item.name in IGNORE or item.name.startswith('.'):
                continue
            if item.is_file():
                size = item.stat().st_size
                ext = item.suffix.lower() or '(no ext)'
                result["children"].append({"name": item.name, "size": size, "ext": ext})
                result["size"] += size
                stats["files"] += 1
                stats["extensions"][ext] += 1
                stats["ext_sizes"][ext] += size
            elif item.is_dir():
                stats["dirs"] += 1
                child = scan(item, stats)
                if child["children"]:
                    result["children"].append(child)
                    result["size"] += child["size"]
    except PermissionError:
        pass
    return result

def generate_html(data: dict, stats: dict, output: Path) -> None:
    ext_sizes = stats["ext_sizes"]
    total_size = sum(ext_sizes.values()) or 1
    sorted_exts = sorted(ext_sizes.items(), key=lambda x: -x[1])[:8]
    colors = {
        '.js': '#f7df1e', '.ts': '#3178c6', '.py': '#3776ab', '.go': '#00add8',
        '.rs': '#dea584', '.rb': '#cc342d', '.css': '#264de4', '.html': '#e34c26',
        '.json': '#6b7280', '.md': '#083fa1', '.yaml': '#cb171e', '.yml': '#cb171e',
        '.mdx': '#083fa1', '.tsx': '#3178c6', '.jsx': '#61dafb', '.sh': '#4eaa25',
    }
    lang_bars = "".join(
        f'<div class="bar-row"><span class="bar-label">{ext}</span>'
        f'<div class="bar" style="width:{(size/total_size)*100}%;background:{colors.get(ext,"#6b7280")}"></div>'
        f'<span class="bar-pct">{(size/total_size)*100:.1f}%</span></div>'
        for ext, size in sorted_exts
    )
    def fmt(b):
        if b < 1024: return f"{b} B"
        if b < 1048576: return f"{b/1024:.1f} KB"
        return f"{b/1048576:.1f} MB"

    html = f'''<!DOCTYPE html>
<html><head>
  <meta charset="utf-8"><title>Codebase Explorer</title>
  <style>
    body {{ font: 14px/1.5 system-ui, sans-serif; margin: 0; background: #1a1a2e; color: #eee; }}
    .container {{ display: flex; height: 100vh; }}
    .sidebar {{ width: 280px; background: #252542; padding: 20px; border-right: 1px solid #3d3d5c; overflow-y: auto; flex-shrink: 0; }}
    .main {{ flex: 1; padding: 20px; overflow-y: auto; }}
    h1 {{ margin: 0 0 10px 0; font-size: 18px; }}
    h2 {{ margin: 20px 0 10px 0; font-size: 14px; color: #888; text-transform: uppercase; }}
    .stat {{ display: flex; justify-content: space-between; padding: 8px 0; border-bottom: 1px solid #3d3d5c; }}
    .stat-value {{ font-weight: bold; }}
    .bar-row {{ display: flex; align-items: center; margin: 6px 0; }}
    .bar-label {{ width: 55px; font-size: 12px; color: #aaa; }}
    .bar {{ height: 18px; border-radius: 3px; }}
    .bar-pct {{ margin-left: 8px; font-size: 12px; color: #666; }}
    .tree {{ list-style: none; padding-left: 20px; }}
    details {{ cursor: pointer; }}
    summary {{ padding: 4px 8px; border-radius: 4px; }}
    summary:hover {{ background: #2d2d44; }}
    .folder {{ color: #ffd700; }}
    .file {{ display: flex; align-items: center; padding: 4px 8px; border-radius: 4px; }}
    .file:hover {{ background: #2d2d44; }}
    .size {{ color: #888; margin-left: auto; font-size: 12px; }}
    .dot {{ width: 8px; height: 8px; border-radius: 50%; margin-right: 8px; }}
  </style>
</head><body>
  <div class="container">
    <div class="sidebar">
      <h1>📊 Summary</h1>
      <div class="stat"><span>Files</span><span class="stat-value">{stats["files"]:,}</span></div>
      <div class="stat"><span>Directories</span><span class="stat-value">{stats["dirs"]:,}</span></div>
      <div class="stat"><span>Total size</span><span class="stat-value">{fmt(data["size"])}</span></div>
      <div class="stat"><span>File types</span><span class="stat-value">{len(stats["extensions"])}</span></div>
      <h2>By file type</h2>
      {lang_bars}
    </div>
    <div class="main">
      <h1>📁 {escape(data["name"])}</h1>
      <ul class="tree" id="root"></ul>
    </div>
  </div>
  <script>
    const data = {json.dumps(data)};
    const colors = {json.dumps(colors)};
    function fmt(b) {{ if (b < 1024) return b + ' B'; if (b < 1048576) return (b/1024).toFixed(1) + ' KB'; return (b/1048576).toFixed(1) + ' MB'; }}
    function esc(s) {{ return s.replace(/[&<>"']/g, c => ({{"&":"&amp;","<":"&lt;",">":"&gt;",'"':"&quot;","'":"&#39;"}}[c])); }}
    function render(node, parent) {{
      if (node.children) {{
        const det = document.createElement('details');
        det.open = parent === document.getElementById('root');
        det.innerHTML = `<summary><span class="folder">📁 ${{esc(node.name)}}</span><span class="size">${{fmt(node.size)}}</span></summary>`;
        const ul = document.createElement('ul'); ul.className = 'tree';
        node.children.sort((a,b) => (b.children?1:0)-(a.children?1:0) || a.name.localeCompare(b.name));
        node.children.forEach(c => render(c, ul));
        det.appendChild(ul);
        const li = document.createElement('li'); li.appendChild(det); parent.appendChild(li);
      }} else {{
        const li = document.createElement('li'); li.className = 'file';
        li.innerHTML = `<span class="dot" style="background:${{colors[node.ext]||'#6b7280'}}"></span>${{esc(node.name)}}<span class="size">${{fmt(node.size)}}</span>`;
        parent.appendChild(li);
      }}
    }}
    data.children.forEach(c => render(c, document.getElementById('root')));
  </script>
</body></html>'''
    output.write_text(html)

if __name__ == '__main__':
    target = Path(sys.argv[1] if len(sys.argv) > 1 else '.').resolve()
    stats = {"files": 0, "dirs": 0, "extensions": Counter(), "ext_sizes": Counter()}
    data = scan(target, stats)
    out = Path('codebase-map.html')
    generate_html(data, stats, out)
    print(f'Generated {out.absolute()}')
    webbrowser.open(f'file://{out.absolute()}')

​

Troubleshooting

​

Skill tidak terpicu

1. Periksa deskripsi mencakup kata kunci yang akan secara alami diucapkan pengguna
2. Verifikasi skill muncul di What skills are available?
3. Coba rephrase permintaan Anda untuk lebih cocok dengan deskripsi
4. Panggil secara langsung dengan /skill-name jika skill dapat diinvokasi oleh pengguna
5. Jika /skill-name juga tidak dikenali, periksa apakah Claude Code menolak nama skill tersebut

​

Skill terpicu terlalu sering

1. Buat deskripsi lebih spesifik
2. Tambahkan disable-model-invocation: true jika Anda hanya menginginkan invokasi manual

​

Claude berhenti mengikuti skill

• Claude melewatkan aturan yang harus berlaku setiap saat: pindahkan aturan ke dalam hook. Claude Code menjalankan hook setiap kali event-nya terjadi, seperti sebelum setiap edit file, terlepas dari apakah Claude mengikuti skill atau tidak. Untuk menjaga aturan bersama skill, tentukan hook dalam hooks frontmatter skill. Hook tersebut berlaku dari saat skill diinvokasi hingga sesi berakhir.
• Claude melewatkan panduan yang seharusnya diterapkan dengan pertimbangan: kata-katakan panduan sehingga berlaku untuk seluruh tugas, misalnya “Jalankan tes setelah setiap edit” daripada “Jalankan tes”. Claude Code menambahkan konten skill ke percakapan saat skill diinvokasi dan tidak membaca ulang file pada giliran berikutnya.
• Percakapan telah dikompakkan: panggil skill lagi untuk memulihkan konten lengkapnya. Setelah compaction, Claude Code hanya dapat menyimpan awal skill yang diinvokasi, jadi letakkan instruksi paling penting di dekat bagian atas SKILL.md.

​

Deskripsi skill terpotong

​

Personal skills hilang

​

Sumber daya terkait

• Debug konfigurasi Anda: diagnosis mengapa skill tidak muncul atau tidak terpicu
• Mengevaluasi kualitas output skill: format file eval dan alur kerja iterasi di agentskills.io
• Praktik terbaik penulisan skill: panduan penulisan yang berlaku di seluruh produk Claude
• Subagents: delegasikan tugas ke agen khusus
• Plugins: paket dan distribusikan skills dengan ekstensi lainnya
• Hooks: otomatisasi workflow di sekitar peristiwa tool
• Memory: kelola file CLAUDE.md untuk konteks persisten
• Commands: referensi untuk perintah bawaan dan skills bundel
• Permissions: kontrol akses tool dan skill
• Claude Tag skills: project skills yang di-commit ke repo juga dimuat ketika repo tersebut digunakan di saluran Claude Tag