run-oikos

Bootstrap and validate a local Oikos Futari Next.js 16 development environment.

1|1|Updated May 2, 2026

Search Tags:#automation #devops #dev server #next.js #smoke tests #bootstrap #node

Ready to run

npx skills add https://github.com/redtear1115/oikos --skill run-oikos

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: run-oikos
Source: https://github.com/redtear1115/oikos/tree/main/.claude/skills/run-oikos
Command: npx skills add https://github.com/redtear1115/oikos --skill run-oikos

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Bootstrap and validate a local Oikos Futari development environment by starting the Next.js 16 dev server and ensuring it serves the core routes.

Core Features & Use Cases

Idempotent driver for local dev: bootstraps dependencies, starts Next.js, and reuses an already-running server when possible.
Lightweight smoke tests: verifies key routes (/ , /zh-TW, /dashboard) to catch common startup issues.
Prerequisite validation and recovery: checks Node version, env.local presence, and auto-installs missing dependencies when needed.

Quick Start

Run the smoke driver to bootstrap the Oikos repo, install dependencies, start the Next.js dev server, and perform smoke checks on core routes.

Frequently Asked Questions about run-oikos

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

FAQPage Schema

How do I bootstrap a Next.js dev server and run smoke tests automatically?▼

Use an idempotent dev server bootstrap driver to validate prerequisites like Node >= 20 and .env.local, auto-install missing dependencies, start the Next.js server, and run lightweight route checks to confirm readiness.

Why does my Next.js dev server fail to start after a fresh checkout?▼

Your Next.js dev server may fail after a fresh checkout due to missing .env.local files, broken dependencies, or an invalid Node version. A bootstrap driver detects these common startup issues by enforcing prerequisites and auto-installing missing dependencies.

What prerequisites do I need to run a local Next.js development environment?▼

To run a local Next.js development environment, you need Node version 20 or higher and a present .env.local file. The bootstrap process enforces these prerequisites and will auto-install any missing project dependencies before starting the server.

Can I reuse an already running Next.js dev server instead of starting a new one?▼

Yes, you can reuse an already running Next.js dev server. An idempotent local dev driver detects an existing running server instance and avoids starting a duplicate, ensuring port availability and skipping unnecessary dependency installations.

How do I validate that my Next.js core routes are serving correctly?▼

To validate that Next.js core routes are serving correctly, perform lightweight smoke tests against key routes such as / , /zh-TW, and /dashboard. This catches common startup issues and confirms the development environment readiness after bootstrapping.