CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

orchardcore-docs-writer

Authors OrchardCore documentation — MkDocs Material pages, module README docs, nav entries, admonitions, tabbed content, and redirects. Use when the user needs to add or edit a docs page, document a new module, build/serve the docs site, or wire a page into the navigation.

Quality

89%

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

86%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 tight, highly actionable skill: exact paths, commands, and convention snippets make both workflows immediately executable, and detail is properly offloaded to a real, well-signaled reference file. The only weaknesses are minor duplication in the Quick Reference section and the absence of an explicit validation feedback loop.

DimensionReasoningScore

Conciseness

Dense, tabular, no re-teaching of concepts Claude knows (e.g., 'Docs are MkDocs + Material for MkDocs. Config: mkdocs.yml at repo root' with no elaboration), but the Quick Reference section repeats toolchain commands, module header, and extension details already covered earlier, so some tokens could be trimmed.

4 / 5

Actionability

Fully executable guidance throughout: 'pip install -r src/docs/requirements.txt', 'python -m mkdocs serve', exact nav YAML snippets, the '# Name (`OrchardCore.Name`)' header convention, and copy-paste admonition/tabbed examples cover the common cases with concrete paths.

5 / 5

Workflow Clarity

Workflows A and B are clearly sequenced (write markdown → add to nav → build/preview; create file → index links → nav entry → content-part link) with the build step and the 'build warns about pages not in nav' gotcha acting as checkpoints, but there is no explicit validate→fix→retry feedback loop.

4 / 5

Progressive Disclosure

The body is an appropriate overview with a clearly signaled, verified one-level-deep reference ('references/docs-structure.md — full directory map, nav anatomy, extensions, redirects') that genuinely holds the deeper detail; only trivial duplication between the two.

5 / 5

Total

18

/

20

Passed

Description

87%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 in third person that concretely states what it authors and gives an explicit, multi-condition 'Use when' clause with natural trigger phrasing. Keyword coverage could add a few synonyms, but distinctiveness and completeness are excellent.

DimensionReasoningScore

Specificity

Lists six specific artifact types ('MkDocs Material pages, module README docs, nav entries, admonitions, tabbed content, and redirects') under the single action 'Authors', which is several specific items with minor gaps rather than comprehensive multi-action coverage.

4 / 5

Completeness

Explicitly answers both what ('Authors OrchardCore documentation — MkDocs Material pages, module README docs, nav entries, admonitions, tabbed content, and redirects') and when ('Use when the user needs to add or edit a docs page, document a new module, build/serve the docs site, or wire a page into the navigation') with concrete trigger phrases.

5 / 5

Trigger Term Quality

Natural phrases users would say — 'add or edit a docs page', 'document a new module', 'build/serve the docs site', 'wire a page into the navigation' — with good coverage, though a few natural synonyms (e.g., 'README', 'mkdocs.yml', 'documentation') are missing.

4 / 5

Distinctiveness Conflict Risk

Clear niche — OrchardCore documentation with MkDocs Material specifics — and trigger terms ('nav entries', 'module README docs') are tied to this domain, so conflict risk with other skills is minimal.

5 / 5

Total

18

/

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-docs-writer/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.