defprod-onboard-repo

Discovers repository packages and proposes a product-to-package mapping for DefProd onboarding.

Updated Apr 4, 2026
One-click install
npx skills add https://github.com/defprod1/defprod-skills --skill defprod-onboard-repo-defprod1
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: defprod-onboard-repo
Source: https://github.com/defprod1/defprod-skills/tree/main/skills/defprod-onboard-repo
Command: npx skills add https://github.com/defprod1/defprod-skills --skill defprod-onboard-repo-defprod1

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Onboarding an existing repository into DefProd requires manually inventorying every app and library, deciding which packages map to which products, and documenting that mapping — a slow, error-prone process especially in monorepos. ## Core Features & Use Cases - Automatic package discovery: Scans workspace configurations (Nx, pnpm, Turborepo, Lerna, Rush, Angular) or falls back to manifest scanning to enumerate every app and library, classifying each with heuristics. - Product mapping proposal: Generates human-readable product candidates from discovered apps, supports single, partial, and multiple mapping types, and captures include/exclude glob paths for partial mappings. - DefProd sync and documentation: Syncs discovered packages and confirmed products to the DefProd MCP server and writes a structured onboarding document to docs/defprod-onboarding.md that drives per-product definition. - Use Case: Point the skill at a monorepo containing a customer portal, an admin API, and shared libraries; it inventories everything, proposes two products, and writes the confirmed onboarding document after your review. ## Quick Start Run /defprod-onboard-repo from the root of your repository and confirm the proposed product mapping when prompted.

Frequently Asked Questions about defprod-onboard-repo

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

FAQPage Schema
How do I onboard a monorepo into DefProd?

Run /defprod-onboard-repo from the repository root. It scans workspace configuration files to discover all apps and libraries, proposes a product-to-package mapping for your review, and writes the confirmed mapping to docs/defprod-onboarding.md.

How do I map one package to multiple products?

Use a partial mapping during the review step. The skill asks you to specify include and exclude glob patterns, such as apps/web/src/app/admin/**, so each product covers only the directories that belong to it.

Does defprod-onboard-repo work with single-app repositories?

Yes, single-app repositories are fully supported. The skill detects a root package.json or equivalent manifest with start or dev scripts, classifies it as one app, and presents a simplified single-product proposal.

Which workspace tools does repository discovery support?

Discovery reads Nx, pnpm workspaces, Turborepo, npm/yarn workspaces, Lerna, Rush, and Angular CLI configurations. If none exist, it falls back to scanning directories for package manifests like package.json, pyproject.toml, Cargo.toml, or go.mod.

Does this skill create DefProd products automatically?

No, this skill never creates products. It only discovers packages, proposes the mapping, and writes the onboarding document. Product creation happens afterward by running /defprod-onboard-product for each confirmed product.