vc-setup

Scaffolds and populates an agent development harness for new or existing projects.

2|Updated Sep 15, 2025
One-click install
npx skills add https://github.com/marsley01/Marsley-Portfolio-Web --skill vc-setup-marsley01
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: vc-setup
Source: https://github.com/marsley01/Marsley-Portfolio-Web/tree/main/.agents/skills/vc-setup
Command: npx skills add https://github.com/marsley01/Marsley-Portfolio-Web --skill vc-setup-marsley01

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Setting up a consistent agent development harness across projects is tedious and error-prone, especially when a repository already has partial process directories, stale context files, or legacy layouts that must be preserved rather than overwritten. ## Core Features & Use Cases - Interactive Detection and Classification: Detects the project manifest (package.json, pyproject.toml, go.mod, Gemfile, Cargo.toml), package manager, framework, test runners, and monorepo structure, then classifies the repo as a new or existing project. - Approval-Gated Scaffolding: Creates the process/ directory tree from seed templates, migrates legacy layouts (plans/, reports/, skills/ dirs) with safe-inference rules, and never moves or overwrites files without user confirmation. - Deep Codebase Study: Runs parallel subagents to scan architecture, tests, context groups, and feature areas, then populates all-context.md and all-tests.md with real content instead of placeholders. - Use Case: You clone a repository that has a half-configured process/ directory from an old harness version. Run this Skill to study what exists, approve a migration plan, and end with fully populated, validated context files. ## Quick Start Ask the agent to run vc-setup to detect this project's stack and set up the agent harness, answering its questions as it goes.

Frequently Asked Questions about vc-setup

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

FAQPage Schema
How do I set up an agent harness in an existing project?

Run vc-setup and it classifies the repo as an existing project, reads all current process/ and context files, then presents findings grouped as good, improvable, missing, and layout changes. Nothing is moved or overwritten until you approve each category.

What project types does vc-setup support?

It detects package.json for Node/Bun/Deno, pyproject.toml or requirements.txt for Python, go.mod for Go, Gemfile for Ruby, and Cargo.toml for Rust. If no manifest is found, it asks what runtime the project uses and adapts.

Will vc-setup overwrite my existing context files?

No. In Merge and Refresh modes it never overwrites existing user content; it fills gaps, updates stale sections, and renames migrated files with a -migrated suffix on collision. Every planned change is shown for approval first.

How does vc-setup handle legacy process directory layouts?

It detects orphaned dirs like process/plans/, process/reports/, and feature-level reports/ or references/ folders, then migrates artifacts into task folders only when exactly one destination can be safely inferred. Ambiguous artifacts are left in place and listed for manual review.

Why does validation report missing context group directories?

The context discovery validator warns about groups like uxui/ when the project has no substantial content for that domain. This is expected on fresh projects; create a group only when real content exists for it.