CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

realign

Project guide direction line via three-horizon fusion. Invoke with /realign.

Quality

51%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Low

Low-risk findings worth noting

Fix and improve this skill with Tessl

tessl review fix ./epistemic-cooperative/skills/realign/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

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

The body's greatest strength is workflow clarity — the phased protocol, approval gates, rollback, and loop bounds are explicit and well-guarded for a destructive write. However, it is heavily padded (the same protocol restated in five notations and disciplines repeated across three sections), its notation is undefined, and it is a monolithic single file with no progressive disclosure and no worked examples.

Suggestions

Collapse the FLOW, MORPHISM, PHASE TRANSITIONS, and TOOL GROUNDING blocks into a single canonical workflow description (or move them to a reference file) — four restatements of the same protocol are the largest source of wasted tokens.

Define or eliminate the undefined notation (Qc, Λ, TextPresent+Proceed, Stop) on first use, since readers must currently guess its meaning.

Add one short worked example of a fusion candidate with its per-horizon Preserved/Transformed/Dropped trace to make the skill's core artifact concrete, and move the Distinction table plus Storage Reference into a reference file.

DimensionReasoningScore

Conciseness

The same workflow is presented five times (Phase prose, FLOW, MORPHISM, PHASE TRANSITIONS, TOOL GROUNDING blocks), and each discipline (fusion-over-addendum, pre-understanding elicitation, self-referential consistency) is restated three to four times across Definition, Rules, and UX Safeguards. Anchor 2 fits (noticeably verbose, padded sections); not 1 because the padding is redundant domain protocol rather than explanation of concepts Claude already knows; not 3 because the redundancy is pervasive rather than occasional.

2 / 5

Actionability

The Constitution interaction templates (shaping options 1–6, approval options 1–4) are given verbatim and are copy-paste ready, but the scanning and composing steps remain abstract ("Search the project's substrate", "aggregate the direction-bearing signals") and there is no worked example of a fused line or per-horizon trace. Anchor 3 (some concrete guidance but incomplete); not 4 because key executable details are missing, not 2 because the prompts themselves are concrete.

3 / 5

Workflow Clarity

The Phase 0→3 sequence is explicit with per-phase user gates, an Approve-only gate on the destructive project-guide write, a rollback path, iteration caps with escape hatches, and enumerated dispositions — strong validation for a destructive operation. Not 5 because the notation used throughout (Qc, Λ, TextPresent+Proceed, Stop) is never defined, forcing the reader to infer it; not 3 because validation checkpoints for the write are explicit, so the destructive-operation cap does not apply.

4 / 5

Progressive Disclosure

The body has navigable ## sections but is a ~290-line monolithic file with no bundle files at all; the large formal-notation block (FLOW/MORPHISM/TYPES/TOOL GROUNDING) is inlined where a reference file would serve, and the distinction table and storage reference could likewise be split out. Anchor 3 (some structure, content that should be separate is inline); not 2 because structure is present and headers make it navigable; not 4 because nothing is split into references.

3 / 5

Total

12

/

20

Passed

Description

32%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 too terse to do its job: it names a niche domain but specifies no concrete actions, no trigger conditions, and no natural keywords. Its only strengths are distinctiveness and the explicit invocation token.

Suggestions

State concrete actions in third person, e.g., "Scans the project guide's inscribed direction line, external work signals, and the user's current sense of the project; proposes a fused direction line with a per-horizon trace and writes it back on approval."

Add an explicit trigger clause: "Use when the project guide's direction line no longer matches recent work, or when the user asks to re-derive or update the project direction."

Include natural keyword variants users would say ("project direction", "direction line", "northstar", "mission statement") so the skill surfaces from ordinary phrasing, not just /realign.

DimensionReasoningScore

Specificity

"Project guide direction line via three-horizon fusion" names a specific domain but contains no action verbs — "three-horizon fusion" is jargon, not a concrete action. It sits at anchor 2 (domain named, actions minimal/generic) rather than 3 because zero concrete actions are listed, and not 1 because the domain is named, not entirely vague.

2 / 5

Completeness

The "what" is a vague noun phrase with no verb, leaving unclear whether the skill reads, proposes, or writes; "Invoke with /realign" is invocation syntax, not a trigger condition, so the "when" is absent. This matches anchor 2 (vague what, no when) rather than 3, which requires a clear what.

2 / 5

Trigger Term Quality

The only candidate keywords are "project guide" and "direction line" — one or two generic terms with no natural phrases a user would actually say (e.g., "update the project direction", "direction is stale"). Not 1 because the terms aren't pure technical jargon; not 3 because no synonyms or variations appear at all.

2 / 5

Distinctiveness Conflict Risk

The niche target ("project guide direction line") plus the explicit "/realign" invocation token make conflict unlikely, with only minor overlap risk against adjacent abstraction/guide skills. Not 5 because the description provides no trigger phrases that establish the distinct niche on its own.

4 / 5

Total

10

/

20

Passed

Validation

93%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

15

/

16

Passed

Repository

jongwony/epistemic-protocols

Path

epistemic-cooperative/skills/realign/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.