CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

orchardcore-localization

Localizes OrchardCore apps — UI strings (IStringLocalizer/IViewLocalizer S, T, H), LocalizationSource, updating and exporting checked-in POT templates, localization analyzers, PO files and pluralization, content translation (LocalizationPart, culture picker), and supported-culture configuration. Use when adding or changing localizable strings, updating POT files, fixing OCLOC diagnostics, translating strings, adding a culture, or making content multilingual.

75

Quality

94%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

SKILL.md
Quality
Evals
Security

Quality

Content

92%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

A well-engineered skill body: four clearly sequenced workflows with executable commands, explicit validation and CI feedback for the risky batch operation, and an appropriately deep reference file for internals. The only weakness is minor redundancy between Workflow D, the Gotchas, and the Quick Reference.

DimensionReasoningScore

Conciseness

Dense and project-specific throughout — e.g. "Keep keys as compile-time constants and pass values as format arguments, not interpolated keys" and "never cache a translated result in a static field" — with no padding explaining concepts Claude already knows. Minor trimming opportunities exist: template-embedding behavior appears both in Workflow D Step 1 ("A normal build only embeds an existing template") and again in Gotchas ("Ordinary builds do not refresh POT templates"), and the Quick Reference tables partially restate earlier sections. Efficient with minor instances of redundancy fits anchor 4, not the every-token-earns-its-place level of anchor 5.

4 / 5

Actionability

Fully executable, copy-paste-ready guidance throughout: exact commands (`dotnet msbuild src\OrchardCore.Modules\OrchardCore.Admin\OrchardCore.Admin.csproj -t:UpdateLocalizationCatalog`, `git --no-pager diff -- '*.pot'`), complete PO/POT entries, a full C# injection example, and a concrete recipe JSON block. Specific examples cover the common cases, matching anchor 5.

5 / 5

Workflow Clarity

Workflows A–D are clearly sequenced with numbered steps, and the batch operation (Workflow D) has explicit validation and feedback loops: Step 3 provides review commands, flags that untracked templates need review, gives error-recovery direction ("Fix dynamic keys or unresolved contexts at the source instead of inserting guessed POT entries"), and notes "CI updates the solution's templates and fails if any are uncommitted or out of date". The batch-operation cap does not apply since validation is present; this matches anchor 5, while anchor 4 would require a missing or merely 'verify output' style checkpoint.

5 / 5

Progressive Disclosure

The body holds the operational workflows, decision table, quick reference, and gotchas, while deep material (build properties, OCLOC001–009 meanings, PO discovery order, internals) is deferred to the real, verified `references/localization.md` — one level deep, clearly signaled both at point of need ("See `references/localization.md` for the full PO discovery order and headers") and in a dedicated References section. This matches anchor 5's clear overview with well-signaled one-level-deep references.

5 / 5

Total

19

/

20

Passed

Description

92%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

A strong description: third-person, comprehensive concrete capabilities across all three OrchardCore localization layers, paired with an explicit multi-trigger 'Use when' clause. The only gap is a few missing natural synonyms (i18n, .po, translation platform names), which keeps trigger coverage just short of comprehensive.

DimensionReasoningScore

Specificity

Lists multiple specific concrete actions with named APIs — "updating and exporting checked-in POT templates", "PO files and pluralization", "content translation (LocalizationPart, culture picker)", "supported-culture configuration" — comprehensively covering all three localization layers. This matches the anchor-5 example's breadth, not merely the 'several specific actions' of anchor 4.

5 / 5

Completeness

Clearly answers both: the first sentence states what the skill does, and an explicit "Use when adding or changing localizable strings, updating POT files, fixing OCLOC diagnostics, translating strings, adding a culture, or making content multilingual" clause gives six concrete triggers. This is structurally identical to the anchor-5 example; anchor 4's 'when could be more explicit' does not apply.

5 / 5

Trigger Term Quality

Includes natural user phrasings like "updating POT files", "fixing OCLOC diagnostics", "translating strings", "adding a culture", and "making content multilingual", but misses common synonyms and file extensions such as "i18n", "internationalization", ".po", or "translation platform/Crowdin". Good coverage with a few natural terms missing fits anchor 4; anchor 5 requires the synonym/extension completeness that is absent.

4 / 5

Distinctiveness Conflict Risk

Scoped to "Localizes OrchardCore apps" with project-specific artifacts (checked-in POT templates, OCLOC diagnostics), giving it a clear niche with distinct triggers and minimal conflict risk with generic localization or gettext skills. Matches anchor 5.

5 / 5

Total

19

/

20

Passed

Validation

100%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository

OrchardCMS/OrchardCore

Path

.agents/skills/orchardcore-localization/SKILL.md

Reviewed

Table of Contents

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.