fenix-skills/README.md

80 lines
3.1 KiB
Markdown

# Fenix Skills — Claude Code Plugin
Custom Claude Code skills for Fénix's workflow.
Includes all [xenodium/emacs-skills](https://github.com/xenodium/emacs-skills) (forked & rebranded) plus Fénix's own productivity tools.
---
## Plugin Structure
```
~/Emacs/fenix-skills/
├── .claude-plugin/
│ └── marketplace.json # Plugin manifest
├── README.md
└── skills/
├── d2/ # /d2 — Create D2 diagrams
├── describe/ # /describe — Emacs describe-* lookups
├── dired/ # /dired — Open files in dired buffer
├── emacsclient/ # (auto) Always use emacsclient, not emacs
├── extract-pdf-pages/ # /extract-pdf-pages — Extract page ranges with pdftk
├── file-links/ # (auto) Format file refs as markdown #L links
├── gnuplot/ # /gnuplot — Plot data with gnuplot
├── highlight/ # /highlight — Highlight regions in Emacs
├── mermaid/ # /mermaid — Create Mermaid diagrams
├── open/ # /open — Open files in Emacs buffers
├── plantuml/ # /plantuml — Create PlantUML diagrams
└── select/ # /select — Select regions in Emacs
```
## Registration
Registered in `~/.claude/settings.json` as:
```json
"extraKnownMarketplaces": {
"fenix-skills": {
"source": {
"source": "directory",
"path": "/home/fenix/Emacs/fenix-skills"
}
}
}
```
```json
"enabledPlugins": {
"fenix-tools@fenix-skills": true
}
```
## Usage
All slash-command skills are available **system-wide** in any Claude Code session:
| Skill | Invocation | Description |
|:---|:---:|:---|
| **d2** | `/d2` | Create diagrams with D2 |
| **describe** | `/describe` | Look up Emacs docs (functions, variables, keys) |
| **dired** | `/dired` | Open recent files in Emacs dired buffer |
| **emacsclient** | _(auto)_ | Always prefer `emacsclient` over `emacs` |
| **extract-pdf-pages** | `/extract-pdf-pages` | Extract page range from PDF via `pdftk` |
| **file-links** | _(auto)_ | Format file references as `file.py#L42` links |
| **gnuplot** | `/gnuplot` | Plot data with gnuplot |
| **highlight** | `/highlight` | Highlight line regions in Emacs buffers |
| **mermaid** | `/mermaid` | Create Mermaid diagrams |
| **open** | `/open` | Open files in Emacs (with optional line jump) |
| **plantuml** | `/plantuml` | Create PlantUML diagrams |
| **select** | `/select` | Select (mark) regions in Emacs buffers |
## Origin
- **Emacs skills** (d2, describe, dired, emacsclient, file-links, gnuplot, highlight, mermaid, open, plantuml, select) — forked from [xenodium/emacs-skills](https://github.com/xenodium/emacs-skills) by Alvaro Ramirez
- **extract-pdf-pages** — original, requires `pdftk` (`apt install pdftk`)
## Requirements
- GNU Emacs with running server daemon (`emacsclient` accessible)
- `pdftk` for PDF extraction skill
- Claude Code with plugins enabled