context-map

Maps file dependencies, flags shared imports, groups files for safe parallel editing before code changes. Use when planning a refactoring, analyzing change impact, or understanding which files a modification will affect.

Quality

89%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

Securityby

Passed

No findings from the security scan

Quality

Content

90%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, token-efficient body with executable commands and a clear sequenced workflow plus a validation checkpoint. The main gaps are a missing error-recovery feedback loop and a referenced REFERENCE.md that does not exist in the bundle.

Suggestions

Add a brief fix-and-retry step after the validation checkpoint (e.g. "if a listed file fails to open, re-trace its imports and update the map").

Create the referenced ./REFERENCE.md (or remove the link) so the one-level-deep reference resolves to a real file.

Dimension	Reasoning	Score
Conciseness	Lean throughout: terse table, compact ripgrep snippets, and a compact map template with no padding or explanation of concepts Claude already knows.	5 / 5
Actionability	Provides copy-paste-ready ripgrep commands and a concrete filled-in map template that cover the common tracing cases directly.	5 / 5
Workflow Clarity	Steps 1–4 are clearly sequenced with an explicit validation checkpoint, but there is no fix-and-retry feedback loop describing what to do when the checkpoint fails.	4 / 5
Progressive Disclosure	Good structure with overview inline and a clearly signaled one-level reference to REFERENCE.md for deeper detail, but the referenced REFERENCE.md file is not present in the bundle, slightly weakening navigation.	4 / 5
	Total	18 / 20 Passed

Description

88%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, concrete description that clearly answers both what the skill does and when to use it, with multiple specific actions and natural trigger phrases. The only weakness is minor overlap risk with broader refactoring/planning skills.

Suggestions

Add a distinguishing shorthand term (e.g. "blast-radius" or "impact map") to the trigger clause to widen synonym coverage and reduce overlap with generic refactoring skills.

Dimension	Reasoning	Score
Specificity	Lists multiple concrete actions — "Maps file dependencies, flags shared imports, groups files for safe parallel editing" — giving comprehensive coverage of capabilities rather than vague language.	5 / 5
Completeness	Explicitly states what it does (map dependencies, flag imports, group files) and when to use it via a concrete "Use when..." clause with multiple trigger scenarios.	5 / 5
Trigger Term Quality	Natural trigger phrases like "planning a refactoring", "analyzing change impact", and "which files a modification will affect" are present, but synonym coverage is good rather than exhaustive (no shorthand like "impact map" or "blast radius").	4 / 5
Distinctiveness Conflict Risk	The pre-change file-impact-mapping niche is fairly distinct, but the triggers (refactoring, change impact) overlap somewhat with general refactoring or planning skills.	4 / 5
	Total	18 / 20 Passed

Validation

93%

Warnings & errors only

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

Criteria	Description	Result
relative_links	Relative link issues: 1 missing	Warning

	Total	15 / 16 Passed

Repository: monkilabs/opencastle
Path: src/orchestrator/skills/context-map/SKILL.md
Commit: f297837

Reviewed: 6 days ago

Table of Contents

Discovery Implementation Validation

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.