skills.rest
redtear1115
redtear1115COMMUNITY
Explore all skills by this author →
WebsiteGitHub

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
One-click install
npx skills add https://github.com/redtear1115/oikos --skill run-oikos
Or copy as Structured Prompt for Agent▼
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.

Related Skills

Explore More Software Engineering Skills→
jusjinukjusjinuk
1

onboard

Configure Slack tokens, environment files, and repository hooks for internbot deployment.

Community
Intermediate
donnfelkerdonnfelker

deploy

Orchestrate Kamal deployment workflows with zero-downtime traffic cutover.

Community
Advanced
RazisafirRazisafir
1

implementing-secret-scanning-with-gitleaks

Implement Gitleaks secret scanning in git repositories with pre-commit hooks and CI/CD integration.

Community
Intermediate
thrawnythrawny
2

tmux-dev

Organize dev servers into dedicated tmux windows with CLI commands.

Community
Advanced