roam-load-extension

Build, deploy, and verify local Roam Research extensions in Playwright.

44|7|Updated Oct 16, 2024
One-click install
npx skills add https://github.com/DiscourseGraphs/discourse-graph --skill roam-load-extension
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: roam-load-extension
Source: https://github.com/DiscourseGraphs/discourse-graph/tree/main/skills/roam-load-extension
Command: npx skills add https://github.com/DiscourseGraphs/discourse-graph --skill roam-load-extension

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill eliminates the manual friction of building and loading local Discourse Graphs extensions into Roam Research, ensuring a seamless development and verification loop.

Core Features & Use Cases

  • Automated Build & Load: Compiles the apps/roam extension and injects it into Roam Depot developer mode automatically.
  • Verification & Proof: Automatically verifies that commands and settings load correctly and captures visual proof of the extension's active state.
  • Use Case: When developing a new feature for the Discourse Graphs extension, use this skill to instantly deploy your local changes into a live Roam graph to verify functionality without manual browser configuration.

Quick Start

Execute the roam-load-extension skill to build and load the local extension into the first Roam test account slot.

Frequently Asked Questions about roam-load-extension

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I automate loading a local Roam Research extension into a browser for testing?

Automating local Roam Research extension loading requires compiling the extension and injecting it into Roam Depot developer mode via a Playwright-controlled browser environment to streamline verification.

What's the best way to verify Roam Research extension commands without manual browser configuration?

Verifying Roam Research extension commands automatically is handled by injecting the compiled extension into a live Roam graph using Playwright, which validates that commands and settings load correctly.

Do I need a Playwright environment to deploy local Discourse Graphs extensions into Roam?

Yes, a configured Playwright environment is required to deploy local Discourse Graphs extensions, as it manages directory-picker shims and controls the browser for automated artifact generation and injection.

How does automated extension build and load work for Roam Research development?

Automated extension build and load compiles the local apps/roam source directory and injects the artifact into the first Roam test account slot, enabling rapid iteration cycles without manual setup.

Can I capture visual proof of my Roam Research extension's active state during testing?

Capturing visual proof of your extension's active state is supported automatically by the Playwright environment after injecting the build, verifying that commands and settings load correctly.

What limitations exist when using Playwright to manage Roam Research extension deployment?

Limitations include requiring access to the local apps/roam source directory and a pre-configured Playwright environment, meaning this approach is restricted to local Discourse Graphs development workflows.