feat(skills): add openkb-deck-neon (dark Aurora Glass) + make it the default deck skill by KylinMountain · Pull Request #101 · VectifyAI/OpenKB

KylinMountain · 2026-06-16T04:49:59Z

Summary

Adds a new built-in deck skill openkb-deck-neon — a dark, neon / glassmorphism visual direction ("Aurora Glass") — and makes it the default for openkb deck new.

Plain openkb deck new <name> "<intent>" now uses it.
The previous default is still available via --skill openkb-deck-editorial.

What's in it

Fixed design system: near-black canvas (#080b11), teal / sky / magenta / amber neon accents, aurora-gradient + grain atmosphere, glassmorphism panels, glowing bottom signature bar.
Local font stacks only (no web fonts) — decks stay fully self-contained.
Scale-to-fit 16:9 stage (1280×720 design size + JS transform:scale) that letterbox-fills any window size and fullscreen — no fixed-width card.
Reuses the existing deck grammar (cover / chapter / thesis / quote / compare / data / closing) and engine. The only engine-side change is flipping DEFAULT_DECK_SKILL (+ matching CLI/chat help & labels); the editorial skill is untouched and still selectable.

Testing

Generated a real deck from this repo's own KB (effective-agents, no --skill → routes to neon by default):

✅ deck validator passes (self-contained, zero external links, 10 slides, 7 distinct slide types)
✅ uses real KB concepts (augmented-llm, agentic-systems, agent-harness, tool-calling-architecture) with source citations
✅ Aurora Glass styling renders correctly and fills a 2560px-wide viewport (verified in Chrome, no console errors)
✅ default switch verified: DEFAULT_DECK_SKILL == "openkb-deck-neon", affected modules import cleanly

Authored following the writing-skills RED → GREEN → REFACTOR flow.

A neon / glassmorphism deck visual direction parallel to openkb-deck-editorial: near-black canvas, teal/sky/magenta accents, aurora atmosphere, glass panels, and a scale-to-fit 16:9 stage that letterbox-fills any viewport (no fixed 1280px card). Reuses the existing deck engine and grammar (od.mode: deck) — no code changes. Invoke with: openkb deck new <name> "<intent>" --skill openkb-deck-neon

openkb deck new (and chat /deck) now route to openkb-deck-neon when no --skill is given; openkb-deck-editorial stays available via --skill openkb-deck-editorial. Updates DEFAULT_DECK_SKILL plus the matching CLI/chat help text and skill labels.

…ayout - Frame: slides are position:fixed;inset:0 — no letterbox / no fixed card - Type scale uses clamp() so it scales with the viewport - Content wraps in an .inner with an explicit max-width: centered/data slides no longer collapse into a narrow sliver on wide screens; big numbers nowrap; compare uses a capped 2-col grid - Guard against the invalid SVG height="auto" attribute Verified by regenerating the effective-agents deck at 2560px wide: cover, data, compare and closing all fill edge-to-edge with stable layout.

…ayouts Replaces the left-aligned narrow column (which left a large empty right half) with three width-filling layouts: split (text + a first-class visual filling the other column), full-bleed headline (title ~70vw + full-width detail row), and centered focus. Adds a per-slide 'no empty right half' self-test and the matching failure mode. Verified by regenerating effective-agents at 2560px wide: cover (full-width info strip), thesis (left text + node-graph visual), compare (two columns), data (centered big number), closing (left text + layered-stack visual) — all balanced edge-to-edge, console clean.

- SKILL.md: replace stale fixed-px sizes in the slide-grammar table (chapter 120px/40px, data 120-160px, copied from the fixed-1280px editorial skill) with clamp()/relative values, matching this skill's own clamp() mandate; de-ambiguate the --type-label scale row (letter-spacing was in the line-height slot); add a 'content must fit one screen, no scroll' rule since overflow:hidden + justify-center silently clips tall slides top and bottom - cli.py / chat.py: derive the deck label from DEFAULT_DECK_SKILL instead of a hardcoded literal (the label could silently report the wrong skill after a future default change); note the --help default must track the constant - tests: add test_deck_neon_prompt.py guarding the now-default neon skill's frontmatter + od contract (previously only deck-editorial was pinned)

A data comparison number (A -> B / A vs B) at the single-number font size overran its centered container; the trailing % fell outside the background-clip:text gradient and smeared under the glow. Give the number width:max-content + max-width:92vw, and a smaller font clamp (clamp(2.4rem,7vh,5.5rem)) for comparison numbers. Verified by regenerating: data number renders at 82px / 562px wide, no overflow, % fully painted.

The split-layout visual column let the LLM place labels in <svg><text>, which does not wrap or reflow — multiple labels in the narrow column overlapped into an unreadable smear (node captions, timeline stage labels). Require the visual to be built in HTML/CSS with each label in its own auto-spaced box; reserve SVG for lines/shapes only; cap at <=4 nodes with short labels, else a vertical stack of full-width rows. Verified by regenerating the founder-playbook deck: 0 svg <text>, 0 overlapping labels across all 10 slides; the chapter visual is now clean stacked HTML cards.

…enkb-deck-neon #101 made openkb-deck-neon the default deck skill (creator.py DEFAULT_DECK_SKILL) but left this test asserting the old openkb-deck-editorial, so it was red on main. Unrelated to visualize.

… radial) (#103) * fix(test): align stale deck default-skill expectation with shipped openkb-deck-neon #101 made openkb-deck-neon the default deck skill (creator.py DEFAULT_DECK_SKILL) but left this test asserting the old openkb-deck-editorial, so it was red on main. Unrelated to visualize. * feat(visualize): build the wikilink graph + render the self-contained HTML build_graph(wiki_dir) walks summaries/concepts/entities, collects nodes (id/label/type/description/sources + in/out degree), resolves [[wikilinks]] to edges (reusing lint._extract_wikilinks/_normalize_target and frontmatter.parse; dirs from schema.PAGE_CONTENT_DIRS), and drops broken/self/duplicate links. render_html injects the graph as JSON into the template (escaping </ so it can't break out of <script>). * feat(cli): add the visualize command Thin read-only command mirroring the other commands' decorators + KB lock: resolve KB -> build_graph -> render_html -> write output/visualize/graph.html. Opens in the browser by default (--no-open for headless), resolve()s the path for a valid file URI, and degrades with a hint if no browser launches. * feat(visualize): self-contained interactive graph template (3D / mind-map / radial) One offline HTML page (canvas + DOM, no CDN/network) with three switchable views of the same KB: a 3D force 'nebula' (default; glow, degree-sized nodes, flow particles, idle auto-rotation), an OpenKB-rooted horizontal mind-map (collapsible provenance tree), and a radial OpenKB-centred circle with faint cross-references. Shared: glass inspector panel, search, legend type-filter, spacing slider, reset, smooth auto-fit. Neon-on-dark aurora. * test(visualize): build_graph + render_html + CLI tests build_graph (nodes/edges/types, broken-link drop, orphan, degree, provenance sources incl. summary full_text); render_html self-contained (canvas, JSON embedded, no http(s), unicode round-trip); CLI writes output/visualize/ graph.html, opens by default, --no-open suppresses, empty wiki writes nothing. * docs(readme): document openkb visualize Add it to the Layer 2 generators table and a '(iii) Visualize' subsection matching the existing (i)/(ii) generator sections: a self-contained interactive knowledge graph (3D / mind-map / radial) written to output/visualize/graph.html.

KylinMountain · 2026-06-16T04:49:59Z

Summary

Adds a new built-in deck skill openkb-deck-neon — a dark, neon / glassmorphism visual direction ("Aurora Glass") — and makes it the default for openkb deck new.

Plain openkb deck new <name> "<intent>" now uses it.
The previous default is still available via --skill openkb-deck-editorial.

What's in it

Fixed design system: near-black canvas (#080b11), teal / sky / magenta / amber neon accents, aurora-gradient + grain atmosphere, glassmorphism panels, glowing bottom signature bar.
Local font stacks only (no web fonts) — decks stay fully self-contained.
Scale-to-fit 16:9 stage (1280×720 design size + JS transform:scale) that letterbox-fills any window size and fullscreen — no fixed-width card.
Reuses the existing deck grammar (cover / chapter / thesis / quote / compare / data / closing) and engine. The only engine-side change is flipping DEFAULT_DECK_SKILL (+ matching CLI/chat help & labels); the editorial skill is untouched and still selectable.

Testing

Generated a real deck from this repo's own KB (effective-agents, no --skill → routes to neon by default):

✅ deck validator passes (self-contained, zero external links, 10 slides, 7 distinct slide types)
✅ uses real KB concepts (augmented-llm, agentic-systems, agent-harness, tool-calling-architecture) with source citations
✅ Aurora Glass styling renders correctly and fills a 2560px-wide viewport (verified in Chrome, no console errors)
✅ default switch verified: DEFAULT_DECK_SKILL == "openkb-deck-neon", affected modules import cleanly