From fad8f87fc07b4c9c0e076d28d1feb63aeed84769 Mon Sep 17 00:00:00 2001 From: vitya Date: Tue, 28 Apr 2026 20:27:51 +0300 Subject: [PATCH] chore: track skill-readmes task in .tasks/ MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Per using-tasks: opened a 🟡 paused block for the multi-skill README work, with a per-task file capturing the goal, log, and next-step ordering for the remaining 15 skills. Co-Authored-By: Claude Opus 4.7 (1M context) --- .tasks/STATUS.md | 8 ++++++++ .tasks/skill-readmes.md | 26 ++++++++++++++++++++++++++ 2 files changed, 34 insertions(+) create mode 100644 .tasks/skill-readmes.md diff --git a/.tasks/STATUS.md b/.tasks/STATUS.md index 85ccfae..aae61e0 100644 --- a/.tasks/STATUS.md +++ b/.tasks/STATUS.md @@ -14,6 +14,14 @@ _Updated: 2026-04-28_ 🔵 Blocked — waiting on external input --> +## 🟡 [skill-readmes] — write English README.md for every skill + translate root README +**Status:** paused +**Where I stopped:** finished `skills/project-bootstrap/README.md` and root README EN translation (root `README.md` now EN, original kept as `README.ru.md` with cross-links between the two; broken `.wiki/source/repo-layout.md` link in the Russian fixed to `.wiki/concepts/repo-layout.md`) +**Next action:** decide order for the remaining 15 skills (suggest: `setup-wiki`, `setup-tasks`, `using-wiki`, `using-tasks` next since `project-bootstrap` already cross-references them), then write each `skills//README.md` from its `SKILL.md` +**Branch:** master + +--- + ## ⚪ [compress-dedup] — resolve compress vs caveman-compress duplication **Status:** ready **Where I stopped:** (not started) — noticed during initial migration that both skills ship identical `scripts/` subtrees (`compress.py`, `cli.py`, `detect.py`, `validate.py`, `benchmark.py`) diff --git a/.tasks/skill-readmes.md b/.tasks/skill-readmes.md new file mode 100644 index 0000000..3f3adad --- /dev/null +++ b/.tasks/skill-readmes.md @@ -0,0 +1,26 @@ +# 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//README.md` — per-skill README (created here) +- `skills//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. + +## 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) + +## 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).