chore: add shared skills catalog (19 skills), installers, manifest, validator

README.md

@@ -1,3 +1,54 @@
-# dsh-skills
+# dsh-skills — shared DeepSeek Harness skills
 
-Shared DeepSeek Harness skills catalog - install into ~/.dsh/skills
+Общий каталог скиллов для DeepSeek Harness (`~/.dsh/skills`).
+Каждый скилл — папка `skills/<name>/SKILL.md` (+ вложенные ресурсы/скрипты), по схеме провайдера `dsh-skill-filesystem`.
+
+## Состав
+
+См. [manifest.json](manifest.json) — программный каталог. Краткий список:
+
+| Скилл | Описание |
+|---|---|
+| `code-review-and-quality` | Code review & software quality assurance |
+| `conventional-commits-and-pr` | Conventional commits & PR documentation |
+| `db-migration-safety` | Safe DB migrations & SQL optimization |
+| `documentation-and-adrs` | ADRs & technical docs |
+| `e2e-playwright-expert` | Playwright E2E testing |
+| `github-actions-workflow-architect` | GitHub Actions CI/CD design |
+| `grill-me` | Architecture/plan stress-testing |
+| `lab-imagegen` | Home-lab ComfyUI image generation |
+| `lab-pdf-ocr` | Home-lab Docling PDF OCR |
+| `lab-speech-to-text` | Home-lab Whishper speech-to-text |
+| `research` | Deep research outline workflow |
+| `research-add-fields` | Add fields to research outline |
+| `research-add-items` | Add research items |
+| `research-deep` | Deep research via subagents |
+| `research-report` | Summarize research to report |
+| `security-audit` | Security audit & threat modeling |
+| `systematic-debugging` | Scientific debugging method |
+| `test-driven-development` | TDD red-green-refactor |
+| `web-performance-audit` | Core Web Vitals optimization |
+
+## Установка
+
+Скиллы DSH читает из `~/.dsh/skills` (и `~/.agents/skills`). Установи каталог в каталог скиллов:
+
+### PowerShell (Windows)
+
+```powershell
+.\install.ps1
+```
+
+Клонирует/обновляет репозиторий в `$env:DSH_HOME\skills\dsh-skills` и (опционально) ставит symlink-переходник — либо копирует `.agents/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`.