Cd Repository Discovery

You are tasked with discovering repository and environment context required to build CD Repository filters.

Input Parameters

• Context Folder Path - User-provided folder where you must write the discovery context file.

Primary Goal

Create a machine-readable context file named cd-repository-context.json in the provided folder.

Context File Contract

Write a JSON file with this shape (add additional helpful fields when available):

{
  "generatedAtUtc": "ISO-8601 UTC timestamp",
  "repositoryRoot": "absolute path to git repository root",
  "appPath": "absolute path to Xperience by Kentico app",
  "ciRepositoryPath": "{appPath}/App_Data/CIRepository",
  "cdRepositoryConfigPath": "{appPath}/App_Data/CDRepository/repository.config",
  "tooling": {
    "ghAvailable": true,
    "gitAvailable": true,
    "preferredChangeSource": "gh|local-git"
  },
  "discovery": {
    "appPathSource": "user|discovered",
    "ciPathSource": "user|default|discovered",
    "cdConfigSource": "user|default|discovered",
    "repositoryConfigVersion": "2",
    "notes": [
      "optional notes about assumptions or fallbacks"
    ]
  }
}

Steps To Follow

1. Ask the user for optional known values:

• Xperience app path
• CI Repository path
• CD repository.config path
• Preferred change source (gh or local-git)

1. Discover missing values automatically:

• Search for App_Data/CDRepository/repository.config.
• Search for App_Data/CIRepository.
• Infer appPath as the parent folder of App_Data.
• If multiple candidates exist, pick the best match by proximity/consistency and note alternatives in discovery.notes.

1. Validate all required paths exist:

• appPath
• ciRepositoryPath
• cdRepositoryConfigPath

1. Detect repository.config syntax version:

• Open the repository.config file and check the root `` attribute.
• Record the version ("1" or "2") in discovery.repositoryConfigVersion.
• If Version attribute is missing, assume v1 and record accordingly.

1. Detect tool availability:

• Check if gh CLI is available.
• Check if local git is available.
• Set preferredChangeSource:
• Use gh when gh is available and user did not force local git.
• Otherwise use local-git.

1. Ensure the context folder exists, then write cd-repository-context.json.

1. Print a concise summary of what was discovered and where the context file was written.

Rules

• Do not edit repository.config in this skill.
• Do not guess silently. If a critical value cannot be determined, ask a focused follow-up question.
• Keep paths absolute in the context file.
• Preserve user-provided values when valid; only fall back to discovery/defaults when needed.
• If both gh and git are unavailable, still write context with clear error notes and ask user to resolve tooling.
• If repository.config uses v1 syntax, record this in the context file and include a warning in the output summary.

Output Format

Conclude with:

• Context file path
• App path
• CI repository path
• CD repository.config path
• Repository.config syntax version
• Tooling status (gh, git, chosen source)
• Any assumptions/fallbacks recorded
• If v1 syntax detected: Include this warning in the summary:

> ⚠️ Note: The repository.config file uses the legacy v1 syntax. Before running cd-repository-configure, you must upgrade to v2 syntax using the cd-repository-upgrade skill. See Migrate CI/CD repository.config to v2 for details.

Source & license

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

• Author: Kentico
• Source: Kentico/xperience-by-kentico-kenticopilot
• License: MIT

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