CtrlK
BlogDocsLog inGet started
Tessl Logo

engram-docs-alignment

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

69

Quality

83%

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 content is an exemplar of a lean, well-structured instruction-only policy skill: concise rules paired with an explicit verification checklist and clean sectioning, with no wasted tokens.

DimensionReasoningScore

Conciseness

The body is lean and directive with no concept over-explanation or padding — every line is a rule or checklist item, matching 'lean and efficient; every token earns its place'.

3 / 3

Actionability

Concrete directives ("Update docs in the same PR as the code change", "Remove references to deprecated files, endpoints, or scripts") plus a specific verification checklist give actionable guidance; for an instruction-only skill the absence of code is not penalized.

3 / 3

Workflow Clarity

The numbered Alignment Rules and explicit Verification checklist provide clear validation checkpoints, and per the simple-skills note a clear single-purpose skill can score 3 without a multi-step workflow.

3 / 3

Progressive Disclosure

The skill is under 50 lines with well-organized sections (When to Use, Alignment Rules, Verification) and needs no external references, satisfying the simple-skill exception for a top score.

3 / 3

Total

12

/

12

Passed

Description

67%

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 provides both a purpose and a trigger, but its capability statement is abstract and the trigger phrasing is broad rather than rich with natural user keywords.

Suggestions

Replace the abstract "alignment rules" with a short list of concrete actions (e.g., update docs in the same PR, validate examples, remove deprecated references) to lift specificity.

Add natural user-language trigger terms such as "docs", "API change", or "documentation update" alongside "code or workflow change" to improve trigger term quality.

Tighten the trigger so it is more specific to documentation alignment and less likely to fire for unrelated project changes, reducing conflict risk.

DimensionReasoningScore

Specificity

"Documentation alignment rules for Engram" names a concrete domain and an action category, but does not list multiple specific actions, matching the 'names domain and some actions, but not comprehensive' anchor.

2 / 3

Completeness

It explicitly answers both what ("Documentation alignment rules for Engram") and when (an explicit "Trigger:" clause), and the rubric only caps at 2 when trigger guidance is missing — which it is not. Not below 3 because the when is explicit rather than implied.

3 / 3

Trigger Term Quality

The "Trigger: Any code or workflow change that affects user or contributor behavior" clause supplies some relevant terms ("code change", "workflow change") but omits common natural variations a user would say ("docs", "API change", "documentation"), matching 'some relevant keywords but missing common variations'.

2 / 3

Distinctiveness Conflict Risk

It is scoped to the Engram documentation niche, but the trigger "Any code or workflow change that affects user or contributor behavior" is broad and could overlap with other project skills, matching 'somewhat specific but could still overlap'.

2 / 3

Total

9

/

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