Aholo Site
Developmentaholo-siteAholo Site is an Agent Skill for development published in the manycoretech/aholo-viewer repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.
Work on Aholo Viewer Astro website and Playground surfaces under website/. Use for routes, layouts, components, page chrome, i18n UI copy, scoped CSS, client render runtime, Playground runner, preview canvas, inspector, presets, route-local Monaco, and URL parameters. Use aholo-examples for example content pairs.
How to use this skill
Bring this guide into your coding agent with a prompt tailored to the tool you use.
- Open your project in Codex.
- Copy and paste the prompt below.
- Review files and risks before approving any action.
Inspect the Agent Skill at https://github.com/manycoretech/aholo-viewer/blob/HEAD/.codex/skills/aholo-site/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/aholo-site, but wait for my approval before writing files or running scripts.
Copying this prompt does not install or run the skill. Review third-party files before use.
Aholo Site
Own the website shell and Playground integration. Do not own renderer source or example content pairs.
Owns
- Astro routes, layouts, flat feature components, utilities, i18n, and site content under
website/. - Examples page chrome and preview layout, not
website/src/content/examples/*.jsonor*.ts. - Client render runtime under
website/src/client/, camera/control integration, inspector, presets, and URL state. - Playground shell in
website/src/components/PlaygroundShell.astroand browser entry inwebsite/src/client/playground.ts. - Scoped styles:
theme.css,global.css,site.css,home.css,examples.css,docs.css,playground.css.
Boundaries
- Keep Monaco route-local through
website/src/components/PlaygroundShell.astro; keep Playground browser entry inwebsite/src/client/playground.ts. - Preserve Playground URL params:
exampleandcode. - Keep render runtime implementation in
website/src/client/render-runtime.tsand runner contract inwebsite/src/client/render-runtime.d.ts. - Keep renderer type hints sourced from
packages/renderer/dist/index.d.ts. - Keep
website/src/content.config.tsfocused on Astro collections; manual pages are loaded throughwebsite/src/utils/manual.ts. - Keep feature selectors out of
global.css. - Do not modify renderer public exports.
- Do not hand-edit
website/.generated/api/. - Use
aholo-examplesfor example JSON/TS source pairs.
Design
- Keep the site simple, refined, spacious, and tool-like.
- Keep homepage first-screen interactive renderer true fullscreen and resize the renderer after entering or exiting.
Validate
pnpm.cmd check:website
Use pnpm.cmd check when renderer declarations or package output are involved.