CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

docs-governance

Use when writing, restructuring, auditing, or reviewing Cherry Studio repository documentation, READMEs, JSDoc, comments, Agent instructions, or paired English/Chinese docs, including source-linked documentation impact checks.

Quality

90%

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.

The body is an exemplar of lean, high-signal instruction writing: terse governance rules, concrete pnpm commands, and clear section structure. The only weaknesses are minor — a placeholder argument, no sample command output, and no guidance on recovering from failed validation.

Suggestions

Give one concrete example invocation of `pnpm change:scope` / `pnpm docs:affected` (e.g., with a real base ref like `origin/main`) and a line of expected output so the impact-inspection step is fully copy-paste ready.

Add a brief feedback loop to the Validation section: what to do when `pnpm docs:check`, `pnpm lint`, or `pnpm test:lint` fails (fix and re-run before proceeding).

DimensionReasoningScore

Conciseness

The ~30-line body is dense imperative rules with zero padding ("Keep one home per fact.", "Never hand-edit `docs/dev/README.md` …"), explains nothing Claude already knows, and assumes competence throughout — every token earns its place. It clearly fits the lean/efficient anchor, not the minor-over-explanation anchor below.

5 / 5

Actionability

Concrete, runnable commands and paths are given (`pnpm change:scope --base <verified-ref>`, `pnpm docs:affected --base <verified-ref>`, `pnpm docs:check`, `pnpm lint`, `pnpm test:lint`, `git diff --check`, `translate-docs`), which is mostly executable guidance. It falls short of fully copy-paste ready because commands use a `<verified-ref>` placeholder with no example value and there is no sample output for the impact-inspection commands.

4 / 5

Workflow Clarity

A clear sequence is established ("Require an explicit scope. Read the applicable `AGENTS.md`, then the owning source or module README before judging prose") with checkpoints ("A source-prefix match is a mandatory review prompt, not proof"; a dedicated Validation section with commands). It is not a 5 because there is no feedback loop describing what to do when `pnpm docs:check` or lint fails.

4 / 5

Progressive Disclosure

The skill is under 50 lines with no bundle files and no need for external references; it has well-organized sections (Place the fact / Inspect code impact / Generated and paired docs / Validation) and its few links (pairing contract, translation rules, terminology) are clearly labeled and one level deep — matching the simple-skill exception for a top score.

5 / 5

Total

18

/

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.

The description is a strong example: explicit 'Use when' triggers, concrete enumerated actions, and a tightly scoped niche (Cherry Studio repository docs) make it both complete and distinctive. The only gap is modest synonym coverage in trigger terms.

DimensionReasoningScore

Specificity

The description lists four concrete actions ("writing, restructuring, auditing, or reviewing") and enumerates the full range of objects they apply to ("READMEs, JSDoc, comments, Agent instructions, or paired English/Chinese docs, including source-linked documentation impact checks"), which matches the comprehensive-coverage anchor rather than the minor-gaps anchor below it.

5 / 5

Completeness

It opens with an explicit trigger clause ("Use when writing, restructuring, auditing, or reviewing …") and pairs it with concrete, enumerated capabilities, clearly and explicitly answering both what the skill does and when to use it — the anchor-5 pattern. It is not a 4 because the 'when' is explicit and specific rather than improvable.

5 / 5

Trigger Term Quality

Natural terms users would say are present ("documentation", "READMEs", "JSDoc", "comments", "docs"), giving good keyword coverage, but a few common variations and synonyms (e.g., standalone "docs", "documentation review", "doc audit") are missing, so it falls just short of the comprehensive-synonyms anchor.

4 / 5

Distinctiveness Conflict Risk

"Cherry Studio repository documentation" carves out a clear niche, and distinctive triggers like "JSDoc", "Agent instructions", and "paired English/Chinese docs" make it unlikely to fire for unrelated skills — minimal conflict risk.

5 / 5

Total

19

/

20

Passed

Validation

93%

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

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

relative_links

Relative link issues: 3 suspicious

Warning

Total

15

/

16

Passed

Repository

CherryHQ/cherry-studio

Path

.agents/skills/docs-governance/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.