Files

vitya 9508db92a1 chore: update skill-readmes task — infra cluster done

Marked READMEs for project-bootstrap, setup-wiki, setup-tasks,
using-wiki, using-tasks as completed. Next-action points at the
caveman cluster (or other groups) for the next batch.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

2026-04-28 20:31:29 +03:00

1.8 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)
setup-wiki README
setup-tasks README
using-wiki README
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).

1.8 KiB Raw Blame History