onboard

Guides a consent-gated first session that configures marvin in the current repository.

Updated Apr 16, 2026
One-click install
npx skills add https://github.com/real-case/marvin-toolkit --skill onboard-real-case
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: onboard
Source: https://github.com/real-case/marvin-toolkit/tree/main/plugins/marvin/skills/onboard
Command: npx skills add https://github.com/real-case/marvin-toolkit --skill onboard-real-case

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Setting up a new development toolkit in an existing project is often confusing: users do not know what the tool writes locally, what data it logs, or where to start. This Skill runs a structured, seven-step first session that discloses local usage logging before anything is written, proposes real starter tasks found in the actual codebase, and never writes anything without an explicit yes. ## Core Features & Use Cases - Transparent disclosure: Explains the local usage log at .marvin/usage/events.jsonl, what it contains, and offers an opt-out that edits .marvin/config.json only after showing the exact lines to be written. - Repository-aware starter tasks: Scans source, manifests, and documentation for genuine candidates (missing tests, stale README claims, dated TODOs, outdated dependencies) with file:line evidence. - Delegated side effects: Creates at most one task board card via /marvin:track-new and one commit via /marvin:commit, each behind explicit consent, with no branches or pushes. - Use Case: A developer just installed the marvin plugin and types "walk me through marvin" — the Skill reads the repo, discloses logging, proposes three real tasks, and ends with one concrete next command. ## Quick Start Ask the assistant to walk you through marvin in this project, for example by saying "I just installed marvin, set it up here".

Frequently Asked Questions about onboard

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

FAQPage Schema
How do I set up the marvin plugin in my project?▼

Run the onboard walkthrough by saying "set marvin up in this project" or invoking /marvin:onboard. It reads your repository, discloses local logging, proposes starter tasks, and optionally creates a task card and commit, each behind an explicit yes.

What data does marvin log locally and how do I opt out?▼

Marvin appends one line per prompt and tool call to .marvin/usage/events.jsonl containing only timestamp, kind, and name. The onboard walkthrough offers an opt-out that sets usage.enabled to false in .marvin/config.json after showing you the exact lines first.

Does the onboarding walkthrough create branches or push commits?▼

No. The walkthrough never runs git checkout -b, git switch -c, or git push. Any commit it offers is made on the currently checked-out branch through the marvin commit skill, which handles staging and sensitive-file screening.

What happens if I decline every step of the onboarding?▼

Declining any step simply continues the walkthrough at the next step, and nothing is written. Ending with no files created under .marvin/ is the expected result of declining every gate, not a failure.

How does onboarding find starter tasks in my repository?▼

It scans source files, manifests, and documentation for genuine candidates such as modules without tests, README claims contradicted by the tree, dated TODO or FIXME comments, and unpinned or outdated dependencies, each reported with file:line evidence.