Document the page and wiki skills in the README #27

Closed
opened 2026-08-10 12:30:43 +00:00 by claude · 0 comments
Collaborator

Summary

README описывает плагин из трёх скиллов, а поставляется шесть: skills/page и
skills/wiki не упомянуты ни разу, в дереве проекта их нет. В том же дереве
нет и labels.py. Первое, что читает новый человек, отстало от репозитория.

Spec

none

Steps to reproduce

  1. grep -n -e "page" -e "wiki" README.md — ни одного совпадения.
  2. grep -n "labels" README.md — только пример grep по метке в issue.
  3. Сравнить с AGENTS.md, где оба слоя и labels.py описаны.

Expected

README перечисляет то, что реально лежит в skills/: auth, issue, sync,
page, wiki, use — и скрипты каждого слоя. Дерево проекта в README и
раскладка в AGENTS.md расходиться не должны.

Actual

README.md:112-149 — блок «Project layout» знает только issue/, sync/ и
use/. skills/page и skills/wiki (коммит 1815d91, «discussion artifacts
as wiki pages, in two new layers») в README не доехали. В разделе «What it
ships» их тоже нет, так что про /tea:page и /tea:wiki из README узнать
нельзя вообще.

Environment

  • README.md:112 — начало «Project layout»; README.md:137-145 — список
    скриптов слоя sync, где нет labels.py.
  • AGENTS.md — актуальная раскладка, с которой README и надо свести.
  • Найдено при работе над stop-materializing-the-store-for-label-payloads
    (claude-skills/tea#19): искал, где документирован labels.py, и в README
    его не нашёл.

Acceptance criteria

  • README перечисляет все скиллы из skills/, включая page и wiki
  • дерево «Project layout» включает labels.py и скрипты слоёв page и wiki
  • раздел «What it ships» упоминает /tea:page и /tea:wiki
  • раскладка в README не противоречит AGENTS.md
<!-- tea:id document-the-page-and-wiki-skills-in-the-readme --> ## Summary README описывает плагин из трёх скиллов, а поставляется шесть: `skills/page` и `skills/wiki` не упомянуты ни разу, в дереве проекта их нет. В том же дереве нет и `labels.py`. Первое, что читает новый человек, отстало от репозитория. ## Spec none ## Steps to reproduce 1. `grep -n -e "page" -e "wiki" README.md` — ни одного совпадения. 2. `grep -n "labels" README.md` — только пример `grep` по метке в issue. 3. Сравнить с `AGENTS.md`, где оба слоя и `labels.py` описаны. ## Expected README перечисляет то, что реально лежит в `skills/`: `auth`, `issue`, `sync`, `page`, `wiki`, `use` — и скрипты каждого слоя. Дерево проекта в README и раскладка в `AGENTS.md` расходиться не должны. ## Actual `README.md:112-149` — блок «Project layout» знает только `issue/`, `sync/` и `use/`. `skills/page` и `skills/wiki` (коммит `1815d91`, «discussion artifacts as wiki pages, in two new layers») в README не доехали. В разделе «What it ships» их тоже нет, так что про `/tea:page` и `/tea:wiki` из README узнать нельзя вообще. ## Environment - `README.md:112` — начало «Project layout»; `README.md:137-145` — список скриптов слоя sync, где нет `labels.py`. - `AGENTS.md` — актуальная раскладка, с которой README и надо свести. - Найдено при работе над `stop-materializing-the-store-for-label-payloads` (`claude-skills/tea#19`): искал, где документирован `labels.py`, и в README его не нашёл. ## Acceptance criteria - [ ] README перечисляет все скиллы из `skills/`, включая `page` и `wiki` - [ ] дерево «Project layout» включает `labels.py` и скрипты слоёв page и wiki - [ ] раздел «What it ships» упоминает `/tea:page` и `/tea:wiki` - [ ] раскладка в README не противоречит `AGENTS.md`
claude added this to the Self-improvement milestone 2026-08-10 12:30:43 +00:00
claude added the
type
bug
severity
low
comp/docs
labels 2026-08-10 12:30:43 +00:00
Sign in to join this conversation.