feat: interactive onboarding skill (agrx setup/onboard)

[kasperjunge]

Summary

Create an interactive onboarding skill that helps users bootstrap a personalized set of skills for their project. Run via agrx setup -i (or agrx onboard -i).

Motivation

From community feedback (CSI): users need guidance on which skills to install and how to customize them for their specific tech stack, conventions, and workflow. A static catalog doesn't work because "one size doesn't fit all" — everyone has their own coding practices, test conventions, commit/PR workflows, etc.

Proposed approach

A skill hosted at computerlovetech/skills/setup (or onboard) that:

1. Detects context — reads pyproject.toml, package.json, .github/, etc. to infer tech stack
2. Asks questions — commit conventions? PR workflow? test framework? deployment target?
3. Recommends skills — from a curated list + popular skills.sh skills, ranked by relevance
4. Lets user pick — presents options, user selects
5. Installs — runs agr add <handles> for remote skills, or generates custom local skills in skills/ for personalized conventions
6. Done — user has a tailored agr.toml and skill set

Skill structure

setup/
├── SKILL.md              # Main orchestration instructions
└── references/
    ├── popular-skills.md  # Curated list of proven skills by category
    ├── templates/
    │   ├── commit.md      # Template for commit convention skill
    │   ├── review.md      # Template for PR review skill
    │   └── testing.md     # Template for testing skill
    └── questions.md       # Interview questions by tech stack

Integration with skills.sh

The curated popular-skills.md can reference top skills from skills.sh (Vercel's agent skills directory, 91K+ skills). Since skills.sh uses the same SKILL.md format and GitHub handle convention, these skills work with agr add today.

Security model

• Templates come from a curated repo (no prompt injection risk)
• AI customization happens locally in the user's session
• Generated skills are local files the user can review before committing
• agr.lock pins exact commits for reproducibility

Prerequisites

• default_owner support in handle resolution (enables agrx setup -i instead of agrx computerlovetech/setup -i)

Usage

# With default_owner (new feature):
agrx setup -i

# Or explicitly:
agrx computerlovetech/setup -i

🤖 Generated with Claude Code