# Canonical Root Marketplace Path Normalization

> Normalize relative extension source paths against a canonical repo root so shared marketplace records stay stable across worktrees.

- **Type:** Skill
- **Install:** `agentstack add skill-ychampion-cskill-agents-canonical-root-marketplace-path-normalization`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [ychampion](https://agentstack.voostack.com/s/ychampion)
- **Installs:** 0
- **Category:** [Agent Skills](https://agentstack.voostack.com/c/agent-skills)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [ychampion](https://github.com/ychampion)
- **Source:** https://github.com/ychampion/cskill-agents/tree/main/agents/claude-code/skills/canonical-root-marketplace-path-normalization
- **Website:** https://x.com/YashasGunderia/status/2039990540016693692?s=20

## Install

```sh
agentstack add skill-ychampion-cskill-agents-canonical-root-marketplace-path-normalization
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# SKILL: Canonical-Root Marketplace Path Normalization
**Domain:** extensions-mcp
**Trigger:** Use when project settings declare relative extension paths but the shared registry spans multiple worktrees or checkouts.
**Source Pattern:** Distilled from reviewed shared-registry path normalization logic.

## Core Method
Resolve relative local source paths against the repository's canonical root rather than the current worktree directory before comparing them to shared registry entries. This produces one stable identity for a shared record, prevents worktrees from overwriting each other with checkout-specific paths, and avoids dead paths when temporary worktrees disappear. Normalize before diffing so equivalent repo-relative settings are treated as the same source.

## Key Rules
- Normalize shared local paths against the canonical repo root, not the active worktree.
- Run normalization before diff comparison so equivalent sources do not look like drift.
- Preserve a valid existing entry when a transient worktree path is missing but the canonical source is still the same.

## Example Application
If a repo declares `./plugins/internal`, normalize it against the canonical checkout root so every worktree resolves to the same shared registry path.

## Anti-Patterns (What NOT to do)
- Do not stamp worktree-specific absolute paths into a user-global registry.
- Do not treat equivalent repo-relative paths as true source changes.
- Do not overwrite a valid shared entry with a dead temporary path.

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [ychampion](https://github.com/ychampion)
- **Source:** [ychampion/cskill-agents](https://github.com/ychampion/cskill-agents)
- **License:** MIT
- **Homepage:** https://x.com/YashasGunderia/status/2039990540016693692?s=20

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-ychampion-cskill-agents-canonical-root-marketplace-path-normalization
- Seller: https://agentstack.voostack.com/s/ychampion
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.