Agent UI Skills and Editor References

Summary#

Closed Akashic UI work should use the installed Codex UI/design skills first, then lightweight open-source editor references when the product needs Notion-like behavior.

Local Skills#

frontend-skill: use for app-surface restraint, hierarchy, spacing, and avoiding unnecessary card chrome.
Design/UX skills such as refactoring-ui, ux-heuristics, web-typography, top-design, and microinteractions: use when layout, density, typography, or interaction polish needs explicit review.
Figma skills: use only when the task requires design-file creation, design-system extraction, or Figma implementation workflows.
playwright-interactive / Playwright workflow: use for real browser verification after deploy, especially sidebar state, graph panels, editing flows, keyboard navigation, and mobile overflow checks.
skill-installer: use only when a missing skill is clearly useful. Do not install a heavy editor-specific skill unless current UI work has a concrete gap.

External References#

Outline: https://github.com/outline/outline
Useful as a knowledge-base reference because it is markdown-compatible and focused on collaborative documents.
BlockSuite: https://github.com/toeverything/blocksuite
Useful as a future editor reference. It is a toolkit for building block editors and collaborative applications, with reusable PageEditor/EdgelessEditor concepts.
Docmost: https://github.com/docmost/docmost
Useful as a wiki/documentation reference because it positions itself as an open-source alternative to Confluence and Notion.

Current Closed Akashic Decision#

Do not install a heavy React block editor inside the current FastAPI monolith yet. Keep the live site as a lightweight Markdown vault editor.

Current UI constraints and preferences: - top navigation only for Home, Graph, Debug - note workspace panels in the left sidebar - inline page editing for title, summary, body, block snippets, image upload, file links, and image width markup - graph view as one floating menu with internal Search, Selection, and Display tabs - avoid live keystroke filtering in explorer/palette/graph explorer; apply filtering on Enter or search-button click to prevent UI jitter - prefer single-file or low-dependency UI improvements unless a feature clearly requires deeper frontend architecture

A future v2 editor can evaluate BlockSuite or another block editor if direct Markdown text editing becomes the bottleneck.

Cross-References#

personal_vault/projects/personal/openakashic/reference/closed-web-ui-refresh-2026-04-17.md records the current lightweight Closed Akashic web UI direction: single-file FastAPI/vanilla JS frontend changes, no added library, compact UI, Cmd+K recent notes, mini graph behavior, and a no-live-filtering preference.
personal_vault/projects/personal/codex-skill-catalog/reference/Installed UI UX Design Game and Web Skills 2026-04-23.md records the installed Codex/UI skill set and should be treated as the current source for exact local skill names.

Revalidation History#