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.

80

1.04x
Quality

79%

Does it follow best practices?

Impact

72%

1.04x

Average score across 3 eval scenarios

SecuritybySnyk

Low

Low-risk findings worth noting

Fix and improve this skill with Tessl

tessl review fix ./skills/content-review/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

67%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 thorough, well-structured review methodology with concrete steps and a detailed report template. Its main weaknesses are repetition between the process and example sections and hardcoded user-specific file paths that hurt portability.

Suggestions

Remove or condense the Example Usage section since it restates the Step 1-5 process already defined under 'Your Process'.

Replace hardcoded paths like /Users/rosieyohannan/github/circleci-docs/ with a relative or configurable path (e.g., the repository root) so the skill is portable.

Consider extracting the 10 review dimensions and/or the report template into reference files under ./references/ to keep SKILL.md a lean overview.

DimensionReasoningScore

Conciseness

Mostly efficient but the Example Usage section restates the Step 1-5 process and Important Notes repeats concepts already covered by the dimensions; the ~230-line body could be tightened.

3 / 5

Actionability

Provides concrete executable guidance — specific AGENTS.md path, :page-platform: check, Grep for related pages, 10 defined dimensions, a full report template, and a naming convention — but hardcoded /Users/rosieyohannan/... paths are brittle and non-portable.

4 / 5

Workflow Clarity

Steps 1-5 are clearly sequenced with an explicit fallback when related pages can't be found; as a read-only review it needs no destructive-validation checkpoint, though a 'verify the saved report exists' step is absent.

4 / 5

Progressive Disclosure

No bundle files exist; the body is a single well-organized SKILL.md with clear section headers and no nested references, so navigation is straightforward, though the 10 dimensions and report template could optionally be split into reference files.

4 / 5

Total

15

/

20

Passed

Description

91%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, well-scoped description with explicit what/when structure and rich natural trigger phrases. Minor overlap risk with generic documentation-quality skills keeps distinctiveness just below perfect.

DimensionReasoningScore

Specificity

Names the domain (CircleCI docs) and several concrete review actions — review, audit, assess, check style compliance, evaluate quality, give feedback — but all are variations on reviewing rather than a fully comprehensive action set.

4 / 5

Completeness

Clearly states what the skill does in the opening sentence and provides an explicit 'Use this skill whenever...' clause with concrete trigger phrases; written in third person.

5 / 5

Trigger Term Quality

Comprehensive natural-language triggers including 'review', 'audit', 'assess', 'style compliance', 'content quality', 'readability issues', and quoted user phrases like 'how does this page look' that users would actually say.

5 / 5

Distinctiveness Conflict Risk

Scoped to CircleCI documentation review with distinct triggers, but 'review/audit/assess documentation' could overlap with general doc-quality skills.

4 / 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.

Validation16 / 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.