development

Configure local development startup, stable origins, and Portless proxy integration for Node.js applications.

Updated Sep 7, 2026
One-click install
npx skills add https://github.com/raphaelmans/spectralpointengineering --skill development-raphaelmans
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: development
Source: https://github.com/raphaelmans/spectralpointengineering/tree/main/.skillshare/skills/development
Command: npx skills add https://github.com/raphaelmans/spectralpointengineering --skill development-raphaelmans

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Setting up consistent local development environments across Next.js, Express, Hono, and other Node.js servers is error-prone, especially when managing stable origins, concurrent git worktrees, and proxy routing. This Skill standardizes that setup and also maintains a navigation-only ARCHITECTURE.md index so agents and developers can find authoritative guidance quickly. ## Core Features & Use Cases - Architecture Index Initialization: Creates or refreshes a root ARCHITECTURE.md that indexes installed skill routers and authoritative references with task triggers and prerequisites, plus a minimal AGENTS.md entrypoint pointer. - Local Startup Configuration: Installs and wires Portless for Next.js, Express, Hono, and other Node.js HTTP servers, mapping resolved origins into existing application environment variables without polluting application code. - Worktree and Concurrency Support: Ensures concurrent checkouts get distinct origins, verifies two simultaneous instances, and preserves direct startup without proxy dependencies. - Use Case: In a Turborepo monorepo with a Next.js frontend and an Express API, run setup once to get stable named URLs for both apps in every worktree, with callbacks and cookies verified against the actual checkout origin. ## Quick Start Ask the agent to set up local development for your Next.js and Express apps with stable origins using the development skill.

Frequently Asked Questions about development

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

FAQPage Schema
How do I set up Portless with a Next.js app?

Portless setup for Next.js maps the tool-resolved origin into your existing application-origin environment variable before launching the dev server. Application code and schemas stay unaware of the proxy, and a direct next dev command is preserved alongside the wrapped script.

How to run multiple git worktrees with distinct local origins?

Each checkout receives its own resolved identity so concurrent worktrees get distinct origins without collisions. The setup verifies two simultaneous instances, confirming each app's configured origin and callback destinations match its own checkout.

Does this work with Express and Hono servers?

Yes, Express, Hono on Node.js, and other Node.js HTTP servers are supported through the Node.js mapping. It traces the actual listener to prove the assigned port reaches the listen call, since environment injection alone does not configure a hardcoded listener.

Can I use this in a Turborepo monorepo?

Yes, Turborepo workspaces are supported by keeping task ownership inside package scripts and retaining the existing root orchestrator. Development tasks stay non-cached with long-running lifecycles, and environment filtering is resolved where values are actually injected.

What are the limitations of this development setup skill?

Production deployment is explicitly out of scope, and the skill does not author missing convention documents or install unrelated skills. It also avoids creating sample applications just to claim verification, reporting anything that could not be exercised.

Why does my auth callback fail on a local proxy hostname?

A working local hostname does not prove the authentication provider accepts it, since providers enforce their own callback URL registrations. The setup checks provider callback restrictions, cookie scope, and trusted-origin behavior against the actual resolved origin.