菜单
View files/directories OR generate visual explanations, slides, diagrams (Markdown or self-contained HTML). Use for 'explain X visually', 'diagram the flow', 'make slides', 'show diff', or 'generate HTML report'.
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
Asset Hunter Pro — unused asset detection, dependency graph, duplicate finder, project cleanup automation for Unity
Practical tools and validation methods for game balance — DPS calculators, EHP formulas, spreadsheet layouts, stat audits, difficulty spike detection
GDD structure, templates, and living documentation patterns for game projects — wiki pages, design docs, section layout, sync triggers
Game feel and juice — screen shake, hit stop, particles, animation curves, input responsiveness, feedback timing. Makes actions feel satisfying.
Mobile game design patterns — session design, retention mechanics, notification strategy, portrait/landscape, battery/thermal constraints, FTUE
Create or update TheOneKit agent .md files with canonical structure. Use when adding a new agent, updating maxTurns/model, or fixing frontmatter fields.
| name | t1k:preview |
| description | View files/directories OR generate visual explanations, slides, diagrams (Markdown or self-contained HTML). Use for 'explain X visually', 'diagram the flow', 'make slides', 'show diff', or 'generate HTML report'. |
| version | 1.1.0 |
| argument-hint | [path] OR [--html] --explain|--slides|--diagram|--ascii [topic] OR --html --diff|--plan-review|--recap |
| effort | medium |
| origin | theonekit-core |
| repository | The1Studio/theonekit-core |
| module | null |
| protected | true |
Universal viewer + visual generator. View existing content OR generate new visual explanations.
| Flag / Input | Mode | Output |
|---|---|---|
<file.md> | View | Rendered in novel-reader UI |
<directory/> | Browse | Directory listing |
--explain <topic> | Generate | Mermaid + code + prose |
--slides <topic> | Generate | Step-by-step walkthrough |
--diagram <topic> | Generate | Architecture or data flow |
--ascii <topic> | Generate | Terminal-friendly ASCII |
--html --explain | HTML Generate | Self-contained HTML explanation |
--html --slides | HTML Generate | Magazine-quality HTML deck |
--html --diagram | HTML Generate | HTML diagram with zoom controls |
--html --diff [ref] | HTML Generate | Visual diff review |
--html --plan-review | HTML Generate | Plan vs codebase comparison |
--html --recap | HTML Generate | Project context snapshot |
--stop | Control | Stop preview server |
If invoked without arguments, ask user which operation they want.
--stop — stop server and exit--html flag — set HTML output mode flag--explain, --slides, --diagram, --ascii) — load references/generation-modes.md--diff, --plan-review, --recap) — auto-set HTML, load references/generation-modes.mdreferences/view-mode.md## Plan Context hook): {plan_dir}/visuals/{mode}-{slug}-{date}.{ext}plans/visuals/{mode}-{slug}-{date}.{ext}Topic-to-slug: lowercase, hyphens, alphanumeric only, max 80 chars.
When --html is added:
xdg-open (Linux) or open (macOS)Before generating HTML, read: references/html-design-guidelines.md
Reference loading by mode: references/generation-modes.md
| Error | Action |
|---|---|
| Invalid/empty topic | Ask user to provide a topic |
| File write failure | Report error, check disk space and permissions |
--diff without git context | Explain: "No git repo detected." |
--plan-review without plan | Explain: "Provide plan file path or active plan." |
--html --ascii combination | Not supported — suggest --html --diagram instead |
Full error table and gotchas: references/preview-gotchas.md
Triggers on: preview, visualize, diagram, explain visually, slides, html output, visual diff, plan review, recap, ascii diagram, generate html, make slides, show diagram