CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

session-crosslink

Use when an agent session ran outside the repo whose commits should record it — e.g. launched from a higher-level folder, a non-Entire repo, or one repo but editing another — to attach the session to each affected Entire-enabled repo's HEAD commit.

70

Quality

88%

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

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

An exemplary operational skill: concrete commands throughout, a hard preview-then-confirm gate before a destructive multi-repo operation, per-repo error handling, and no padding. The only refinements available are trimming a few rationale asides and optionally moving the runtime-specific transcript lookup out of the main flow.

DimensionReasoningScore

Conciseness

The body is dense, procedural, and assumes competence — no explaining of git or what session tracking is, with every section carrying operational rules or commands. The short 'Why this skill exists' section and a few explanatory asides in Steps 2-3 (e.g. the rationale for keeping misconfigured candidates) are trimmable, matching anchor 4's 'minor instances of over-explanation'.

4 / 5

Actionability

Guidance is fully executable: exact commands ('entire session current --json', the git rev-parse/log/grep trailer extraction, 'cd <repo> && entire session attach <session-id> --agent <agent> --force'), concrete keep/drop decision rules per candidate, and exact output formats including the preview table and failure messages. This matches anchor 5's copy-paste-ready commands covering the common cases.

5 / 5

Workflow Clarity

A clear five-step sequence with strong validation for a destructive batch operation: the STOP rules mandate preview-before-attach, Step 4 requires explicit user confirmation, Step 5 captures exit status per repo, and the Failure modes section defines recovery (no auto-retry, idempotent re-runs, surfaced stderr). This satisfies the batch/destructive feedback-loop requirement at anchor 5.

5 / 5

Progressive Disclosure

No bundle files exist (references/, scripts/, assets/ are absent) and the body references none, so everything lives in a single well-sectioned file (~137 lines). All of the inline content is runtime-needed procedure rather than material that clearly belongs in a separate file, so structure is good with only minor organization gains possible (e.g. splitting the runtime-transcript lookup details into a reference) — anchor 4.

4 / 5

Total

18

/

20

Passed

Description

82%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 with an explicit 'Use when...' clause carrying three concrete trigger scenarios and a clear statement of the core action. Its only weakness is that the what-side covers just the final attach action, omitting the discovery and preview steps that make up most of the skill.

Suggestions

Add a brief mention of the full capability set in the what-clause, e.g. '...discovers affected repos, previews the resulting HEAD-commit changes, and attaches the session on confirmation', to lift specificity.

Consider one or two user-natural synonyms for the triggers, such as 'wrong directory' or 'parent folder', to broaden trigger term coverage.

DimensionReasoningScore

Specificity

The description names the domain and one concrete action — "to attach the session to each affected Entire-enabled repo's HEAD commit" — but the discovery and preview-then-confirm work that dominates the skill is not mentioned, so coverage is not comprehensive. It sits at anchor 3 (1-2 concrete actions) rather than 4, which expects several specific actions listed.

3 / 5

Completeness

It explicitly answers both parts: "Use when an agent session ran outside the repo whose commits should record it — e.g. launched from a higher-level folder, a non-Entire repo, or one repo but editing another" (when, with concrete triggers) and "attach the session to each affected Entire-enabled repo's HEAD commit" (what). This matches the anchor-5 good example's structure of explicit what plus explicit when with trigger phrases.

5 / 5

Trigger Term Quality

Natural scenario phrases like "session ran outside the repo", "launched from a higher-level folder", and "one repo but editing another" read like what a user would actually say. A few common variations are missing (e.g. "wrong directory", "parent folder", "cross-link"), keeping it below the comprehensive synonym coverage of anchor 5.

4 / 5

Distinctiveness Conflict Risk

This is a clear niche (Entire session crosslinking) with distinct trigger scenarios and tool-specific vocabulary; no other plausible skill would fire on these triggers. It is not generic at any level, so it fits the anchor-5 'clear niche with distinct triggers' example.

5 / 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

SnowingFox/ai-skills

Path

.agents/skills/session-crosslink/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.