CtrlK
BlogDocsLog inGet started
Tessl Logo

content-review

Review CircleCI documentation pages for quality, clarity, and adherence to style guidelines. Use this skill whenever the user asks to review, audit, or assess documentation content, check for style compliance, evaluate page quality, or wants feedback on docs pages. Also trigger when the user mentions content quality, readability issues, or asks "how does this page look" or "is this page good." Even if they just reference a docs file path and ask for a review or feedback, use this skill.

73

0.93x
Quality

85%

Does it follow best practices?

Impact

78%

0.93x

1 of 3 eval scenarios. Add 2 more for a full score.

SecuritybySnyk

Passed

No findings from the security scan

SKILL.md
Quality
Evals
Security

Quality

Content

75%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 instruction skill: concrete paths, attribute checks, a copy-paste report template, a clearly sequenced workflow with fallbacks, and disciplined delegation to AGENTS.md and the partials skill rather than duplication. Its main weakness is redundancy — the agent-retrievability and AGENTS.md points each get restated 2-3 times across the dimensions and Important Notes, and the why/value dimensions overlap.

Suggestions

State the agent-retrievability rationale ('each section/code block must stand alone') once, in the Important Notes section, and trim its repetition from dimensions 4 (Code Examples), 5 (Information Architecture), and 6 (Section Introductions).

Merge or cross-reference the overlapping 'Why & How' (dimension 2) and 'Value Proposition' (dimension 10) guidance — both mandate that the opening answer 'why read this' — so the 11-dimension checklist loses no information while shedding a redundant section.

After the save step, add a brief verification checkpoint (e.g., confirm the file exists at the expected path before reporting success to the user) to close the workflow's only validation gap.

DimensionReasoningScore

Conciseness

The body is prescriptive rather than explanatory, but there is measurable redundancy: the agent-retrievability point ('agents often retrieve just one section or code block') is made in dimensions 4, 5, and 6 and again in Important Notes; 'Use the full context from AGENTS.md' appears in Step 1 and Important Notes; and the 'why/value' guidance overlaps between dimensions 2 and 10. This matches anchor 3 ('mostly efficient but includes some unnecessary explanation or could be tightened'), not anchor 2 (nothing explains concepts Claude already knows).

3 / 5

Actionability

Fully concrete for an instruction-only skill: exact paths ('/Users/rosieyohannan/github/circleci-docs/AGENTS.md', 'docs/guides/modules/ROOT/partials/'), a specific attribute check (':page-platform:'), a copy-paste report template with a worked naming example ('rerun-failed-tests.adoc' → 'content-review-rerun-failed-tests.md'), and an end-to-end example usage. Anchor 5.

5 / 5

Workflow Clarity

The 5-step sequence (read context → find related pages → review across 11 dimensions → generate report → save) is clearly ordered, with an explicit error-recovery fallback ('If you can't find related pages... still complete the other 10 categories') and anti-guessing checks ('Always read the actual related pages - don't guess'). It falls short of anchor 5 only for minor checkpoint gaps, e.g., no verification that the report file was actually written before informing the user.

4 / 5

Progressive Disclosure

No bundle files exist, so everything lives in SKILL.md — but the body is well-sectioned and correctly delegates detail outward instead of inlining it: style rules live in AGENTS.md ('it contains detailed style rules beyond what's summarized here') and the partials workflow is handed off to skills/partials/SKILL.md. The only arguably-separable inline content is the ~60-line report template. Anchor 4 (good structure, most content appropriately placed, minor organization gaps) fits better than anchor 3 because the external references are clearly signaled and load-bearing.

4 / 5

Total

16

/

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: it names the domain and concrete capabilities, and delivers an unusually explicit and layered 'when to use' clause with natural trigger phrases including quoted user utterances. The only gaps are the missing file-extension term (.adoc) and no mention of the report-generating output that defines the skill's value.

DimensionReasoningScore

Specificity

Lists several specific actions scoped to CircleCI documentation ('Review... pages for quality, clarity, and adherence to style guidelines', 'check for style compliance', 'evaluate page quality', 'feedback on docs pages'), but omits the skill's signature output — producing and saving a prioritized review report — leaving a minor gap in coverage. It is above anchor 3 (more than 1-2 generic actions, domain-named) but short of anchor 5's comprehensive coverage.

4 / 5

Completeness

Clearly answers 'what' ('Review CircleCI documentation pages for quality, clarity, and adherence to style guidelines') and 'when' with an explicit multi-clause trigger ('Use this skill whenever the user asks to review, audit, or assess... Also trigger when... Even if they just reference a docs file path'). This matches anchor 5 exactly: both what and when with concrete trigger phrases.

5 / 5

Trigger Term Quality

Strong natural-language coverage including synonyms ('review, audit, or assess', 'check for style compliance') and quoted user phrasings ('how does this page look', 'is this page good'), but no file-extension term (e.g., '.adoc') that anchor 5's comprehensive example includes. This sits between anchor 4 (a few natural terms missing) and anchor 5, closer to 4.

4 / 5

Distinctiveness Conflict Risk

'CircleCI documentation pages' carves out a clear niche with distinct, domain-specific triggers, so risk of firing for an unrelated skill is minimal. Anchor 4 ('minor overlap risk with closely related skills') is not a better fit because the triggers are repo- and domain-scoped rather than generically document-shaped.

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