CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

context-awareness

How the agent knows what the user is looking at. Use when exposing UI state to the agent, implementing view-screen or navigate actions, wiring navigation state, or debugging agent context issues.

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

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

This is a strong, high-signal skill body: it teaches framework-specific patterns Claude could not infer, with six executable, import-complete code examples and explicit key/import/header conventions, plus clear Do/Don't boundaries and jitter-prevention details. The only real costs are modest redundancy between the pattern sections and the summary lists, and long detailed subsections inlined in a single file rather than split into references.

DimensionReasoningScore

Conciseness

The body is dense with framework-specific facts Claude cannot know (state keys, import paths, header names, jitter-prevention semantics) and avoids generic-concept explanations, but the one-paragraph "Why" section and the Do/Don't lists partially restate points already made in the pattern sections (e.g., the navigation-vs-URL-query rule appears twice). Anchor 4 fits: efficient with minor trimming possible.

4 / 5

Actionability

Six complete, executable TypeScript examples with real imports cover the common cases end to end: useNavigationState wiring, agent-side readAppState, tab-scoped selection writes, the Select registry hooks, the view-screen action, the navigate command, and useDbSync configuration. Specific key names, constants, and header values make the guidance copy-paste ready, matching anchor 5.

5 / 5

Workflow Clarity

Each pattern clearly separates the UI side from the agent side and sequences the write/read/command/consume flow, and no destructive or batch operations are involved so no validation cap applies. It falls short of anchor 5 because there is no explicit guidance ordering when to choose view-screen versus reading state directly beyond scattered Do/Don't entries, and no error-recovery checkpoints.

4 / 5

Progressive Disclosure

The skill is a single self-contained file with no bundle directories; sections are well-organized with clear headers, focused pattern sections, and a Related Skills index, so structure is good per anchor 4. It is not anchor 5 because detailed subsections (picked objects/Select, the settings-view shell) are inlined at a length that could eventually justify one-level-deep reference files if the skill grows.

4 / 5

Total

17

/

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.

The description is well-formed: it answers both what the skill covers and when to use it, with a concrete four-trigger "Use when" clause and framework-specific vocabulary that keeps it distinct. The main weakness is that the capability ("what") side is expressed as a conceptual purpose statement while the concrete actions live only in the trigger clause, leaving specificity slightly below comprehensive.

DimensionReasoningScore

Specificity

The trigger clause lists several concrete actions ("exposing UI state to the agent, implementing view-screen or navigate actions, wiring navigation state, or debugging agent context issues"), but the lead sentence "How the agent knows what the user is looking at" is a conceptual purpose statement rather than a named action, so coverage is strong but not comprehensive.

4 / 5

Completeness

Both parts are explicit: the what ("How the agent knows what the user is looking at") and a concrete "Use when..." clause with four specific triggers (exposing UI state, implementing view-screen or navigate actions, wiring navigation state, debugging agent context issues). The when-clause is more explicit and specific than the anchor-4 example, so anchor 5 fits best.

5 / 5

Trigger Term Quality

Terms like "UI state", "navigation state", "view-screen", "navigate actions", and "agent context" are natural phrases a developer on this framework would say, matching the anchor-4 example of good keyword coverage; no synonyms or common variations are offered, keeping it below anchor 5.

4 / 5

Distinctiveness Conflict Risk

Framework-specific terms ("view-screen", "navigate actions", "navigation state") carve a clear niche with minimal conflict risk, though "implementing view-screen or navigate actions" could mildly overlap with a general actions-creation skill, matching anchor 4 rather than 5.

4 / 5

Total

17

/

20

Passed

Validation

81%

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

Validation — 13 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

metadata_version

'metadata.version' is missing

Warning

metadata_field

'metadata' should map string keys to string values

Warning

frontmatter_unknown_keys

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

Warning

Total

13

/

16

Passed

Repository

BuilderIO/agent-native

Path

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