Custom skills for gemini-cli.
This option can be either:
- An attribute set defining skills
- A path to a directory containing skill folders
If an attribute set is used, the attribute name becomes the skill directory name, and the value is either:
- Inline content as a string (creates
~/.gemini/skills/<name>/SKILL.md) - A path to a file (creates
~/.gemini/skills/<name>/SKILL.md) - A path to a directory (symlinks
~/.gemini/skills/<name>/to that directory)
If a path is used, it is expected to contain one folder per skill name, each containing a SKILL.md. The directory is symlinked to ~/.gemini/skills/.
Declarations
Type
(attribute set of (strings concatenated with "\n" or absolute path)) or absolute pathDefault
{ }Example
{
xlsx = ./skills/xlsx/SKILL.md;
data-analysis = ./skills/data-analysis;
pdf-processing = ''
---
name: pdf-processing
description: Extract text and tables from PDF files, fill forms, merge documents. Use when working with PDF files or when the user mentions PDFs, forms, or document extraction.
---
# PDF Processing
## Quick start
Use pdfplumber to extract text from PDFs:
```python
import pdfplumber
with pdfplumber.open("document.pdf") as pdf:
text = pdf.pages[0].extract_text()
```
'';
}