skills.rest
FernanSuoza
FernanSuozaCOMMUNITY
Explore all skills by this author →
GitHub

core-onboarding

Reconciles bootstrap config with project runtime state and generates onboarding report.

Updated Mar 22, 2026
Search Tags:#onboarding#setup#execution-plan#project-state#tool-detection#bootstrap-config#onboarding-report
One-click install
npx skills add https://github.com/FernanSuoza/AIDD-project-bootstrap --skill core-onboarding
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: core-onboarding
Source: https://github.com/FernanSuoza/AIDD-project-bootstrap/tree/main/templates/skills/core-onboarding
Command: npx skills add https://github.com/FernanSuoza/AIDD-project-bootstrap --skill core-onboarding

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

New users of a generated AI-assisted project often face ambiguity about where to start, which environment and editor to use, and which configuration choices were made during bootstrap. This Skill centralizes setup discovery, prevents redundant questions by reading on-disk bootstrap artifacts, and produces a durable onboarding report that captures decisions and next steps.

Core Features & Use Cases

  • Bootstrap reconciliation: Reads .aidd/bootstrap-config.json and execution-plan artifacts to reconcile declared preferences with runtime state and silently apply authoritative bootstrap values where required.
  • Tool and environment assessment: Detects local tooling availability, maps it to recommended environment/editor paths, and surfaces explicit installation steps and trade-offs when alternatives exist.
  • Guided decisioning and state updates: Presents one clear recommended path with progressive disclosure of alternatives, updates execution-plan/project-state.yaml (next_action), and enforces human review gates for documentation.
  • Durable reporting: Renders a consistent onboarding report (execution-plan/reports/onboarding/onboarding-report.md) from a template, acknowledges provenance of fields, and points to the single next AI-driven command.

Quick Start

Run the core-onboarding skill to reconcile bootstrap state, check local tool readiness, and generate execution-plan/reports/onboarding/onboarding-report.md.

Frequently Asked Questions about core-onboarding

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

FAQPage Schema
How do I generate an onboarding plan for an AI-assisted project?▼

An onboarding assessment reconciles your bootstrap-config.json with runtime project state, detects installed tools, and writes a durable onboarding report capturing setup decisions and explicit next steps.

How does bootstrap configuration reconciliation work during project setup?▼

Bootstrap reconciliation reads .aidd/bootstrap-config.json and execution-plan artifacts to align declared preferences with the actual runtime state, silently applying authoritative bootstrap values where required without prompting for existing fields.

Do I need to manually input environment preferences if I already have a bootstrap-config.json file?▼

No manual input is needed if bootstrap-config.json exists. The process reads on-disk artifacts directly, extracts provenance fields, and prevents redundant setup questions by silently applying authoritative bootstrap values.

What's the best way to detect local tooling availability and choose an editor path?▼

Run an onboarding assessment that detects installed local tools, maps them to recommended environment and editor paths, and surfaces explicit installation steps with trade-offs when alternative options exist.

Can I update project-state.yaml automatically during the project onboarding process?▼

Yes, the onboarding process updates execution-plan/project-state.yaml automatically with the next_action field, enforces human review gates for documentation, and presents one clear recommended path with progressive disclosure of alternatives.

Why does my project setup still show missing tool dependencies after bootstrap?▼

Missing dependencies occur when local tooling detection finds unavailable tools during setup, which the onboarding report captures by surfacing explicit installation steps and environment trade-offs.

Related Skills

Explore More Product & Management Skills→
lubusINlubusIN
48

frappe-project-triage

Identify Frappe project type, installed apps, version, and tooling.

Official
Intermediate
davidmatousekdavidmatousek
86

~aod-blueprint

Bootstrap projects and generate GitHub issues via YAML-driven workflows.

Community
Advanced
romiluz13romiluz13
161

build-workflow

Automate software feature builds with TDD and subagent orchestration.

Community
Intermediate
89jobrien89jobrien
4

developer-experience

Automate developer environment setup, dependency installation, and code quality checks.

Community
Intermediate