shadow-and-record

Refresh external state snapshots and maintain a ledger of intentional deviations.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/marvelousempire/ai-skills-library --skill shadow-and-record
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: shadow-and-record
Source: https://github.com/marvelousempire/ai-skills-library/tree/main/skills/methodology/shadow-and-record
Command: npx skills add https://github.com/marvelousempire/ai-skills-library --skill shadow-and-record

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

The Shadow And Record skill addresses the challenge of tracking relationships to external, uncontrolled things, ensuring both current awareness and persistent intent are maintained.

Core Features & Use Cases

  • Live Shadow: Automatically refreshes a snapshot of the external thing's state.
  • Curated Record: Manages a human-readable ledger of deviations.
  • Use Case: When tracking changes in a forked repository, this skill ensures both the current state and intentional deviations are documented and accessible.

Quick Start

Invoke the Shadow And Record skill to track changes in a specific external resource, such as a repository or API.

Frequently Asked Questions about shadow-and-record

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

FAQPage Schema
How do I track intentional deviations from an external repository while maintaining current state awareness?

To track intentional deviations and maintain current state awareness, use a system that automatically refreshes snapshots of the external source while maintaining a human-readable ledger of your specific changes. This ensures both live tracking and persisted intent are documented.

What is external dependency tracking for version control?

External dependency tracking is the process of monitoring uncontrolled external sources by shadowing their live state and recording intentional deviations. It ensures you maintain both current awareness of the external resource and a persistent record of your local modifications.

How do I document intentional deviations in a forked repository?

You document intentional deviations in a forked repository by maintaining a human-readable ledger alongside an automatically refreshed snapshot of the upstream state. This records exactly what changes were made intentionally while keeping the external baseline updated.

Do I need scheduled jobs for continuous change tracking of external resources?

Yes, continuous change tracking requires scheduled jobs to automatically refresh the snapshot of the external thing's state. You also need human-maintained records to document the intentional deviations from that external source.

What is the best way to manage uncontrolled external dependencies in version control?

The best way to manage uncontrolled external dependencies is to apply a unified tracking system that separates live shadowing from curated records. This approach automatically refreshes external state snapshots while documenting your intentional deviations in a human-readable ledger.

When should I not use automated shadowing for change tracking?

You should not rely solely on automated shadowing for change tracking when intentional deviations are involved. Because deviations require context, human-maintained records are necessary to document the specific intent behind straying from the external source.