CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

engram-cultural-norms

Cultural and collaboration norms for Engram contributors and agents. Trigger: Starting substantial work, reviewing changes, or defining team conventions.

Quality

73%

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

Fix and improve this skill with Tessl

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

Quality

Content

78%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 whose norms are stated as crisp, specific directives without any padding. Its main weakness is actionability: the judgment rules hinge on undefined terms ('fake UX', 'generic enterprise UI drift') and provide no examples of what applying or violating a norm looks like in practice.

Suggestions

Add one-line definitions or a canonical example for each judgment term — e.g., what qualifies as 'fake UX and fake controls' or 'generic enterprise UI/architecture drift' — so the rules can be applied consistently.

Add a short 'when rules conflict' or 'during review' checkpoint (e.g., 'when reviewing, check changes against each Cultural Rule before approving') to turn the norms into an executable sequence.

Optionally show one worked example (a change that follows the norms vs. one that violates them) to make the abstract rules concrete.

DimensionReasoningScore

Conciseness

The body is ~26 lines of terse, dense directives with zero padding and no explanation of concepts Claude already knows. Every rule ("If a rule is organizational, enforce it on the server") carries information, matching 'Lean and efficient; every token earns its place'.

5 / 5

Actionability

Rules like "If a pattern repeats, capture it as a skill or project convention" and "If a rule is organizational, enforce it on the server" are concrete behavioral directives, but key terms are undefined — 'fake UX and fake controls', 'generic enterprise UI/architecture drift', and what a 'substantial' change is are left to guesswork, and there are no examples of rule violations or correct application. This is 'some concrete guidance but incomplete; missing key details' rather than the mostly-executable level of 4.

3 / 5

Workflow Clarity

The 'When to Use' section gives explicit use conditions and the rules are a simple flat checklist with no risky multi-step process, so the simple-skill pattern applies; the single action (apply these norms during the listed activities) is unambiguous. It does not reach 5 because there is no guidance on what to do when rules conflict or when a review finds a violation — a light decision/checkpoint step would complete it.

4 / 5

Progressive Disclosure

The skill is under 50 lines with no external references needed, and the content is cleanly split into three well-organized sections (When to Use, Cultural Rules, Collaboration Rules) with no inline content that belongs in a separate file. Per the rubric's simple-skill guideline, this warrants 5 on well-organized sections alone.

5 / 5

Total

17

/

20

Passed

Description

53%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 has a clean two-part structure with an explicit Trigger clause, uses third person, and is concise, but it describes a topic rather than concrete capabilities. Its strongest aspect is a domain-specific niche (Engram); its weakest are the absence of stated actions and trigger phrases that users would not naturally utter.

Suggestions

Replace the topical 'what' with 2-3 concrete capabilities, e.g., 'Apply Engram cultural and collaboration norms when starting features, reviewing implementations, or writing project conventions'.

Use natural trigger phrasing a contributor would actually say (e.g., 'starting a new feature or refactor', 'reviewing a PR', 'writing project conventions') instead of 'starting substantial work'.

Tighten distinctiveness by pairing each trigger with the Engram context (e.g., 'reviewing Engram changes') to reduce overlap with generic code-review skills.

DimensionReasoningScore

Specificity

The description names the domain clearly ("Cultural and collaboration norms for Engram contributors and agents") but lists no concrete actions or capabilities — it states what the skill is about, not what it does. It matches the anchor 'Names the domain but actions are minimal or generic'; it does not reach 3 because not even one concrete action (e.g., 'apply', 'check', 'enforce') is stated.

2 / 5

Completeness

Both parts are present: a 'what' ("Cultural and collaboration norms for Engram contributors and agents") and an explicit 'when' ("Trigger: Starting substantial work, reviewing changes, or defining team conventions"), which satisfies the explicit-trigger requirement. It falls short of 5 because the 'what' is a topical label rather than a concrete capability statement, so it doesn't 'clearly and explicitly answer both' at the level of the 5-anchor examples.

4 / 5

Trigger Term Quality

The trigger clause includes some natural phrases ("reviewing changes", "defining team conventions") but misses common variations and synonyms users would actually say — "starting substantial work" is not phrasing a user naturally produces, and there are no equivalents of synonyms or file-extension-style discriminators. This sits at 'Some relevant keywords but missing common variations or synonyms' rather than 4's 'good keyword coverage'.

3 / 5

Distinctiveness Conflict Risk

The 'Engram contributors and agents' framing carves out a clear niche with minimal overlap against generic skills, and 'defining team conventions' is a fairly distinct trigger. However, 'Starting substantial work' and 'reviewing changes' are broad phrases that could overlap with code-review or project-setup skills, keeping it below the 'clear niche with distinct triggers' of a 5 — this is 'mostly distinct; minor overlap risk'.

4 / 5

Total

13

/

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/cultural-norms/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.