agent-isles-render

Use this skill when the user wants to render, preview, watch, or smoke-test an Agent Isles Markdown document.

Workflow

1. Confirm the source Markdown path exists.
2. Prefer the project's installed CLI:
   • npm: npm exec -- isles render <file.md> --out <file.html> --assets local
   • pnpm: pnpm exec isles render <file.md> --out <file.html> --assets local
   • yarn: yarn exec isles render <file.md> --out <file.html> --assets local
3. If Agent Isles is not installed yet, use agent-isles-install-update first or run a one-shot command such as:

   npx agent-isles@next render <file.md> --out <file.html> --assets local
   

4. Verify the output file exists and contains:
   • the Agent Isles theme reference,
   • the Agent Isles component bundle reference,
   • the expected body text or custom element from the source document.
5. For live editing, use:

   isles watch <file.md> --out <file.html>
   

Rendering guidance

• Use --assets local for durable review artifacts or offline environments.
• Use --mode sanitized when rendering untrusted or mixed-trust Markdown.
• Keep generated HTML as an artifact; make source changes in Markdown.