CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

engram-docs-alignment

Documentation alignment rules for Engram. Trigger: Any code or workflow change that affects user or contributor behavior.

Quality

85%

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 lean, well-structured instruction-only skill: terse rules, explicit trigger conditions, and a concrete verification checklist with no wasted tokens. The only gap is that validation and verification steps describe what to check but not how to check it.

DimensionReasoningScore

Conciseness

The ~25-line body contains zero explanations of concepts Claude already knows; every line is a rule, a trigger condition, or a verification check. This matches anchor 5 ('lean and efficient; every token earns its place').

5 / 5

Actionability

Rules are directive and concrete ("Update docs in the same PR as the code change", "Validate examples before publishing") and the verification checklist gives specific checks. However, no commands or examples show how to validate examples or execute the checks, so it falls short of anchor 5's copy-paste-ready guidance; well above anchor 3's incomplete/pseudocode level.

4 / 5

Workflow Clarity

This is a simple rule-set skill, not a sequential process: it has clear trigger conditions and an explicit verification checklist ("Endpoint names match server routes", "Command examples execute as documented"), so checkpoints are present rather than implicit. It lacks a stated order of operations, keeping it below anchor 5; it exceeds anchor 3 because the checklist provides real validation checkpoints.

4 / 5

Progressive Disclosure

Under 50 lines with no external content needed and no bundle files (no references/, scripts/, or assets/ exist); the three sections (When to Use, Alignment Rules, Verification) are well-organized. Per the rubric's simple-skill note, this qualifies for anchor 5.

5 / 5

Total

18

/

20

Passed

Description

78%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 concise, in third person, and explicitly pairs a clear what with a labeled, concrete trigger clause. Its main weakness is specificity: it states the domain and purpose but does not enumerate the concrete alignment actions the skill actually performs.

Suggestions

List 2-3 concrete actions in the description (e.g., 'update docs in the same PR as code changes, validate command examples, remove references to deprecated endpoints') to raise specificity from domain-naming to action-enumeration.

Add natural trigger phrasings users would say, such as 'docs update', 'README', 'changelog', or 'update documentation after a code change', to broaden keyword coverage.

Tighten the trigger scope (e.g., 'any Engram code or workflow change that alters user- or contributor-facing behavior') to reduce overlap risk with generic documentation skills.

DimensionReasoningScore

Specificity

"Documentation alignment rules for Engram" names the domain and a single concrete action (aligning docs), but does not enumerate the specific actions the skill performs (e.g., updating docs in the same PR, validating examples). Fits anchor 3 (names domain and 1-2 concrete actions) better than anchor 4's 'several specific actions'.

3 / 5

Completeness

Explicitly answers both: what ("Documentation alignment rules for Engram") and when ("Trigger: Any code or workflow change that affects user or contributor behavior"). The trigger clause is labeled and more concrete than anchor 4's generic 'when', matching anchor 5's explicit what-and-when with concrete trigger conditions.

5 / 5

Trigger Term Quality

"Any code or workflow change that affects user or contributor behavior" plus "Documentation" give good natural keyword coverage. Missing common variations users would say (e.g., "update the docs", "README", "changelog"), so below anchor 5's comprehensive synonym coverage.

4 / 5

Distinctiveness Conflict Risk

Scoping to a named product ("Engram") establishes a clear niche with low conflict risk, but the broad trigger ("any code or workflow change") could overlap with other docs or maintenance skills. Mostly distinct with minor overlap risk, matching anchor 4.

4 / 5

Total

16

/

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

Gentleman-Programming/engram

Path

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