CtrlK
BlogDocsLog inGet started
Tessl Logo

cognitive-doc-design

Design docs that reduce cognitive load. Trigger: writing guides, READMEs, RFCs, onboarding, architecture, or review-facing docs.

74

Quality

91%

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

100%

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

The body is lean, well-structured, and immediately actionable through a copy-paste template and concrete git/gh commands, with no padding or unnecessary concept explanations. It fully satisfies the rubric across all four content dimensions.

DimensionReasoningScore

Conciseness

The body uses compact tables, a copy-paste markdown template, and bullet lists without explaining concepts Claude already knows, matching the 'Lean and efficient; every token earns its place' anchor rather than the padded score 2 example.

3 / 3

Actionability

It provides a copy-paste-ready markdown template and two concrete executable commands ('git diff --name-only -- *.md' and 'gh pr view <PR_NUMBER> --json additions,deletions,changedFiles'), matching the 'Fully executable code/commands; copy-paste ready' anchor.

3 / 3

Workflow Clarity

The default template gives a sequenced Quick path (First action, Second action, Verification) plus a Checklist, and there are no destructive/batch operations requiring validation; per the simple-skills note, clear well-organized content scores 3.

3 / 3

Progressive Disclosure

The body is under 50 lines with no bundle files and no need for external references, organized into well-signaled sections (When to Use, Critical Patterns, Documentation Shape, PR and Review Docs, Commands), meeting the simple-skills exception for score 3 on organization alone.

3 / 3

Total

12

/

12

Passed

Description

82%

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 concise and explicitly answers both what it does and when to use it with natural trigger terms. Its main weakness is that capabilities are stated at a high level and the broad documentation scope could overlap with other writing skills.

Suggestions

Add 1-2 more concrete capabilities (e.g., 'restructure dense sections into scannable layouts, write review-facing PR descriptions') to lift specificity from 2 to 3.

Narrow the trigger scope or add a distinguishing phrase so it is less likely to conflict with generic documentation/writing skills.

DimensionReasoningScore

Specificity

Quotes 'Design docs that reduce cognitive load' and a list of doc types name the domain and a concrete action, but do not enumerate multiple distinct concrete capabilities, matching the 'Names domain and some actions, but not comprehensive' anchor rather than the multi-action score 3.

2 / 3

Completeness

It answers what ('Design docs that reduce cognitive load') and when via an explicit 'Trigger:' clause, matching the score 3 anchor that requires both what and explicit triggers; the presence of an explicit trigger clause means it is not capped at 2.

3 / 3

Trigger Term Quality

'Trigger: writing guides, READMEs, RFCs, onboarding, architecture, or review-facing docs' provides strong coverage of natural terms a user would actually say, matching the score 3 anchor for good keyword coverage.

3 / 3

Distinctiveness Conflict Risk

The cognitive-load framing is a distinct niche, but the broad 'docs' domain could still overlap with general writing/documentation skills, matching the score 2 'Somewhat specific but could still overlap' anchor rather than a clearly non-conflicting score 3.

2 / 3

Total

10

/

12

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
Gentleman-Programming/gentle-ai
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.