CtrlK
BlogDocsLog inGet started
Tessl Logo

024-context-mapping

Use when a problem under exploration needs its surrounding system context identified before design begins — Existing systems, Integrations, Ownership, and External dependencies. This should trigger when an issue's Context Mapping point of view needs evaluation, or when a maintainer directly asks to map the systems, integrations, owners, and external dependencies relevant to a problem. Part of Plinth Toolkit

65

Quality

82%

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

71%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, appropriately disclosed instruction-only skill with a clear workflow and genuinely actionable MUST/MUST NOT constraints. Its main weakness is redundancy: the core lens list is repeated three to four times across sections, costing tokens without adding guidance.

Suggestions

Collapse the duplicated lens lists: state the four categories once (e.g., in the intro or Constraints) and let the What-is-covered bullets and Workflow steps reference them instead of restating each item nearly verbatim.

Remove the redundancy between "What is covered in this Skill?" and the Constraints MUSTs — merge them into one section, keeping the MUST NOT anti-invention rule as the only separately flagged constraint.

Add a short inline skeleton of the final context-map report (Existing systems / Integrations / Ownership / External dependencies / open questions) to step 6 so the report format is concrete without loading the reference file.

DimensionReasoningScore

Conciseness

The five lens items (existing systems, integrations, ownership, external dependencies) are repeated nearly verbatim three times — in the intro line, the "What is covered" bullets, and the Constraints MUSTs — and restated a fourth time in the Workflow steps; the body is mostly efficient but this duplication should be tightened, matching anchor 3 rather than anchor 4's "minor instances".

3 / 5

Actionability

As an instruction-only skill the guidance is concrete and executable ("including systems that are affected but not expected to change", "flag the gap for a clarifying question instead"), with only minor gaps such as no inline example of what a finished context-map report looks like — anchor 4 rather than 5.

4 / 5

Workflow Clarity

Six clearly numbered steps run from reading the reference to reporting results with "flag any item left open pending a clarifying answer" as a checkpoint; this is a non-destructive analysis skill so the validation cap does not apply, and the sequence matches anchor 4's "most checkpoints present" with minor validation gaps rather than anchor 5's explicit validate-and-retry loop.

4 / 5

Progressive Disclosure

The body is a clear overview with a single, real, one-level-deep reference (references/024-context-mapping.md) that is well signaled both by a markdown link in a Reference section and a MUST-read constraint in the workflow — fully matching anchor 5.

5 / 5

Total

16

/

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 that explicitly answers both what and when with concrete trigger phrases and a well-scoped niche. Its weaknesses are the jargon-heavy middle trigger sentence and slightly limited verb variety plus missing synonyms like "system boundaries".

DimensionReasoningScore

Specificity

The description lists several specific action objects — "map the systems, integrations, owners, and external dependencies relevant to a problem" — but relies on a limited set of verbs (identify, map, evaluate) and omits actions the body covers (e.g., feeding findings into 025-quality-attribute-discovery), leaving minor gaps that fall short of the comprehensive anchor 5.

4 / 5

Completeness

Both what and when are explicitly and concretely stated: the what names the four deliverable categories (Existing systems, Integrations, Ownership, External dependencies), and two concrete trigger conditions follow ("when an issue's Context Mapping point of view needs evaluation, or when a maintainer directly asks to map…"), matching anchor 5 rather than the less-explicit anchor 4.

5 / 5

Trigger Term Quality

Natural phrases like "map the systems, integrations, owners, and external dependencies" are present, but "an issue's Context Mapping point of view needs evaluation" is jargon users would not naturally say, and synonyms such as "system boundaries" or "data flows" are missing — good coverage with a few natural terms absent, matching anchor 4 rather than 5.

4 / 5

Distinctiveness Conflict Risk

The description carves a clear niche (Context Mapping point of view, Plinth Toolkit, sibling skill 025-quality-attribute-discovery) with distinct triggers, but "map the systems… around a problem" could still overlap with generic architecture-mapping skills, matching the minor-overlap anchor 4.

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
jabrena/plinth
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.