CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

engram-architecture-guardrails

Architecture guardrails for Engram across local store, cloud sync, dashboard, and plugins. Trigger: Any change that affects system boundaries, ownership, state flow, or cross-package responsibilities.

Quality

84%

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.

An exemplary lean guardrail skill: crisp sections, a concrete decision-routing table, and real validation checkpoints with no wasted tokens. The only meaningful upgrade would be making the Validation section as concrete as the Decision Rules — naming test commands or where regression tests live.

DimensionReasoningScore

Conciseness

Every line is directive with zero padding: "Local SQLite is the source of truth; cloud is replication and shared access", "Background orchestration -> internal/cloud/autosync". There is no explanation of concepts Claude already knows, no fluff, and nothing that could be cut without losing information — matching the 'lean and efficient; every token earns its place' anchor.

5 / 5

Actionability

The Decision Rules section gives a fully concrete, executable mapping ("Local-only concern -> internal/store", "HTTP contract or enforcement -> internal/cloud/cloudserver") that a developer or Claude can apply directly. However, the Validation section stays high-level ("Add regression tests for every boundary change") without naming test commands, locations, or examples, leaving minor gaps versus the fully concrete anchor.

4 / 5

Workflow Clarity

The structure gives a clear intake-to-verification flow: when to use -> guardrails -> decision routing -> validation, with real checkpoints ("test both push and pull paths", "verify local, remote, and dashboard behavior still tell the same product story"). It is not a multi-step sequence with an explicit validate-fix-retry loop, so it falls short of the level-5 anchor, but checkpoints are present and explicit rather than implicit.

4 / 5

Progressive Disclosure

The skill is under 50 lines, single-purpose, with no bundle files (references/, scripts/, assets/ are absent) and nothing that needs external detail. Per the rubric's simple-skill guidance, well-organized sections alone justify the top anchor: four clearly labeled sections (When to Use, Core Guardrails, Decision Rules, Validation) make navigation trivial.

5 / 5

Total

18

/

20

Passed

Description

73%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.

A strong, lean description with an explicit trigger clause and good domain anchoring. Its main weakness is the 'what' half: it names scope and subsystems but never states a concrete capability or action, leaving the description closer to a category label than an action list.

Suggestions

State one or two concrete actions in the description, e.g., 'Reviews and constrains architecture changes... routes each concern to the owning package', so the 'what' is actionable rather than a category.

Add natural user phrasings to the trigger — e.g., 'moving code between packages', 'refactoring sync', 'adding a new subsystem' — to widen keyword coverage toward the level-5 anchor.

DimensionReasoningScore

Specificity

The description names the domain concretely ("local store, cloud sync, dashboard, and plugins") and states what the skill provides ("Architecture guardrails"), but it lists no concrete actions — it describes scope rather than what the skill actually does (e.g., reviews changes, enforces boundaries, routes concerns). This matches the 'names domain and 1-2 concrete actions, but not comprehensive' anchor more than the level-4 'several specific actions' anchor.

3 / 5

Completeness

Both parts are present: the 'what' ("Architecture guardrails for Engram across...") and an explicit 'when' ("Trigger: Any change that affects..."). The trigger is explicit, but the 'what' is somewhat abstract — guardrails is a category, not an action — so it does not reach the level-5 anchor's fully concrete what+when pairing.

4 / 5

Trigger Term Quality

Trigger keywords are natural for a developer in this codebase: "system boundaries, ownership, state flow, cross-package responsibilities", plus "local store, cloud sync, dashboard, plugins". Coverage is good but misses common phrasings users would actually say (e.g., 'refactor', 'move code between packages', 'sync conflict'), so it sits between anchor 3 and 5 — closer to 4.

4 / 5

Distinctiveness Conflict Risk

The description is anchored to a named system (Engram) and its specific subsystems, with triggers (boundaries, ownership, cross-package responsibilities) that are distinct from generic coding skills. It would not fire for unrelated work, matching the 'clear niche with distinct triggers; minimal conflict risk' anchor.

5 / 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/architecture-guardrails/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.