About umbraco-review-checks
A reference skill for the `umbraco-extension-reviewer` agent, organizing Umbraco extension review checks across code quality, architecture, and UI patterns. It maps checks to extension types and notes severity and auto-fix availability.
Key features
- 01Code quality review checks
- 02Architecture review checks
- 03UI pattern review checks
- 04Extension-type file guidance
- 05Severity and auto-fix reference
Use cases
- 01Reviewing an Umbraco dashboard or workspace
- 02Checking a property editor or entity action
- 03Reviewing context or repository extensions
Install
Copy the command and run it in a terminal.
npx skills add https:/After installing, type/umbraco-review-checksin Claude Code to confirm it loaded.
Bundled files
References and scripts installed along with SKILL.md.
architecture-checks.mdcode-quality-checks.mdui-pattern-checks.mdDetails
From the project READMEUmbraco Extension Review Checks
Reference skill containing all review checks for the umbraco-extension-reviewer agent.
Check Categories
| Category | File | Checks |
|---|---|---|
| Code Quality | code-quality-checks.md | CQ-1 to CQ-9 |
| Architecture | architecture-checks.md | AR-1 to AR-6 |
| UI Patterns | ui-pattern-checks.md | UI-1 to UI-7 |
Quick Reference
| ID | Check | Severity | Auto-Fix |
|---|---|---|---|
| Code Quality | |||
| CQ-1 | Extension Type Usage | Critical | Yes |
| CQ-2 | Manifest Registration | High | No |
| CQ-3 | Element Implementation | Medium | Partial |
| CQ-4 | Context API Usage | High | No |
| CQ-5 | State Management | Medium | No |
| CQ-6 | Localization | Medium | Partial |
| CQ-7 | Naming Conventions | Low | No |
| CQ-8 | Conditions | Low | No |
| CQ-9 | Property Editor Schema Alias | Critical | No |
| Architecture | |||
| AR-1 | Direct API Client Access | High | No |
| AR-2 | No Workspace Context | High | No |
| AR-3 | Source Pattern Verification | Medium | No |
| AR-4 | Inconsistent Persistence | Medium | No |
| AR-5 | Missing Repository Layer | High | No |
| AR-6 | Circular Context Dependencies | Critical | No |
| UI Patterns | |||
| UI-1 | Custom Error Handling | High | Partial |
| UI-2 | Layout Component Issues | High | No |
| UI-3 | Non-UUI Component Usage | Medium | Partial |
| UI-4 | Enum/Select Handling | Medium | Partial |
| UI-5 | Missing Loading States | Low | No |
| UI-6 | Accessibility Issues | Medium | No |
| UI-7 | Inline Styles | Low | Partial |
Usage
Read the relevant category file(s) based on extension type:
| Extension Type | Load Files |
|---|---|
| Dashboard | All three |
| Workspace | All three |
| Property Editor | code-quality, ui-pattern |
| Entity Action | code-quality only |
| Context/Repository | code-quality, architecture |
Related Skills
| Pattern Area | Skill |
|---|---|
| Repository pattern | umbraco-repository-pattern |
| Workspace context | umbraco-workspace |
| Notifications | umbraco-notifications |
| Context API | umbraco-context-api |
| Localization | umbraco-localization |
Source References
UUI Library
For UI pattern checks, refer to the UUI (Umbraco UI) library for component best practices.
Check locally first - The UUI source may be available in the workspace (e.g., Umbraco.UI/packages/). Use Glob to search for it.
Online resources:
- Storybook: https://uui.umbraco.com/
- GitHub: https://github.com/umbraco/Umbraco.UI
Umbraco CMS Source
For architecture and pattern checks, compare against Umbraco CMS source implementations.
Check locally first - The Umbraco CMS source may be available in the workspace (e.g., Umbraco-CMS/src/Umbraco.Web.UI.Client/). Use Glob to search for reference implementations.
Online resources:
When reviewing, prefer local source over web fetches for accuracy and speed.