CtrlK
BlogDocsLog inGet started
Tessl Logo

engram-cultural-norms

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

64

Quality

76%

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

85%

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

The body is concise, well-organized, and appropriately self-contained for a short norms skill, but its rules lean toward abstract principles over concrete, executable guidance.

DimensionReasoningScore

Conciseness

The body is lean and directive — short bulleted rules with no padding and no explanation of concepts Claude already knows — fitting 'Lean and efficient; assumes Claude's competence; every token earns its place'; it is not a 2 because there is no unnecessary explanation to tighten.

3 / 3

Actionability

A few rules give semi-concrete direction ("If a rule is organizational, enforce it on the server", "capture it as a skill or project convention"), but most are aphoristic principles ("Product coherence beats local cleverness", "Treat design, architecture, and business rules as one system"), fitting 'Some concrete guidance but incomplete... missing key details'; it is not a 1 because some directives are actionable, and not a 3 because the guidance is mostly abstract rather than copy-paste ready.

2 / 3

Workflow Clarity

This is a non-procedural norms skill (under 50 lines) whose content is clear and well-organized into labeled sections; per the simple-skills note, workflow_clarity can score 3 when content is clear and well-organized even without an explicit multi-step workflow, and no destructive/batch operations require validation checkpoints.

3 / 3

Progressive Disclosure

No bundle files are provided and none are needed; the single self-contained file is organized into well-signaled sections (When to Use, Cultural Rules, Collaboration Rules), and per the simple-skills note a sub-50-line skill with no need for external references scores 3 with just well-organized sections.

3 / 3

Total

11

/

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 answers both what and when with an explicit trigger clause, but its 'what' is abstract and its trigger terms are generic enough to risk overlap with broader development skills.

Suggestions

Add concrete actions to the 'what' clause (e.g., 'Defines and enforces coding, naming, and UX conventions for Engram') to lift specificity toward a 3.

Replace abstract triggers with concrete noun phrases a user would actually say (e.g., 'Use when setting Engram project conventions, reviewing PRs for product coherence, or scoping a new feature') to improve trigger-term quality.

Tie triggers more tightly to the Engram-specific niche (e.g., 'Engram conventions', 'product coherence review') to reduce conflict risk with generic development skills.

DimensionReasoningScore

Specificity

It names a clear domain ("Cultural and collaboration norms for Engram contributors and agents") but offers no concrete actions or verbs in the 'what' clause, matching 'Names domain and some actions, but not comprehensive'; it is not a 1 because the Engram scoping lifts it above pure vagueness, and not a 3 because no distinct concrete actions are listed.

2 / 3

Completeness

It answers both what (cultural/collaboration norms) and when, with an explicit "Trigger:" clause, matching 'Clearly answers both what AND when with explicit triggers'; it exceeds 2 because the when is explicit rather than implied, satisfying the 'Use when... or equivalent explicit trigger guidance' requirement.

3 / 3

Trigger Term Quality

The "Trigger: Starting substantial work, reviewing changes, or defining team conventions" phrases are relevant and partly natural (e.g., 'reviewing changes'), but they are abstract process terms missing common concrete variations, fitting 'Some relevant keywords but missing common variations' rather than the broad natural-term coverage of a 3.

2 / 3

Distinctiveness Conflict Risk

The Engram scoping gives it a niche, but generic trigger phrases like 'reviewing changes' and 'starting substantial work' overlap with many general development skills, fitting 'Somewhat specific but could still overlap with similar skills'; it is not a 3 because the triggers are not distinct enough to rule out conflicts.

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.