vitya
72022fc1dc
User paused the task. Logged the pause point in the decisions log; STATUS.md block already 🟡 with the resume hint. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
32 lines
2.0 KiB
Markdown
32 lines
2.0 KiB
Markdown
# skill-readmes
|
|
|
|
## Goal
|
|
Write English `README.md` for every skill source under `skills/`, plus translate the repo-root `README.md` to English (preserving the Russian original as `README.ru.md`). READMEs document each skill for outside readers — what it does, when it triggers, prerequisites, install. Done iteratively, one skill at a time.
|
|
|
|
## Key files
|
|
- `skills/<name>/README.md` — per-skill README (created here)
|
|
- `skills/<name>/SKILL.md` — source of truth for skill behavior; README is derived from it
|
|
- `README.md` (root) — top-level repo README, translated to English
|
|
- `README.ru.md` (root) — original Russian preserved
|
|
|
|
## Decisions log
|
|
- 2026-04-28: Project-wide language for new READMEs is English. Russian root README preserved as `README.ru.md` for the bilingual record.
|
|
- 2026-04-28: Skip emoji-heavy / marketing layout (caveman-compress style). Default to plain technical README with: title, one-line, sections for behavior / triggers / prerequisites / install. Skill-by-skill, no batch rewrite.
|
|
- 2026-04-28: Started with `project-bootstrap` per user request.
|
|
- 2026-04-28: Infra cluster (5 skills) finished; user paused the task here. Resume by picking the next batch (caveman, context7, or other) — see Next action in STATUS.md.
|
|
|
|
## Open questions
|
|
- [ ] Order for the remaining skills — alphabetical, or by importance (using-wiki, using-tasks, setup-wiki, setup-tasks first since they are referenced by project-bootstrap)?
|
|
|
|
## Completed steps
|
|
- [x] `project-bootstrap` README — `skills/project-bootstrap/README.md`
|
|
- [x] Root README EN translation — `README.md` (EN) + `README.ru.md` (original RU, fixed broken `.wiki/source/...` link)
|
|
- [x] `setup-wiki` README
|
|
- [x] `setup-tasks` README
|
|
- [x] `using-wiki` README
|
|
- [x] `using-tasks` README
|
|
|
|
## Notes
|
|
- Skills with README already: `caveman-compress` (different style — keep as-is, do not normalize for now).
|
|
- Cross-platform install reference: repo root README (PS + bash both, per active-platform docs rule).
|