Finishing a Development Branch
obra/superpowers
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.
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.
Install Umbraco Compat
$ npx skills add Shazwazza/Examine --skill umbraco-compat -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install Shazwazza/Examine umbraco-compat --agent claude-codeProject scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).
$ git clone --depth 1 https://github.com/Shazwazza/Examine.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.github/skills/umbraco-compat .claude/skills/umbraco-compat && rm -rf skills-srcUse ~/.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/
Install the "umbraco-compat" agent skill from https://github.com/Shazwazza/Examine/tree/dev/.github/skills/umbraco-compat into .claude/skills/umbraco-compat/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "umbraco-compat", then confirm the skill loads.Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$skill-installer install https://github.com/Shazwazza/Examine/tree/dev/.github/skills/umbraco-compatType this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.
$ npx skills add Shazwazza/Examine --skill umbraco-compat -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install Shazwazza/Examine umbraco-compat --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/Shazwazza/Examine.git skills-src && mkdir -p .agents/skills && cp -r skills-src/.github/skills/umbraco-compat .agents/skills/umbraco-compat && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "umbraco-compat" agent skill from https://github.com/Shazwazza/Examine/tree/dev/.github/skills/umbraco-compat into .agents/skills/umbraco-compat/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "umbraco-compat", then confirm the skill loads.Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add Shazwazza/Examine --skill umbraco-compat -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install Shazwazza/Examine umbraco-compat --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/Shazwazza/Examine.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/.github/skills/umbraco-compat .cursor/skills/umbraco-compat && rm -rf skills-srcUse ~/.cursor/skills/ instead of .cursor/skills for a personal install.
Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/
Install the "umbraco-compat" agent skill from https://github.com/Shazwazza/Examine/tree/dev/.github/skills/umbraco-compat into .cursor/skills/umbraco-compat/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "umbraco-compat", then confirm the skill loads.Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gemini skills install https://github.com/Shazwazza/Examine.git --path .github/skills/umbraco-compat--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.
$ npx skills add Shazwazza/Examine --skill umbraco-compat -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install Shazwazza/Examine umbraco-compat --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/Shazwazza/Examine.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/.github/skills/umbraco-compat .gemini/skills/umbraco-compat && rm -rf skills-srcUse ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.
Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/
Install the "umbraco-compat" agent skill from https://github.com/Shazwazza/Examine/tree/dev/.github/skills/umbraco-compat into .gemini/skills/umbraco-compat/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "umbraco-compat", then confirm the skill loads.Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gh skill install Shazwazza/Examine umbraco-compatInstalls for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).
$ npx skills add Shazwazza/Examine --skill umbraco-compat -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/Shazwazza/Examine.git skills-src && mkdir -p .github/skills && cp -r skills-src/.github/skills/umbraco-compat .github/skills/umbraco-compat && rm -rf skills-srcUse ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.
GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/
Install the "umbraco-compat" agent skill from https://github.com/Shazwazza/Examine/tree/dev/.github/skills/umbraco-compat into .github/skills/umbraco-compat/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "umbraco-compat", then confirm the skill loads.GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add Shazwazza/Examine --skill umbraco-compat -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install Shazwazza/Examine umbraco-compat --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/Shazwazza/Examine.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/.github/skills/umbraco-compat .opencode/skills/umbraco-compat && rm -rf skills-srcUse ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.
OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/
Install the "umbraco-compat" agent skill from https://github.com/Shazwazza/Examine/tree/dev/.github/skills/umbraco-compat into .opencode/skills/umbraco-compat/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "umbraco-compat", then confirm the skill loads.OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
Facts
- Skill name
umbraco-compat- GitHub stars
- 412
- Token cost
- ~1.4k tokens
- SKILL.md length
- 510 words
- Files
- 1
- Skills in repo
- 4
- Repo updated
- First seen
- Licence
- MIT
At a glance
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.
- Works in 7 steps: Ensure TEMP Is Git-Ignored → Clone Umbraco CMS (If Needed) → Modify Directory.Packages.props → …
- Checking API compatibility
- SKILL.md covers When to Use This Skill, Prerequisites, Important Rules and Package-to-Project Mapping, plus 3 more sections
- Calls dotnet and git; reaches github.com
What it does
Umbraco Compat is an agent skill from 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. Use when checking API compatibility, verifying breaking changes, or validating that Examine v4 works with Umbraco CMS. Intended for the examine-compat-validator custom agent.
Its SKILL.md is about 1.4k 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.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
Example prompts
- “/umbraco-compat”
Requirements
- Compatibility (from SKILL.md): Requires git and dotnet SDK. Requires network access to clone https://github.com/umbraco/Umbraco-CMS.git
Workflow steps
7 steps, taken from the step headings in SKILL.md.
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:
dotnetgit
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.git
From compatibility in the SKILL.md frontmatter.
Context cost
Umbraco Compat loads about 1.4k tokens when it runs. Until then it costs about 96 tokens; SKILL.md has 510 words of instructions outside code blocks.
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). 510 words, ~1,405 tokens.
Download SKILL.mdSave it as
.claude/skills/umbraco-compat/SKILL.md (or your agent's skills folder).- name
- umbraco-compat
- description
- 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. Use when checking API compatibility, verifying breaking changes, or validating that Examine v4 works with Umbraco CMS. 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.git
- metadata.author
- Examine
- metadata.version
- 1.0
Umbraco CMS Compatibility Validator
Validates that the current Examine v4 codebase is backward compatible with Umbraco CMS by replacing Umbraco's NuGet package references for Examine with project references pointing to this workspace, then building and testing the Umbraco 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
- When the user asks to "check Umbraco compatibility", "validate compatibility", or "test against Umbraco"
Prerequisites
gitCLI available on PATHdotnetSDK installed (must support the target frameworks used by both Examine and Umbraco CMS)- Network access to clone from GitHub
Important Rules
- The
TEMPfolder at the workspace root is disposable and must NEVER be committed to the Examine repository. - Ensure
TEMP/is listed in the root.gitignorebefore proceeding. - If
TEMP/Umbraco-CMSalready exists, skip the clone step and use the existing clone (optionally rungit pullto update).
Package-to-Project Mapping
Umbraco CMS uses Central Package Management (Directory.Packages.props). The following NuGet packages must be swapped to project references:
| NuGet Package | Umbraco Project(s) That Reference It | Examine Project Reference |
|---|---|---|
Examine | src/Umbraco.Examine.Lucene/Umbraco.Examine.Lucene.csproj | src/Examine.Host/Examine.csproj |
Examine.Core | src/Umbraco.Infrastructure/Umbraco.Infrastructure.csproj | src/Examine.Core/Examine.Core.csproj |
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 (If Needed)
If TEMP/Umbraco-CMS does not exist:
git clone --depth 1 https://github.com/umbraco/Umbraco-CMS.git TEMP/Umbraco-CMSIf it already exists, optionally update it:
cd TEMP/Umbraco-CMS && git pull && cd ../..Step 3: Modify Directory.Packages.props
In TEMP/Umbraco-CMS/Directory.Packages.props, remove or comment out the Examine package version entries:
<!-- Remove or comment out these lines: -->
<PackageVersion Include="Examine" Version="3.7.1" />
<PackageVersion Include="Examine.Core" Version="3.7.1" />Step 4: Swap Package References to Project References
4a. Umbraco.Examine.Lucene.csproj
File: TEMP/Umbraco-CMS/src/Umbraco.Examine.Lucene/Umbraco.Examine.Lucene.csproj
Replace:
<PackageReference Include="Examine" />With:
<ProjectReference Include="..\..\..\..\src\Examine.Host\Examine.csproj" />4b. Umbraco.Infrastructure.csproj
File: TEMP/Umbraco-CMS/src/Umbraco.Infrastructure/Umbraco.Infrastructure.csproj
Replace:
<PackageReference Include="Examine.Core" />With:
<ProjectReference Include="..\..\..\..\src\Examine.Core\Examine.Core.csproj" />Step 5: Restore and Build
From the workspace root, build the Umbraco solution:
cd TEMP/Umbraco-CMS
dotnet restore
dotnet build --no-restoreExpected 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.
- Target framework mismatches may require aligning TFMs between Examine and Umbraco.
- Transitive dependency conflicts may require version alignment in Directory.Packages.props.
Show full SKILL.md (173 more words)Show less
Step 6: Run Tests
cd TEMP/Umbraco-CMS
dotnet test --no-build --filter "FullyQualifiedName~Examine"If no Examine-specific test filter exists, run the full test suite:
dotnet test --no-buildExpected outcome: All tests pass. Any test failures related to Examine APIs indicate compatibility issues.
Step 7: Report Results
Summarize the outcome:
- Build status: Pass / Fail (with error details)
- Test status: Pass / Fail (with failure details)
- Breaking changes found: List any Examine API changes that caused build or test failures
- Recommended fixes: For each breaking change, suggest whether to fix in Examine (restore API) or note as an intentional breaking change
Troubleshooting
| Issue | Solution |
|---|---|
| Clone fails | Check network access and git credentials |
| Build fails with TFM errors | Verify both repos target compatible frameworks (check Directory.Build.props in both repos) |
| NuGet restore fails after swap | Ensure the PackageVersion entries were fully removed from Directory.Packages.props |
| Relative paths are wrong | Verify the workspace structure: Examine repo root must contain both TEMP/Umbraco-CMS/ and src/ |
| Tests fail on unrelated Umbraco issues | Focus only on failures that reference Examine namespaces or types |
Cleanup
The TEMP folder is disposable. To clean up:
Remove-Item -Recurse -Force TEMP© 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-compat of Shazwazza/Examine.
Open the folder on GitHubat commit 2500d3c
Compare with similar skills
Umbraco 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.
| Skill | Stars | Used in | Tokens | Auto-check | Licence | Repo updated |
|---|---|---|---|---|---|---|
| Umbraco Compat this skillShazwazza/Examine | 412 | — | ~1.4k | Automated safety check: Pass | MIT | |
| Finishing a Development Branchobra/superpowers | 297k | 5 repos | ~1.9k | Automated safety check: Pass | MIT | |
| Code Review ChecklistshareAI-lab/learn-claude-code | 78k | 4 repos | ~1.1k | Automated safety check: Pass | MIT | |
| Contributor-First PR MergeHKUDS/OpenHarness | 16k | 1 repos | ~847 | Automated safety check: Pass | MIT | |
| Finishing A Development Branchfarm-fe/farm | 5.6k | 35 repos | ~1.8k | Automated safety check: Pass | MIT | |
| Migrate Internal Package into GhostTryGhost/Ghost | 56k | — | ~3.8k | Automated safety check: Pass | MIT |
Similar skills
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.
Contributor-First PR Merge
HKUDS/OpenHarness
Merges external GitHub pull requests while keeping the original author credited, and fixes conflicts after the merge instead of rewriting the contribution.
Finishing A Development Branch
farm-fe/farm
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…
Migrate Internal Package into Ghost
TryGhost/Ghost
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.
- Official
Doc Sync
JetBrains/ideavim
Keeps IdeaVim documentation in sync with code changes. An agent skill from JetBrains/ideavim.
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…
Public API Management
Shazwazza/Examine
Manage Examine public API tracking using the PublicAPI Roslyn analyzer workflow.
Umbraco Search Compat
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…
Related
Works with
Categories
Questions about Umbraco Compat
What does Umbraco Compat do?
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. Umbraco Compat is an agent skill from 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.
When should I use Umbraco Compat?
Umbraco Compat fits situations like: checking API compatibility; verifying breaking changes; validating that Examine v4 works with Umbraco CMS.
How do I install Umbraco Compat in Claude Code?
Run `npx skills add Shazwazza/Examine --skill umbraco-compat -a claude-code`. Or copy the skill folder (.github/skills/umbraco-compat in Shazwazza/Examine) into .claude/skills/umbraco-compat in your project. Claude Code loads it when a task matches its description.
How do I install Umbraco Compat in Codex?
Run `npx skills add Shazwazza/Examine --skill umbraco-compat -a codex`. Or copy the skill folder (.github/skills/umbraco-compat in Shazwazza/Examine) into .agents/skills/umbraco-compat in your project. Codex loads it when a task matches its description.
Can I use Umbraco 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-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-compat, .gemini/skills/umbraco-compat, .github/skills/umbraco-compat and .opencode/skills/umbraco-compat in your project.
What does Umbraco Compat need to run?
Going by SKILL.md and its folder, Umbraco Compat needs the command-line tools its instructions call (dotnet and git). Compatibility (from SKILL.md): Requires git and dotnet SDK. Requires network access to clone https://github.com/umbraco/Umbraco-CMS.git.
Does Umbraco 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 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 Compat use?
Umbraco 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 Compat use?
About 1.4k tokens (SKILL.md is roughly 5.6k 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 Compat?
Skills that share tags, products or a category with Umbraco 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 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.