# dsh-skills — shared DeepSeek Harness skills

Общий каталог скиллов для DeepSeek Harness (`~/.dsh/skills`).
Каждый скилл — папка `skills/<name>/SKILL.md` (+ вложенные ресурсы/скрипты), по схеме провайдера `dsh-skill-filesystem`.

## Состав (31 скиллов)

См. [manifest.json](manifest.json) — программный каталог метаданных. Список скиллов:

| Скилл | Описание |
|---|---|
| `api-designer` | Use when designing REST or GraphQL APIs, creating OpenAPI specifications, or ... |
| `brainstorming` | "You MUST use this before any creative work - creating features, building com... |
| `code-review-and-quality` | Use when conducting comprehensive code reviews on pull requests, diffs, or ne... |
| `codebase-design` | Shared vocabulary for designing deep modules. Use when the user wants to desi... |
| `conventional-commits-and-pr` | Use when generating commit messages, structuring pull request descriptions, o... |
| `db-migration-safety` | Use when designing database schemas, writing schema migrations, optimizing sl... |
| `documentation-and-adrs` | Use when documenting architectural decisions, drafting ADRs (Architecture Dec... |
| `drawio-skill` | Use when the user requests diagrams, flowcharts, architecture diagrams, ER di... |
| `e2e-playwright-expert` | Use when writing, maintaining, or debugging end-to-end (E2E) browser tests wi... |
| `frontend-design` | Guidance for distinctive, intentional visual design when building new UI or r... |
| `github-actions-workflow-architect` | Use when designing, optimizing, or securing GitHub Actions CI/CD workflows, c... |
| `grill-me` | Use when the user wants to stress-test an architecture plan, interrogate a de... |
| `lab-imagegen` | Generate images using the user's home-lab ComfyUI server (SDXL-turbo on 2x AM... |
| `lab-pdf-ocr` | Extract text from PDF documents using the user's home-lab Docling OCR server ... |
| `lab-speech-to-text` | Transcribe speech from audio files (wav, mp3, ogg, m4a) using the user's home... |
| `ln-24-architecture-auditor` | "Audits implemented architecture fitness, boundaries, contracts, dependencies... |
| `ln-71-system-design-baseline-builder` | "Creates a project baseline of architecture drivers and constraints. Use befo... |
| `ln-72-current-architecture-documenter` | "Documents implemented current-state architecture from repository evidence. U... |
| `ln-73-system-design-proposal-builder` | "Creates a decision-complete target system design from requirements and const... |
| `ln-74-architecture-decision-recorder` | "Records one architecture decision with context, alternatives, tradeoffs, and... |
| `ln-75-architecture-diagram-builder` | "Creates evidence-backed current or target architecture diagrams when the dia... |
| `ln-76-architecture-migration-planner` | "Plans a reversible architecture migration with compatibility, data movement,... |
| `research` | Conduct preliminary research on a topic and generate research outline. For ac... |
| `research-add-fields` | Add field definitions to existing research outline. |
| `research-add-items` | Add items (research objects) to existing research outline. |
| `research-deep` | Read research outline, launch independent agent for each item for deep resear... |
| `research-report` | Summarize deep research results into markdown report, cover all fields, skip ... |
| `security-audit` | Use when performing security audits, vulnerability scanning, threat modeling,... |
| `systematic-debugging` | Use when debugging complex bugs, unexpected test failures, race conditions, o... |
| `test-driven-development` | Use when building new features, refactoring existing modules, or fixing bugs ... |
| `web-performance-audit` | Use when analyzing web application performance, Core Web Vitals (LCP, INP, CL... |

## Установка

Скиллы DSH читает из `~/.dsh/skills` (и `~/.agents/skills`). Установи каталог в каталог скиллов:

### PowerShell (Windows)

```powershell
.\install.ps1
```

Синхронизирует директорию `skills/` напрямую в `$env:DSH_HOME\skills` (по умолчанию `~/.dsh/skills`).

### Bash/macOS/Linux

```bash
./install.sh "$HOME/.dsh/skills"
```

После установки перезапусти агента — каталог подхватится автоматически (`dsh-skill-filesystem` наблюдает файлы).

## Проверка

`validate.py` — проверяет frontmatter каждого `SKILL.md` (обязательные `name`, `description`; kebab-case) по правилам `dsh-skill-filesystem`.