adapt-to-project

Guide post-install adaptation of installed skill packs into adopter repositories.

15|5|Updated May 4, 2026
One-click install
npx skills add https://github.com/eugenelim/agent-ready-repo --skill adapt-to-project
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: adapt-to-project
Source: https://github.com/eugenelim/agent-ready-repo/tree/main/.agents/skills/adapt-to-project
Command: npx skills add https://github.com/eugenelim/agent-ready-repo --skill adapt-to-project

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes assets (resource) components.

What problem does it solve?

This Skill helps you adapt an installed pack to the realities of an existing repository instead of leaving placeholder guidance, partial merges, or inconsistent layout behind.

Core Features & Use Cases

  • Walks through substitution markers, companion-file merges, discovery-driven restructuring, and within-layout consolidation.
  • Handles both repo scope and user scope, including install markers, state files, dirty-state checks, and pending-work cleanup.
  • Useful after installing a pack, when a project already has local conventions, or when the session-start hook signals that post-install adaptation is needed.

Quick Start

Ask the skill to guide you through adapting the newly installed pack to your repository and resolve the post-install changes one by one.

Frequently Asked Questions about adapt-to-project

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

FAQPage Schema
How do I adapt an installed skill pack to match my existing repository conventions?

To adapt an installed skill pack, you guide post-install adaptation by substituting placeholders, merging companion files, and restructuring layouts to align with repository conventions. This resolves partial merges and ensures consistent project architecture.

What is discovery-driven restructuring for post-install pack adaptation?

Discovery-driven restructuring is a post-install adaptation process that analyzes repository and user scopes to consolidate layouts and reconcile companion files. It ensures installed packs integrate cleanly without leaving inconsistent structural artifacts behind.

How do I resolve placeholder markers and dirty-state issues after a pack installation?

Resolving placeholder markers and dirty-state issues requires consuming install markers and escalating dirty-state checks during post-install adaptation. This generates idempotent pending-state files to safely track and clean up incomplete work.

Can I use post-install adaptation for both repository scope and user scope file writes?

Yes, post-install adaptation handles both repository and user scopes through scope-aware file writes. It enforces safety checks that preserve per-scope path jails, ensuring modifications remain correctly isolated during companion-file reconciliation.

What are the limitations of layout consolidation when restructuring an installed pack?

Layout consolidation is constrained by safety checks that preserve per-scope path jails, preventing writes outside authorized boundaries. It relies on marker consumption and dirty-state escalation, meaning unresolved pending states can block adaptation steps.

When do I need post-install adaptation for file merging in my project?

You need post-install adaptation for file merging when a session-start hook signals pending changes or when a newly installed pack leaves partial merges. It reconciles companion files and substitutes placeholders to match existing local conventions.