resolve-repo

Identifies the best local or remote repository for a task using scoped VPC checks.

1|Updated Mar 3, 2026
One-click install
npx skills add https://github.com/AndreJorgeLopes/devflow --skill resolve-repo
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: resolve-repo
Source: https://github.com/AndreJorgeLopes/devflow/tree/main/skills/resolve-repo
Command: npx skills add https://github.com/AndreJorgeLopes/devflow --skill resolve-repo

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

resolve-repo prevents time-wasting confusion by determining which repository a task belongs to and only cloning when the best match is not already present locally.

Core Features & Use Cases

  • Local-first repository matching: Detects the best candidate by scoring local repo names, ticket signals, and lightweight package metadata before attempting any remote lookup.
  • Scoped remote discovery: Queries only within the relevant VCS group/subgroup derived from local remotes, using repo name and description (no README/source inspection).
  • Safe cloning with confirmation: Produces a ranked outcome and asks for user confirmation before cloning the remote repository into the workspace, including basic setup hints for common project files.

Quick Start

Use resolve-repo in a sub-agent with WORKSPACE_DIR, TICKET_ID, TICKET_TITLE, TICKET_DESCRIPTION, and TICKET_LABELS to get the most likely repository match and a ready-to-clone plan if the top candidate is remote.

Frequently Asked Questions about resolve-repo

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

FAQPage Schema
How do I find the right git repository for a specific ticket without cloning unnecessary repos?

To find the right git repository, this skill scores local repo names and ticket signals against lightweight metadata first. It only queries the remote VCS platform within a derived group scope if no local match is found, minimizing context bloat.

How does matching a ticket ID to a local git workspace work?

Ticket matching works by scoring local repo names, ticket IDs, titles, descriptions, and labels against lightweight package metadata. This local-first repository matching prevents time-wasting confusion by identifying the correct codebase before any remote lookup.

Can I scope remote VCS discovery to a specific group instead of searching the whole platform?

Yes, remote discovery is scoped to only the relevant VCS group or subgroup derived from local remotes. It queries using repo name and description without inspecting README files or source code, ensuring fast and lightweight repository resolution.

Does safe cloning require user confirmation before adding a remote repo to the workspace?

Yes, safe cloning requires user confirmation. The skill produces a ranked outcome of remote candidates and asks for explicit confirmation before cloning into the workspace, including basic setup hints for common project files.

What ticket information do I need to provide for scoped repository discovery?

You need to provide the TICKET_ID, TICKET_TITLE, TICKET_DESCRIPTION, and TICKET_LABELS. Passing these parameters to a sub-agent allows the skill to accurately match signals against local repos and rank remote candidates concisely.

When should I avoid using an AI agent for repository resolution?

You should avoid repository resolution via an AI agent if your task lacks clear ticket signals or if you need to inspect README files and source code during discovery, as this skill only queries repo names and descriptions to prevent context bloat.