check-cross-refs

Validate schema cross-references against existing workspace entities.

1|Updated Apr 20, 2026
One-click install
npx skills add https://github.com/Largo2z9/phantomos --skill check-cross-refs
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: check-cross-refs
Source: https://github.com/Largo2z9/phantomos/tree/main/.skills/skills/check-cross-refs
Command: npx skills add https://github.com/Largo2z9/phantomos --skill check-cross-refs

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill prevents broken workspace extensions by checking whether declared schema cross-references point to existing core entities before scaffolding continues.

Core Features & Use Cases

  • Cross-Reference Validation: Parses declared cross_refs and verifies that referenced entities such as products, audiences, and offers exist in the active workspace.
  • Resolution Reporting: Distinguishes successful resolutions, warnings for missing future entities, and blocking issues caused by invalid path patterns.
  • Use Case: When extending a brand workspace with a new schema, use this Skill to detect unresolved entity references before the extension is created.

Quick Start

Ask the agent to check cross-refs in the proposed schema and report any unresolved references.

Frequently Asked Questions about check-cross-refs

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

FAQPage Schema
How do I validate schema cross-references before scaffolding a workspace extension?

Schema cross-reference validation checks whether declared cross_refs point to existing core entities like products, audiences, and offers in the active workspace. This resolves targets and reports outcomes, preventing broken workspace extensions before scaffolding continues.

Why do my workspace extension schemas fail to resolve referenced brand entities?

Schemas fail to resolve referenced brand entities when cross_refs point to invalid path patterns or non-existent core entities. Validation reports distinguish blocking issues caused by invalid paths from warnings for missing future entities.

How do I check for unresolved entity references in a draft schema?

To check for unresolved entity references, ask the agent to parse declared cross_refs in the draft schema and verify referenced products, audiences, or offers exist in the active workspace. The skill reports successful resolutions and blocking issues.

What's the best way to prevent broken workspace extensions when adding new brand schemas?

The best way to prevent broken workspace extensions is to validate schema cross-references against existing workspace brand data before the extension is created. This detects unresolved entity references early in the brand workspace extension workflow.

Do I need existing workspace brand data to validate schema cross-references?

Yes, you need access to existing workspace brand data and draft schemas containing cross_refs fields. The validation process resolves cross-references against core entities already present in the active workspace to report accurate outcomes.

What happens when a schema cross-reference points to a missing future entity?

When a schema cross-reference points to a missing future entity, the validation process generates a warning rather than a blocking issue. This distinguishes non-critical unresolved references from invalid path patterns that halt scaffolding.