# hackmd-cli

Скилл учит ИИ-агента управлять заметками и папками HackMD через hackmd-cli: создавать, править, раскладывать по папкам и выгружать наружу.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 1 установка · ★ 179 у репозитория
- Автор: hackmdio
- Лицензия: MIT · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/hackmdio/hackmd-cli/tree/HEAD/hackmd-cli/SKILL.md
- Обновлён: 2026-10-28
- Проверка безопасности: автоматическая, 2026-11-16 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/skills/hackmd-cli

## Что делает

Скилл описывает команды `hackmd-cli` и их флаги, чтобы агент вызывал их напрямую, а не сочинял запросы к API HackMD. Покрыты личные заметки, заметки команды, личные и командные папки, список команд и история просмотров. Права чтения и записи задаются при создании заметки, есть отдельный флаг для комментариев.

Сам CLI ставится отдельно: `npm install -g @hackmd/hackmd-cli`. Дальше нужен токен из настроек HackMD, который сохраняется через `hackmd-cli login` в `~/.hackmd/config.json` либо передаётся переменной `HMD_API_ACCESS_TOKEN`. Без токена ни одна команда не пройдёт авторизацию. Для инстанса HackMD EE дополнительно задаётся `HMD_API_ENDPOINT_URL`.

Списочные команды (`notes`, `team-notes`, `folders`, `team-folders`, `teams`, `history`) умеют отдавать JSON, YAML или CSV, фильтровать по свойству, сортировать и показывать выбранные колонки. Это удобно, когда агенту нужна одна заметка по заголовку, а не весь список. Выгрузка содержимого идёт через `hackmd-cli export --noteId=<id>` в stdout, так что результат легко перенаправить в файл.

## Установка

### Claude Code (родная платформа)

1. **Через Skills CLI (Vercel)**
```bash
npx skills add hackmdio/hackmd-cli --skill hackmd-cli -a claude-code
```

2. **Вручную: положить файлы**
- Файл: `~/.claude/skills/hackmd-cli/SKILL.md` — Папка скилла целиком; для одного проекта — .claude/skills/hackmd-cli/

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add hackmdio/hackmd-cli --skill hackmd-cli -a codex
```

2. **Вручную: положить файлы**
- Файл: `.agents/skills/hackmd-cli/SKILL.md` — Для всех проектов — ~/.agents/skills/

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add hackmdio/hackmd-cli --skill hackmd-cli -a cursor
```

2. **Вручную: положить файлы**
- Файл: `.cursor/skills/hackmd-cli/SKILL.md` — Cursor читает и .agents/skills/, и .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install hackmdio/hackmd-cli hackmd-cli
```

2. **Вручную: положить файлы**
- Файл: `.github/skills/hackmd-cli/SKILL.md`

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add hackmdio/hackmd-cli --skill hackmd-cli -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/hackmdio/hackmd-cli --path hackmd-cli
```

### Windsurf (Devin Desktop)

**Вручную: положить файлы**
- Файл: `.devin/skills/hackmd-cli/SKILL.md` — Старый путь .windsurf/skills/ тоже читается

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add hackmdio/hackmd-cli --skill hackmd-cli -a opencode
```

### Claude.ai

**Claude.ai**
- Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/hackmdio/hackmd-cli/tree/HEAD/hackmd-cli/SKILL.md

## Когда брать
- создать заметку в HackMD из локального `README.md`
- разложить заметки по личным и командным папкам
- выгрузить содержимое заметки в файл или пайп
- найти заметку по заголовку фильтром, не листая весь список
- сменить права чтения и записи у существующей заметки

## Примеры запросов агенту
- Создай заметку в HackMD из `doc.md` с заголовком «My Doc» и покажи её id.
- Покажи заметки команды по пути `<team-path>` и отсортируй их по заголовку.
- Выгрузи заметку `<id>` и сохрани её содержимое в `notes.md`.

## Похожие
- [yuna0x0-hackmd-mcp](https://affpapa.org/nevibecode/mcp/yuna0x0-hackmd-mcp.md) — MCP-сервер · ★ 68 у репозитория
- [qmd](https://affpapa.org/nevibecode/skills/qmd.md) — скилл · 4200 установок
- [obsidian-organizer](https://affpapa.org/nevibecode/skills/obsidian-organizer.md) — скилл · 1900 установок
- [flowus-cli](https://affpapa.org/nevibecode/skills/flowus-cli.md) — скилл · 1000 установок
- [wiki-narrate](https://affpapa.org/nevibecode/skills/wiki-narrate.md) — скилл · 403 установки
- [obsidian-cli](https://affpapa.org/nevibecode/skills/obsidian-cli.md) — скилл · 83700 установок

_Часть страницы не вошла по размеру — она есть в HTML-версии._

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md
