CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

context-and-decisions

Govern stable domain context with a narrowly scoped CONTEXT.md when needed, and route hard-to-reverse decisions to ECC's existing architecture-decision-records skill. Use when domain terms require repeated explanation, one term has multiple meanings, unclear language causes module-boundary mistakes, or domain semantics must remain separate from architecture decisions.

Quality

77%

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 ./.agents/skills/context-and-decisions/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

60%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 well-structured, instruction-only governance skill with a clear scope boundary and concrete routing rules. Its main weaknesses are redundancy across activation/usage sections and a missing key artifact (the referenced CONTEXT.md template, with no inline example to substitute), which keeps actionability from being fully executable. Sequencing is clear and anti-patterns are well chosen.

Suggestions

Merge 'When to Activate' and 'When to Use' into a single activation section; they restate the same triggers almost verbatim.

State the task/schedule boundary once — it currently appears in the 'Do not include' list, 'How It Works' step 4, and the entire 'Scheduling and Task Boundary' section.

Ship `templates/context.example.md` in the bundle or include a short inline example of a CONTEXT.md entry (term, definition, relationships, a `needs confirmation` ambiguity) so the creation step is executable as written.

DimensionReasoningScore

Conciseness

Individually the sections are lean and assume Claude's competence (no basic concepts re-explained), but the same rules are repeated: 'When to Activate' and 'When to Use' restate the same triggers, and the keep-schedules-in-the-tracker boundary appears three times ('Keep those in code/MAP, STATUS/Issue Tracker...', 'Keep schedules, blockers, and execution status in the existing issue tracker', and the entire 'Scheduling and Task Boundary' section). This is 'mostly efficient but could be tightened' rather than anchor 2's padded explanations of known concepts.

3 / 5

Actionability

Much of the guidance is concrete (reuse 'the `context` role in `.governance/docs-map.json`', 'lazily create the default `CONTEXT.md` from `templates/context.example.md`', 'Mark unconfirmed items as `needs confirmation`'), but the core creation step depends on `templates/context.example.md`, which is not present in this bundle, and no inline example of a CONTEXT.md entry or its format is given. Per the scoring notes, absent code is not penalized per se, but a key executable detail is missing, matching anchor 3 ('some concrete guidance but incomplete; missing key details') rather than anchor 4's 'minor gaps'.

3 / 5

Workflow Clarity

'How It Works' and the 'ADR Handoff' section give clear numbered sequences, and there are implicit checkpoints ('Terms must be traceable to code, contracts, or business evidence', 'Mark unconfirmed items as `needs confirmation`; do not guess'). No destructive or batch operation is involved, so no validation cap applies, but the checkpoints are verification rules rather than explicit validate-and-fix loops — anchor 4 ('clear sequence with most checkpoints present; minor validation gaps'), not anchor 5.

4 / 5

Progressive Disclosure

No bundle files exist (no references/, scripts/, assets/), and the body is well organized into focused sections under clear headers, so it scores on its own structure. It is above the simple-skill exception line (~70 lines, not under 50), and it points to external artifacts (`templates/context.example.md`, `architecture-decision-records`) that are inline mentions rather than clearly signaled one-level-deep references, and the referenced template is absent from the bundle — anchor 4 ('good structure; most content appropriately placed; references mostly clear; minor organization gaps') rather than anchor 5.

4 / 5

Total

14

/

20

Passed

Description

83%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 description: third-person voice, explicit 'Use when' triggers with multiple concrete conditions, and artifact-level specificity for both capabilities. Its weaknesses are minor — a few missing natural synonyms (glossary, terminology, domain model) and slight trigger overlap with the architecture-decision-records skill it defers to.

DimensionReasoningScore

Specificity

The description names two concrete, artifact-level actions — 'Govern stable domain context with a narrowly scoped CONTEXT.md when needed' and 'route hard-to-reverse decisions to ECC's existing architecture-decision-records skill'. Two actions alone sit at anchor 3 ('1-2 concrete actions'), but each is specific down to named artifacts and scope limits, placing it noticeably above that midpoint and into anchor 4 territory; it is not anchor 5 because the two actions do not comprehensively cover the skill's sub-behaviors (reuse existing glossary, record ambiguities, link ADRs).

4 / 5

Completeness

Both halves are explicit: 'what' — governing domain context via a narrowly scoped CONTEXT.md and routing hard-to-reverse decisions to the ADR skill — and 'when' — an explicit 'Use when domain terms require repeated explanation, one term has multiple meanings, unclear language causes module-boundary mistakes, or domain semantics must remain separate from architecture decisions' clause with four concrete trigger conditions. This matches anchor 5 ('clearly and explicitly answers both what AND when with concrete trigger phrases').

5 / 5

Trigger Term Quality

The 'Use when' clause offers natural phrases a user would plausibly say: 'domain terms require repeated explanation', 'one term has multiple meanings', 'unclear language causes module-boundary mistakes'. Good coverage, but common synonyms like 'glossary', 'terminology', 'ubiquitous language', 'domain model', or 'business terms' are missing, so it fits anchor 4 ('good keyword coverage; a few natural terms missing') rather than anchor 5's comprehensive synonym/extension coverage; it is well above anchor 3 because several distinct natural trigger conditions are given.

4 / 5

Distinctiveness Conflict Risk

The niche is distinct — domain-language governance explicitly separated from decision records ('domain semantics must remain separate from architecture decisions') — and the 'when' triggers are all domain-language-specific. Minor overlap risk remains: the what-clause mentions routing 'hard-to-reverse decisions', so a decision-recording query could partially match this skill instead of going straight to architecture-decision-records, and 'context' is itself a broad word. Anchor 4 ('mostly distinct; minor overlap risk with closely related skills'), not anchor 5's minimal conflict risk.

4 / 5

Total

17

/

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

affaan-m/ECC

Path

.agents/skills/context-and-decisions/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.