One-click install
npx skills add https://github.com/johnatas-henrique/overdrive --skill adopt-johnatas-henrique
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: adopt
Source: https://github.com/johnatas-henrique/overdrive/tree/main/.opencode/skills/adopt
Command: npx skills add https://github.com/johnatas-henrique/overdrive --skill adopt-johnatas-henrique

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

When joining an in-progress project or upgrading from an older template version, existing project artifacts (such as GDDs, ADRs, user stories, and infrastructure files) may exist but be in the wrong internal format, causing template skills to fail silently or produce incorrect results. This skill solves that by auditing not just the existence of artifacts, but their format compliance with the template's required structure, and classifying gaps by impact to avoid broken pipeline workflows.

Core Features & Use Cases

  • Multi-artifact format auditing: Checks GDDs, ADRs, system indexes, user stories, infrastructure files, and technical preferences for required sections, valid values, and mandatory fields.
  • Impact-based gap classification: Organizes all found gaps into BLOCKING, HIGH, MEDIUM, and LOW severity tiers so you can prioritize fixes that will break template skills first.
  • Automated migration plan generation: Produces a persistent, checkable numbered migration plan with exact fix commands, manual steps, and time estimates for each gap.
  • Use case: If you are joining a game development project that uses the OpenCode template, run this skill to quickly identify which existing design documents, architecture decisions, and sprint tracking files are formatted correctly for the template's skills, and get a step-by-step plan to fix gaps without disrupting work already in progress.

Quick Start

Run the /adopt skill with no arguments to perform a full audit of all project artifact types and generate a complete prioritized migration plan.

Frequently Asked Questions about adopt

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

FAQPage Schema
How do I audit existing project artifacts for template compliance in brownfield onboarding?

Brownfield onboarding audits check existing project artifacts for internal format compliance, validating required sections, valid values, and mandatory fields rather than just file existence. This identifies incorrectly formatted GDDs, ADRs, and infrastructure files that cause template skills to fail silently.

How do I generate a migration plan for non-compliant OpenCode project files?

Generate a migration plan by auditing non-compliant OpenCode project files to classify format gaps into BLOCKING, HIGH, MEDIUM, and LOW severity tiers. The resulting numbered plan provides exact fix commands, manual steps, and time estimates to resolve issues without disrupting in-progress work.

Does the adopt skill work for game development projects using the OpenCode template?

Yes, the adopt skill is designed for game development projects using the OpenCode template. It validates GDDs, ADRs, system indexes, user stories, infrastructure files, and technical preferences against required sections and mandatory fields to prevent broken pipeline workflows.

Why do template skills fail silently when existing project artifacts are in the wrong format?

Template skills fail silently when existing project artifacts exist but lack the correct internal format, required sections, or mandatory fields. This format mismatch causes template skills to produce incorrect results when processing misaligned GDDs, ADRs, or user stories.

What is the best way to prioritize fixes when upgrading an older OpenCode template version?

The best way to prioritize fixes when upgrading an older OpenCode template version is to use an impact-based gap classification system. This organizes format compliance gaps into BLOCKING, HIGH, MEDIUM, and LOW severity tiers so you can resolve issues that break template skills first.