setup

Configure onboarding.yaml and validate portfolio layout for ApexYard forks.

489|254|Updated Apr 5, 2026
One-click install
npx skills add https://github.com/me2resh/apexyard --skill setup-me2resh
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: setup
Source: https://github.com/me2resh/apexyard/tree/main/.claude/skills/setup
Command: npx skills add https://github.com/me2resh/apexyard --skill setup-me2resh

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

ApexYard adopters need a fast, reliable way to turn a fresh fork into a working configuration without running through many sequential questions or getting stuck in placeholder defaults.

Core Features & Use Cases

  • First-run bootstrap: Configures onboarding.yaml from operator input using a concise describe → propose → confirm flow.
  • Single-fork or split-portfolio v2 setup: Supports default single-fork mode or guides split-portfolio v2 layout when private projects require it.
  • Guardrails and idempotence: Refuses when jq is missing, writes an active-bootstrap marker to avoid ticket-gate deadlocks, validates the resulting portfolio layout, and supports --reset and --enable-lsp flows.

Quick Start

Run /setup and answer the prompts to generate onboarding.yaml and configure your fork for either single-fork or split-portfolio v2 mode.

Frequently Asked Questions about setup

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

FAQPage Schema
How do I bootstrap an ApexYard fork for SDLC operations?▼

To bootstrap an ApexYard fork, run the setup process to configure onboarding.yaml using a describe, propose, and confirm flow, validating your portfolio layout for productive SDLC operations.

What is split-portfolio v2 adoption and when do I need it?▼

Split-portfolio v2 adoption is a setup mode for ApexYard forks required when you need to configure private project registries, guiding a layout separate from the default single-fork mode.

Do I need jq installed for ApexYard onboarding configuration?▼

Yes, you need jq installed for ApexYard onboarding configuration, as the setup process enforces required tooling and refuses to run if jq is missing from your environment.

How do I reset my onboarding.yaml configuration safely?▼

You can safely reset your onboarding.yaml configuration using the idempotent --reset option, allowing safe re-entry into the ApexYard fork bootstrap process without breaking existing ticket-gate markers.

Can I enable LSP during portfolio setup?▼

Yes, you can enable LSP during portfolio setup by passing the --enable-lsp option, which configures Language Server Protocol support as part of your ApexYard fork bootstrap operations.

Why does my portfolio validation fail after writing onboarding.yaml?▼

Portfolio validation may fail after writing onboarding.yaml if your fork layout does not pass portfolio_validate correctness checks, which ensure required ops-fork markers and configuration blocks are correctly written.