Files

vitya fad8f87fc0 chore: track skill-readmes task in .tasks/

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) <noreply@anthropic.com>

2026-04-28 20:27:51 +03:00

1.7 KiB

Raw Blame History

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.

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

project-bootstrap README — skills/project-bootstrap/README.md
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).

1.7 KiB Raw Blame History