CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

openspec-sync-specs

Sync delta specs from an OpenSpec change to main specs. Use when the user wants to update main specs with changes from a delta spec, without archiving the change. Also use when the user says "openspec sync" or "opsx sync".

Quality

91%

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.

A highly actionable, well-sequenced workflow with concrete commands, exact JSON fields, and explicit validation and stop-condition checkpoints for a destructive merge operation. The only real cost is length: duplicated guardrails and deep edge-case digressions (retirement conditions, store selection) make it longer than the task strictly requires.

DimensionReasoningScore

Conciseness

The body is dense, operational edge-case guidance that assumes Claude's competence (no concept padding), but the Guardrails section restates rules already given in steps 3-4 ("Use only artifactPaths.specs.existingOutputPaths; never infer...", "Honor a caller-supplied subset... never widen it back to the full list") and "Never write an empty ## Requirements section" appears twice, so minor trimming is possible.

4 / 5

Actionability

Provides fully executable commands (openspec status --change "<name>" --json, openspec list --json, openspec instructions specs --change "<name>" --json, openspec validate --specs), exact JSON fields to read (planningHome.root, artifactPaths.specs.existingOutputPaths), exact file paths, copy-paste format templates, and a concrete success-output template covering the common cases.

5 / 5

Workflow Clarity

Six clearly sequenced steps with an explicit validation checkpoint (step 5: run openspec validate --specs and do not claim success on failure) and extensive pre-write gates (root check, "Declared in" error branch, stop on non-zero/invalid instructions JSON, six retirement conditions), giving every risky write an explicit check.

5 / 5

Progressive Disclosure

A single-file skill (no references/, scripts/, or assets/ exist) with well-organized, clearly headed sections (Steps, Delta/Main Spec Format References, Key Principle, Output, Guardrails); the format references are used mid-workflow so inline placement is defensible, but at ~280 lines the store-selection and retirement digressions could live in referenced files.

4 / 5

Total

18

/

20

Passed

Description

90%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 explicit what/when structure and concrete, natural trigger phrases including both CLI aliases. Its only weakness is that it names a single capability rather than enumerating several specific actions, which slightly limits specificity.

Suggestions

Enumerate the concrete sub-actions the sync performs (e.g., add, modify, remove, and rename requirements, create new main specs, validate specs) to raise specificity beyond a single stated action.

Mention the delta operation keywords users might reference, such as "ADDED/MODIFIED/REMOVED requirements" or "apply a delta spec", to broaden natural trigger coverage.

DimensionReasoningScore

Specificity

States one concrete action ("Sync delta specs from an OpenSpec change to main specs") with a distinguishing qualifier ("without archiving the change"), but does not list several distinct capabilities, matching the '1-2 concrete actions, not comprehensive' anchor rather than the multi-action anchor 4.

3 / 5

Completeness

Explicitly answers both what ("Sync delta specs from an OpenSpec change to main specs") and when ("Use when the user wants to update main specs... Also use when the user says \"openspec sync\" or \"opsx sync\"") with concrete trigger phrases, matching the top anchor.

5 / 5

Trigger Term Quality

Includes the exact command phrases users would naturally say ("openspec sync", "opsx sync") alongside natural phrasings like "update main specs" and "delta spec", giving comprehensive trigger coverage for this niche with no obviously missing variation.

5 / 5

Distinctiveness Conflict Risk

Clear niche (OpenSpec delta-to-main spec sync) explicitly distinguished from archiving ("without archiving the change") with distinct command triggers, so conflict risk with other skills is minimal.

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

finos/morphir-dotnet

Path

.agents/skills/openspec-sync-specs/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.