From 78149d9e5698f139db3c1dc72139cd3bd328fe4d Mon Sep 17 00:00:00 2001
From: "dolgolyov.alexei" <dolgolyov.alexei@gmail.com>
Date: Wed, 25 Mar 2026 15:55:04 +0300
Subject: [PATCH] docs: add .skill package installation instructions

Document both CLI and manual extraction methods for installing
.skill packages, covering VS Code extension users without the
claude CLI.
---
 claude-code-tools.md | 19 +++++++++++++++++++
 1 file changed, 19 insertions(+)

diff --git a/claude-code-tools.md b/claude-code-tools.md
index 32da995..1716e00 100644
--- a/claude-code-tools.md
+++ b/claude-code-tools.md
@@ -23,6 +23,25 @@ Up-to-date documentation and code examples for any library, available directly i
 
 Skills are a different extension mechanism from MCPs. They are prompt-based extensions invoked via `/skill-name` commands directly within Claude Code — no external server required.
 
+### Installing `.skill` packages
+
+Skills are distributed as `.skill` files (ZIP archives containing a `SKILL.md` and optional scripts).
+
+**Option 1 — CLI** (if `claude` command is available):
+
+```bash
+claude skill install --scope user my-skill.skill
+```
+
+**Option 2 — Manual extraction** (works everywhere, including VS Code extension):
+
+```bash
+# Python one-liner
+python -c "import zipfile; zipfile.ZipFile('my-skill.skill').extractall('$HOME/.claude/skills')"
+```
+
+Skills are extracted into `~/.claude/skills/<skill-name>/`. They become available in the next Claude Code session.
+
 ### AST Index
 
 Fast code search skill for Claude Code — find classes, symbols, usages, implementations, and more across large codebases using AST parsing.