CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

codex-settings-sync

Use when the user wants to migrate Codex state in ~/.codex into Agent Filesystem and mount the same shared Codex memory/settings across multiple computers. Recommends a .afsignore before migration and defaults to excluding worktrees, caches, logs, and temporary files.

91

1.61x
Quality

89%

Does it follow best practices?

Impact

100%

1.61x

Average score across 3 eval scenarios

SecuritybySnyk

Passed

No findings from the security scan

SKILL.md
Quality
Evals
Security

Quality

Content

86%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 tight, well-organized instruction-only skill with concrete commands, an ordered migration workflow, verification, and rollback. Its main weaknesses are the un-specified Redis/control-plane configuration steps and verification existing only at the end of the workflow rather than at intermediate checkpoints.

Suggestions

Replace the vague "Configure afs to point at the shared Redis instance" / "Point the CLI at the same control plane or Redis database" steps with the actual command(s) or config file edit so users can copy-paste them.

Add intermediate validation checkpoints — e.g., verify the source-machine import succeeded (./afs status or ls ~/.codex) before instructing secondary machines to mount, and re-verify after each secondary mount.

Give the exact command for moving aside an existing ~/.codex on secondary machines (e.g., mv ~/.codex ~/.codex.local-backup) so the backup naming matches the rollback section's mv ~/.codex.local-backup ~/.codex.

DimensionReasoningScore

Conciseness

The body is lean with zero padding: no explanations of concepts Claude already knows, no filler prose — sections like "Default stance" and "Notes to surface" are pure operational facts. Every token earns its place, matching anchor 5 rather than anchor 4 (which still allows minor trimming).

5 / 5

Actionability

Most steps are executable copy-paste commands ("./afs ws import --mount-at-source .codex ~/.codex", "./afs config set --mode mount", rollback bash blocks), but a few gaps remain: "Configure afs to point at the shared Redis instance" and "Point the CLI at the same control plane or Redis database" give no concrete command, and "move aside any existing ~/.codex" lacks the exact mv command. This fits anchor 4 (mostly executable with minor gaps), below anchor 5's fully copy-paste-ready coverage.

4 / 5

Workflow Clarity

The 8-step migration sequence is clearly ordered with an explicit verification step ("Verify with ./afs status and ls -la ~/.codex") and a rollback section providing error recovery. However, verification comes only at the end — there is no checkpoint after the source-machine import or after each secondary machine's mount, and no validate-then-retry feedback loop. That places it at anchor 4 rather than anchor 5; it also stays above anchor 3 because a validation step is present for this potentially destructive migration.

4 / 5

Progressive Disclosure

The body is a compact, well-sectioned overview (~55 lines) with the only detailed material — the starter ignore file — correctly externalized as a one-level-deep, well-signaled reference to [assets/.afsignore](assets/.afsignore), which exists and matches the patterns listed in the body. Structure and navigation are clean, matching anchor 5; the skill does not need additional reference files.

5 / 5

Total

18

/

20

Passed

Description

87%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 covers both what the skill does and when to use it, with concrete domain-specific triggers. Keyword coverage is good but could include a few more natural synonyms like "sync" or "share across machines".

DimensionReasoningScore

Specificity

The description names concrete actions — "migrate Codex state in ~/.codex into Agent Filesystem", "mount the same shared Codex memory/settings across multiple computers", "Recommends a .afsignore before migration", "defaults to excluding worktrees, caches, logs, and temporary files" — which is several specific actions with only minor coverage gaps (config and rollback steps are not mentioned). It exceeds anchor 3 (only 1-2 concrete actions) but does not fully match anchor 5's comprehensive coverage of everything the skill does.

4 / 5

Completeness

Both parts are explicit: the "what" is migrating Codex state into Agent Filesystem, mounting it across machines, recommending a .afsignore with specific default exclusions; the "when" is the leading clause "Use when the user wants to migrate Codex state in ~/.codex into Agent Filesystem and mount the same shared Codex memory/settings across multiple computers". This clearly matches anchor 5 (explicit what AND when with concrete trigger phrases), well above anchor 4 where the 'when' is only adequate.

5 / 5

Trigger Term Quality

Natural user phrases are present: "migrate Codex state", "shared Codex memory/settings", "across multiple computers", "worktrees, caches, logs". A few natural synonyms are missing — users would plausibly say "sync Codex settings", "share Codex across machines", or "back up .codex" — so it fits anchor 4 (good coverage, a few natural terms missing) rather than anchor 5's synonym-and-extension completeness.

4 / 5

Distinctiveness Conflict Risk

The niche is highly specific — Codex, ~/.codex, Agent Filesystem, .afsignore, Redis-backed shared state — so it is clearly distinguishable from other skills and unlikely to fire for the wrong one, matching anchor 5 (clear niche with distinct triggers, minimal conflict risk).

5 / 5

Total

18

/

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

redis/agent-filesystem

Path

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