Skip to content

Rough starting point for environment specialization #22

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
joelgwebber wants to merge 1 commit into
base: main
Choose a base branch
from
+4 −2
Open

Rough starting point for environment specialization #22

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion skills/live/SKILL.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -9,7 +9,7 @@ metadata:
# Live Browser

> **PREREQUISITE:** Read `subtext:shared` for MCP conventions and sightmap upload.
> **ENVIRONMENT:** If a `subtext-environment` skill is available in the host project, read it before connecting — it specifies which MCP server prefix to use for live tools.
> **ENVIRONMENT:** If a `subtext-environment` skill is available in the host project, read it before connecting — it specifies which MCP server prefix to use for live tools, plus host-specific gotchas (local-app login/auth, patterns for testing locally-built code through subtext tools, screenshot strategy nuances, and similar).

API catalog for live browser tools (all prefixed `live-`) on the unified subtext MCP server. These tools let you open browser connections, navigate views, interact with elements, and inspect console/network activity.

Expand Down
1 change: 1 addition & 0 deletions skills/recipe-reproduce-from-session/SKILL.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -9,6 +9,7 @@ metadata:
# Recipe: Reproduce from Session

> **PREREQUISITE:** Read `subtext:shared`, `subtext:session`, `subtext:live`, `subtext:sightmap`, and `subtext:tunnel`.
> **ENVIRONMENT:** If a `subtext-environment` skill is available in the host project, read it — it documents MCP prefix selection and host-specific gotchas (local-app login/auth, patterns for testing locally-built code through subtext tools, screenshot strategy, and similar).

## Steps

Expand Down
1 change: 1 addition & 0 deletions skills/reproduce-workflow/SKILL.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -9,6 +9,7 @@ metadata:
# Reproduce

> **PREREQUISITE:** Read `subtext:shared`, `subtext:session`, `subtext:live`, `subtext:sightmap`, and `subtext:tunnel` for MCP conventions and tools.
> **ENVIRONMENT:** If a `subtext-environment` skill is available in the host project, read it — it documents MCP prefix selection and host-specific gotchas (local-app login/auth, patterns for testing locally-built code through subtext tools, screenshot strategy, and similar).

Drive the local app through live browser MCP tools to reproduce a user flow. When you encounter sightmap gaps, write back so the next run is better.

Expand Down
2 changes: 1 addition & 1 deletion skills/tunnel/SKILL.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -8,7 +8,7 @@ metadata:

# Tunnel Setup for Hosted Browser

> **ENVIRONMENT:** If a `subtext-environment` skill is available in the host project, read it before connecting — it specifies which MCP server prefix to use for live and tunnel tools.
> **ENVIRONMENT:** If a `subtext-environment` skill is available in the host project, read it before connecting — it specifies which MCP server prefix to use for live and tunnel tools, plus host-specific gotchas (local-app login/auth, patterns for testing locally-built code through subtext tools, and similar).

When the hosted browser needs to load a page from the user's local dev server (e.g. `http://localhost:3000`), a reverse tunnel is required. The hosted browser cannot reach localhost directly — the tunnel proxies requests from the hosted infrastructure back to the user's machine.

Expand Down