CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

openspec-sync-specs

Sync delta specs from a change to main specs. Use when the user wants to update main specs with changes from a delta spec, without archiving the change.

61

Quality

77%

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

Fix and improve this skill with Tessl

tessl review fix ./.claude/skills/openspec-sync-specs/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

68%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 well-structured, actionable body that clearly sequences the sync workflow with concrete commands, paths, and output formats. Its main gap is the absence of a post-edit verification step for a batch, partly destructive operation on main spec files.

Suggestions

Add an explicit verification step after applying changes (e.g., re-read each updated main spec to confirm structure, or run an openspec validation command) to close the validation gap for this batch-edit workflow.

Trim redundancy: drop the opening line that repeats the frontmatter description and let the Delta Spec Format Reference carry the section-handling details already covered in step 3c.

DimensionReasoningScore

Conciseness

The body is focused procedural guidance with no padding or explanation of concepts Claude already knows; minor tightening is possible since the opening line "Sync delta specs from a change to main specs." duplicates the frontmatter description and the step 3c rules partially restate the format reference.

4 / 5

Actionability

Concrete guidance throughout: the exact command `openspec list --json`, precise paths like `openspec/changes/<name>/specs/*/spec.md`, per-section handling rules, a worked delta-format example, and a copy-ready output template; minor gaps remain (no command to verify results, and merging depends on judgment calls like "Use your judgment to merge changes sensibly").

4 / 5

Workflow Clarity

Steps 1-4 are clearly sequenced with pre-checks ("If no delta specs found, inform user and stop") and guardrails ("Read both delta and main specs before making changes"), but this batch edit of spec files — including destructive REMOVED Requirements — has no post-edit validation or verification step, capping the score at 3 per the batch/destructive guideline.

3 / 5

Progressive Disclosure

As a single-file skill with no bundle, its well-organized sections (Steps, Delta Spec Format Reference, Output On Success, Guardrails) keep content appropriately placed; at ~128 lines it exceeds the under-50-line exception, and the format reference block could arguably live in a separate file, so it stops short of anchor 5.

4 / 5

Total

15

/

20

Passed

Description

73%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 clear, well-structured description with an explicit trigger clause and strong distinctiveness for its openspec niche. Its main weakness is that it summarizes the operation as a single action rather than enumerating the concrete add/modify/remove/rename capabilities it covers.

Suggestions

Enumerate the concrete operations in the description (e.g., "Add, modify, remove, or rename requirements in main specs from a change's delta specs") to raise specificity from a single-action summary.

Include a few more natural trigger phrasings such as "apply changes to specs" or "openspec" so users who don't say "sync" or "delta spec" still match the skill.

DimensionReasoningScore

Specificity

"Sync delta specs from a change to main specs" names the domain and a single concrete action with a clear boundary ("without archiving the change"), but does not enumerate the several operations (adding, modifying, removing, renaming requirements) the skill actually performs, so it matches anchor 3 rather than anchor 4.

3 / 5

Completeness

Both parts are explicit: the what is "Sync delta specs from a change to main specs" and the when is "Use when the user wants to update main specs with changes from a delta spec, without archiving the change"; the when clause is a single trigger that could cover more concrete user phrasings, so it is not anchor 5.

4 / 5

Trigger Term Quality

Terms like "sync", "update main specs", "delta spec", "change", and "archiving" give good keyword coverage for this niche, matching anchor 4; a few natural phrasings (e.g., "apply changes", "openspec") are missing, keeping it below anchor 5.

4 / 5

Distinctiveness Conflict Risk

The openspec-specific vocabulary ("delta spec", "main specs", "archiving the change") carves out a clear niche and explicitly distinguishes this from archiving a change, giving minimal conflict risk with other skills.

5 / 5

Total

16

/

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

dwmkerr/openspec-flow

Path

.claude/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.