Agent skill

Umbraco Search Compat

by Shazwazza in Shazwazza/Examine

Validate Examine v4 backward compatibility with Umbraco.Cms.Search by cloning the Umbraco.Cms.Search repo, swapping the Examine NuGet package reference to a local project reference, and verifying…

MITAuto-check passedDevelopment

Install Umbraco Search Compat

skills CLI
$ npx skills add Shazwazza/Examine --skill umbraco-search-compat -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install Shazwazza/Examine umbraco-search-compat --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/Shazwazza/Examine.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.github/skills/umbraco-search-compat .claude/skills/umbraco-search-compat && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
umbraco-search-compat
GitHub stars
412
Token cost
~1.7k tokens
SKILL.md length
629 words
Files
1
Skills in repo
4
Repo updated
First seen
Licence
MIT

At a glance

Validate Examine v4 backward compatibility with Umbraco.Cms.Search by cloning the Umbraco.Cms.Search repo, swapping the Examine NuGet package reference to a local project reference, and verifying…

  • Works in 7 steps: Ensure TEMP Is Git-Ignored → Clone Umbraco.Cms.Search (If Needed) → Modify Directory.Packages.props → …
  • Checking API compatibility
  • SKILL.md covers When to Use This Skill, Prerequisites, Important Rules and Repository Structure, plus 4 more sections
  • Calls git and dotnet; reaches github.com

What it does

Umbraco Search Compat is an agent skill from Shazwazza/Examine. Validate Examine v4 backward compatibility with Umbraco.Cms.Search by cloning the Umbraco.Cms.Search repo, swapping the Examine NuGet package reference to a local project reference, and verifying the build and tests pass. Use when checking API compatibility, verifying breaking changes, or validating that Examine v4 works with Umbraco.Cms.Search. Intended for the examine-compat-validator custom agent.

Its SKILL.md is about 1.7k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts. Compatibility notes: Requires git and dotnet SDK. Requires network access to clone https://github.com/umbraco/Umbraco.Cms.Search.git

It sits in Development. It works with Git. The repository describes itself as: A .NET indexing and search engine powered by Lucene.Net. The licence is MIT.

When your agent uses it

  • Checking API compatibility
  • Verifying breaking changes
  • Validating that Examine v4 works with Umbraco.Cms.Search

Example prompts

  • “/umbraco-search-compat”

Requirements

  • Compatibility (from SKILL.md): Requires git and dotnet SDK. Requires network access to clone https://github.com/umbraco/Umbraco.Cms.Search.git

Workflow steps

7 steps, taken from the step headings in SKILL.md.

  1. Ensure TEMP Is Git-Ignored
  2. Clone Umbraco.Cms.Search (If Needed)
  3. Modify Directory.Packages.props
  4. Swap Package Reference to Project Reference
  5. Restore and Build
  6. Run Tests
  7. Report Results

What it can do on your machine

Read from SKILL.md and the folder at commit 2500d3c. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • git
    • dotnet

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Hosts in commands or code, which the agent is likely to contact:

    • github.com

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

  • Compatibility

    Requires git and dotnet SDK. Requires network access to clone https://github.com/umbraco/Umbraco.Cms.Search.git

    From compatibility in the SKILL.md frontmatter.

Context cost

Umbraco Search Compat loads about 1.7k tokens when it runs. Until then it costs about 106 tokens; SKILL.md has 629 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~106
When it runs · the whole SKILL.md, loaded when a task matches
~1.7k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from Shazwazza/Examine at commit 2500d3c, republished under its MIT licence (© Shazwazza). 629 words, ~1,724 tokens.

Download SKILL.mdSave it as .claude/skills/umbraco-search-compat/SKILL.md (or your agent's skills folder).
name
umbraco-search-compat
description
Validate Examine v4 backward compatibility with Umbraco.Cms.Search by cloning the Umbraco.Cms.Search repo, swapping the Examine NuGet package reference to a local project reference, and verifying the build and tests pass. Use when checking API compatibility, verifying breaking changes, or validating that Examine v4 works with Umbraco.Cms.Search. Intended for the examine-compat-validator custom agent.
compatibility
Requires git and dotnet SDK. Requires network access to clone https://github.com/umbraco/Umbraco.Cms.Search.git
metadata.author
Examine
metadata.version
1.0

Umbraco.Cms.Search Compatibility Validator

Validates that the current Examine v4 codebase is backward compatible with Umbraco.Cms.Search by replacing its NuGet package reference for Examine with a project reference pointing to this workspace, then building and testing the solution.

When to Use This Skill

  • After making changes to Examine public APIs
  • Before releasing a new version of Examine
  • When verifying that Examine v4 does not introduce breaking changes for Umbraco.Cms.Search
  • When the user asks to "check search compatibility", "validate search compat", or "test against Umbraco Search"

Prerequisites

  • git CLI available on PATH
  • dotnet SDK installed (must support the target frameworks used by both Examine and Umbraco.Cms.Search)
  • Network access to clone from GitHub

Important Rules

  • The TEMP folder at the workspace root is disposable and must NEVER be committed to the Examine repository.
  • Ensure TEMP/ is listed in the root .gitignore before proceeding.
  • If TEMP/Umbraco.Cms.Search already exists, it means the repos skip the clone step and use the existing clone then ensure to run git pull to update.

Repository Structure

The Umbraco.Cms.Search repository has the following relevant layout:

Umbraco.Cms.Search/
├── Directory.Packages.props          ← Central Package Management (has Examine entry)
├── src/
│   ├── Umbraco.Cms.Search.sln       ← Solution file
│   ├── Umbraco.Cms.Search.Core/     ← Core abstractions (no direct Examine ref)
│   ├── Umbraco.Cms.Search.Provider.Examine/  ← Examine provider (references Examine NuGet)
│   ├── Umbraco.Test.Search.Examine.Integration/ ← Integration tests
│   └── ...other projects

Package-to-Project Mapping

Umbraco.Cms.Search uses Central Package Management (Directory.Packages.props). The following NuGet package must be swapped to a project reference:

NuGet PackageUmbraco.Cms.Search Project That References ItExamine Project Reference
Examine (v4.0.0-beta.1)src/Umbraco.Cms.Search.Provider.Examine/Umbraco.Cms.Search.Provider.Examine.csprojsrc/Examine.Host/Examine.csproj

Note: Umbraco.Cms.Search.Core does NOT directly reference Examine — it references Umbraco CMS packages only.

Step-by-Step Workflow

Step 1: Ensure TEMP Is Git-Ignored

Check that the workspace root .gitignore contains a TEMP/ entry. If not, add it:

TEMP/
Step 2: Clone Umbraco.Cms.Search (If Needed)

If TEMP/Umbraco.Cms.Search does not exist:

bash
git clone https://github.com/umbraco/Umbraco.Cms.Search.git TEMP/Umbraco.Cms.Search

If it already exists, optionally update it:

bash
cd TEMP/Umbraco.Cms.Search && git pull && cd ../..

Note: Do NOT use --depth 1 as the repo uses Nerdbank.GitVersioning which requires full git history for version calculation. If you must shallow clone, be prepared to git fetch --unshallow before building.

Step 3: Modify Directory.Packages.props

In TEMP/Umbraco.Cms.Search/Directory.Packages.props, remove or comment out the Examine package version entry:

xml
<!-- Remove or comment out this line: -->
<PackageVersion Include="Examine" Version="4.0.0-beta.1" />
Step 4: Swap Package Reference to Project Reference
Umbraco.Cms.Search.Provider.Examine.csproj

File: TEMP/Umbraco.Cms.Search/src/Umbraco.Cms.Search.Provider.Examine/Umbraco.Cms.Search.Provider.Examine.csproj

Replace:

xml
<PackageReference Include="Examine"/>

With:

xml
<ProjectReference Include="..\..\..\..\src\Examine.Host\Examine.csproj" />
Step 5: Restore and Build

From the workspace root, build the Umbraco.Cms.Search solution:

bash
cd TEMP/Umbraco.Cms.Search
dotnet restore
dotnet build --no-restore

Expected outcome: Build succeeds with zero errors. Warnings are acceptable.

If the build fails, analyze the error output:

  • Missing type/member errors indicate a breaking API change in Examine that must be addressed.
  • Nullable annotation warnings promoted to errors (CS8600, CS8601, CS8602, CS8604, CS8620, CS8765) may be caused by Examine v4 tightening NRT annotations. These can be suppressed in the affected .csproj files with <NoWarn> for compat testing purposes, while still detecting real API shape changes.
  • Target framework mismatches may require aligning TFMs between Examine and Umbraco.Cms.Search.
  • Transitive dependency conflicts may require version alignment in Directory.Packages.props.
Show full SKILL.md (200 more words)Show less
Step 6: Run Tests

Run the Examine-specific integration tests:

bash
cd TEMP/Umbraco.Cms.Search
dotnet test src/Umbraco.Test.Search.Examine.Integration --no-build

If that filter doesn't work, run the full test suite:

bash
dotnet test --no-build

Expected outcome: All tests pass. Any test failures related to Examine APIs indicate compatibility issues.

Step 7: Report Results

Summarize the outcome:

  1. Build status: Pass / Fail (with error details)
  2. Test status: Pass / Fail (with failure details)
  3. Breaking changes found: List any Examine API changes that caused build or test failures
  4. Recommended fixes: For each breaking change, suggest whether to fix in Examine (restore API) or note as an intentional breaking change

Troubleshooting

IssueSolution
Clone failsCheck network access and git credentials
NBGV version height errorRun git fetch --unshallow in the clone directory
Build fails with TFM errorsVerify both repos target compatible frameworks (check Directory.Build.props in both repos)
NuGet restore fails after swapEnsure the PackageVersion entry was fully removed from Directory.Packages.props
Relative paths are wrongVerify the workspace structure: Examine repo root must contain both TEMP/Umbraco.Cms.Search/ and src/
Tests fail on unrelated Umbraco issuesFocus only on failures that reference Examine namespaces or types
Nullable warnings treated as errorsAdd <NoWarn>$(NoWarn);CS8600;CS8601;CS8602;CS8604;CS8620;CS8765</NoWarn> to affected project PropertyGroups

Cleanup

The TEMP folder is disposable. To clean up:

bash
Remove-Item -Recurse -Force TEMP/Umbraco.Cms.Search

© Shazwazza, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in .github/skills/umbraco-search-compat of Shazwazza/Examine.

Open the folder on GitHubat commit 2500d3c

Compare with similar skills

Umbraco Search Compat next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Umbraco Search Compat compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Umbraco Search Compat this skillShazwazza/Examine412—~1.7kAutomated safety check: PassMIT
Finishing a Development Branchobra/superpowers297k5 repos~1.9kAutomated safety check: PassMIT
Code Review ChecklistshareAI-lab/learn-claude-code78k4 repos~1.1kAutomated safety check: PassMIT
Contributor-First PR MergeHKUDS/OpenHarness16k1 repos~847Automated safety check: PassMIT
Finishing A Development Branchfarm-fe/farm5.6k35 repos~1.8kAutomated safety check: PassMIT
Migrate Internal Package into GhostTryGhost/Ghost56k—~3.8kAutomated safety check: PassMIT

Similar skills

  • Walks the last step of a branch: confirm tests pass, detect the git environment, ask how to integrate, carry out your choice and clean up the worktree.

    297k GitHub starsUsed in 5 repos~1.9k tokens
    DevelopmentAuto-check passed
  • Code Review Checklist

    shareAI-lab/learn-claude-code

    Reviews code against a five-part checklist covering security, correctness, performance, maintainability and testing, and reports findings in a fixed format.

    78k GitHub starsUsed in 4 repos~1.1k tokens
    DevelopmentAuto-check passed
  • Merges external GitHub pull requests while keeping the original author credited, and fixes conflicts after the merge instead of rewriting the contribution.

    16k GitHub starsUsed in 1 repo~847 tokens
    DevelopmentAuto-check passed
  • A skill your agent uses when implementation is complete, all tests pass, and you need to decide how to integrate the work - guides completion of development work by presenting structured options for…

    5.6k GitHub starsUsed in 35 repos~1.8k tokens
    DevelopmentAuto-check passed
  • Moves a package from another TryGhost repository into Ghost as an internal workspace package while keeping its Git history, with checkpoints for the steps that need an administrator.

    56k GitHub stars~3.8k tokensUpdated today
    DevelopmentAuto-check passed
  • Doc Sync

    JetBrains/ideavim

    Official

    Keeps IdeaVim documentation in sync with code changes. An agent skill from JetBrains/ideavim.

    10k GitHub starsUsed in 2 repos~2.6k tokens
    DevelopmentAuto-check passed

More from Shazwazza/Examine

  • Examinex Compat

    Shazwazza/Examine

    Validate Examine v4 backward compatibility with ExamineX by cloning the ExamineX.Source repo (support/9.x branch), swapping Examine NuGet package references to local project references, and…

    412 GitHub stars~2.6k tokensUpdated 4 days ago
    Auto-check passed
  • Public API Management

    Shazwazza/Examine

    Manage Examine public API tracking using the PublicAPI Roslyn analyzer workflow.

    412 GitHub stars~1.9k tokensUpdated 4 days ago
    Auto-check passed
  • Umbraco Compat

    Shazwazza/Examine

    Validate Examine v4 backward compatibility with Umbraco CMS by cloning the Umbraco-CMS repo, swapping NuGet package references to local project references, and verifying the build and tests pass.

    412 GitHub stars~1.4k tokensUpdated 4 days ago
    Auto-check passed

Works with

Categories

Questions about Umbraco Search Compat

What does Umbraco Search Compat do?

Validate Examine v4 backward compatibility with Umbraco.Cms.Search by cloning the Umbraco.Cms.Search repo, swapping the Examine NuGet package reference to a local project reference, and verifying…. Umbraco Search Compat is an agent skill from Shazwazza/Examine.Search repo, swapping the Examine NuGet package reference to a local project reference, and verifying the build and tests pass.

When should I use Umbraco Search Compat?

Umbraco Search Compat fits situations like: checking API compatibility; verifying breaking changes; validating that Examine v4 works with Umbraco.Cms.Search.

How do I install Umbraco Search Compat in Claude Code?

Run `npx skills add Shazwazza/Examine --skill umbraco-search-compat -a claude-code`. Or copy the skill folder (.github/skills/umbraco-search-compat in Shazwazza/Examine) into .claude/skills/umbraco-search-compat in your project. Claude Code loads it when a task matches its description.

How do I install Umbraco Search Compat in Codex?

Run `npx skills add Shazwazza/Examine --skill umbraco-search-compat -a codex`. Or copy the skill folder (.github/skills/umbraco-search-compat in Shazwazza/Examine) into .agents/skills/umbraco-search-compat in your project. Codex loads it when a task matches its description.

Can I use Umbraco Search Compat in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add Shazwazza/Examine --skill umbraco-search-compat -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/umbraco-search-compat, .gemini/skills/umbraco-search-compat, .github/skills/umbraco-search-compat and .opencode/skills/umbraco-search-compat in your project.

What does Umbraco Search Compat need to run?

Going by SKILL.md and its folder, Umbraco Search Compat needs the command-line tools its instructions call (git and dotnet). Compatibility (from SKILL.md): Requires git and dotnet SDK. Requires network access to clone https://github.com/umbraco/Umbraco.Cms.Search.git.

Does Umbraco Search Compat access the network?

SKILL.md names 1 domain. In commands or code: github.com; the agent is likely to contact it when it follows the instructions. This is read from the text; nothing was executed.

Is Umbraco Search Compat safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Umbraco Search Compat use?

Umbraco Search Compat is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Umbraco Search Compat use?

About 1.7k tokens (SKILL.md is roughly 6.9k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Umbraco Search Compat?

Skills that share tags, products or a category with Umbraco Search Compat: Finishing a Development Branch (obra/superpowers, 297k stars), Code Review Checklist (shareAI-lab/learn-claude-code, 78k stars), Contributor-First PR Merge (HKUDS/OpenHarness, 16k stars) and Finishing A Development Branch (farm-fe/farm, 5.6k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Umbraco Search Compat?

Shazwazza (a GitHub user) maintains it in Shazwazza/Examine, which has 412 GitHub stars. The repository holds 4 skills in this directory. The repository was last updated on October 7, 2026.

Source: Shazwazza/Examine on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.