CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

memory-sync

Verify, deduplicate, and compact an explicitly inventoried set of project Codex instructions against current source facts; honors narrowed scope and excludes persistent personal memory unless directly requested.

Quality

74%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Low

Low-risk findings worth noting

Fix and improve this skill with Tessl

tessl review fix ./.codex/skills/memory-sync/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

78%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 dense, well-structured instruction-only skill: it names concrete edit targets, an explicit verify->dedupe->compact sequence with real validation checkpoints, and offloads the detailed contract to a single genuine reference file. Main weakness is that extreme compression plus slight overlap with the reference makes a few passages harder to act on than they need to be.

DimensionReasoningScore

Conciseness

The body is very lean with no explanations of concepts Claude already knows, but a few points (memory-policy authorization, root index handling) are restated from references/sync-contract.md and could be trimmed, and the near-limit compression occasionally costs clarity.

4 / 5

Actionability

Concrete, specific guidance throughout — `apply_patch`, `AGENTS.md`, `.codex/rules/`, native agent TOML, NORMAL/HARD depths, the `Rule`/`Load when`/`Purpose` index format, and a specific report checklist — though some executable detail (snapshot mechanics, fact-check commands) lives only in the reference.

4 / 5

Workflow Clarity

A clear sequence is present ('Snapshot the actual authorized files, then verify facts -> choose canonical homes/deduplicate -> compact with apply_patch') with explicit validation ('independent read-only post-sync check', 'Verify every edit and deletion against the snapshot'), satisfying the destructive/batch validation requirement, but the full ordering is distributed across paragraphs rather than given as one explicit sequence.

4 / 5

Progressive Disclosure

The body is a concise overview with a single well-signaled, one-level-deep reference ([references/sync-contract.md]) that exists, carries the substantive contract, and itself contains no nested references; the split is appropriate and navigation is easy.

5 / 5

Total

17

/

20

Passed

Description

58%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 communicates a clear, specific capability set for a well-defined niche, but it reads more like a behavioral contract than a trigger description: it entirely lacks 'when to use this' guidance and omits the natural file-level terms users would say. Adding an explicit Use-when clause with concrete trigger phrases would move it from adequate to strong.

Suggestions

Add an explicit trigger clause, e.g. 'Use when the user asks to sync, clean up, verify, or deduplicate project instruction files such as AGENTS.md or .codex/rules/'.

Include the natural terms users would say — AGENTS.md, .codex/rules, agent TOML, 'sync instructions' — alongside the existing verbs so the skill surfaces for file-level requests.

Replace jargon-heavy phrases like 'explicitly inventoried set' and 'current source facts' with plainer wording (e.g. 'the exact files the user authorized' and 'the current codebase').

DimensionReasoningScore

Specificity

Names the domain ('project Codex instructions') and several concrete actions ('Verify, deduplicate, and compact', 'honors narrowed scope and excludes persistent personal memory'), but coverage has minor gaps — auditing, snapshotting, and reporting capabilities from the body are absent.

4 / 5

Completeness

The 'what' is clear (verify, deduplicate, compact project Codex instructions), but there is no 'Use when...' clause or any equivalent explicit trigger guidance, which caps completeness at 3.

3 / 5

Trigger Term Quality

Relevant keywords like 'Codex instructions', 'deduplicate', and 'compact' are present, but the natural phrases a user would actually say ('AGENTS.md', '.codex/rules', 'sync my instructions/rules') are missing, and phrasing like 'explicitly inventoried set' and 'current source facts' is jargon rather than user language.

3 / 5

Distinctiveness Conflict Risk

The niche is clear and narrow (syncing project Codex instruction files), but the 'persistent personal memory' mention creates minor overlap risk with general memory-management skills despite the exclusion framing.

4 / 5

Total

14

/

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

kochetkov-ma/claude-brewcode

Path

.codex/skills/memory-sync/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.