CtrlK
BlogDocsLog inGet started
Tessl Logo

042-planning-openspec

Use when creating or updating OpenSpec change artifacts from an issue, implementation plan, approved design, ADRs, existing OpenSpec artifacts, or a valid combination. The workflow assesses whether the scope is one change or multiple changes, records sources and derivation direction, and prevents silent synchronization. This should trigger for requests such as Create an OpenSpec change from an issue; Convert a plan into OpenSpec; Update an existing OpenSpec change; Split broad requirements into reviewable OpenSpec changes. Part of cursor-rules-java project

80

Quality

Does it follow best practices?

Impact

No eval scenarios have been run

SecuritybySnyk

Passed

No known issues

SKILL.md
Quality
Evals
Security

Quality

Content

100%

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

The body is a well-structured, lean workflow skill with concrete OpenSpec commands, sequenced validation and approval checkpoints, and a single clearly signaled one-level-deep reference. Content is appropriately split between an actionable overview and the detailed reference.

DimensionReasoningScore

Conciseness

Lean instruction skill with no concept-tutoring or padding; every section (Constraints, When to use, Workflow, Reference) earns its place and assumes Claude's competence. Not a 2 because there is no unnecessary explanation of known concepts, only mild overview/workflow overlap that aids scanning.

3 / 3

Actionability

Gives concrete commands — `openspec --version`, `openspec init`, `openspec validate --all` — plus specific artifact types (proposal, design, specification deltas, tasks) and named approval gates. Not a 2 because, as an instruction skill, the guidance is specific and actionable rather than vague or pseudocode.

3 / 3

Workflow Clarity

Six clearly sequenced steps with explicit validation checkpoints (steps 5 'Validate authority and alignment' and 6 `openspec validate --all`) and approval/conflict-resolution gates ('require alignment review plus an explicit user decision before propagation'). Not a 2 because validation and feedback gates are explicit, not merely implied.

3 / 3

Progressive Disclosure

Well-organized overview in SKILL.md pointing one level deep to references/042-planning-openspec.md (a real, verified file) signaled in both step 1 and the Reference section. Not a 2 because the split is clean and navigation is clearly signaled with no nested-reference chains.

3 / 3

Total

12

/

12

Passed

Description

100%

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 is specific, trigger-rich, and clearly bounded to the OpenSpec change-planning niche, answering both what it does and when to use it with explicit natural-language triggers. It uses third-person/imperative voice with no first- or second-person constructions to penalize.

DimensionReasoningScore

Specificity

Lists multiple concrete actions — 'creating or updating OpenSpec change artifacts', 'assesses whether the scope is one change or multiple changes', 'records sources and derivation direction', 'prevents silent synchronization' — matching the 'lists multiple specific concrete actions' anchor. Not a 2 because it goes well beyond naming a domain and a few actions.

3 / 3

Completeness

Explicitly answers both: 'Use when creating or updating OpenSpec change artifacts...' (when) and 'The workflow assesses... records sources... prevents silent synchronization' (what), plus a 'This should trigger for...' clause. Not a 2 because the 'when' is explicit via a 'Use when' clause, not implied.

3 / 3

Trigger Term Quality

Provides natural user-request phrasings — 'Create an OpenSpec change from an issue; Convert a plan into OpenSpec; Update an existing OpenSpec change; Split broad requirements into reviewable OpenSpec changes' — that a user would naturally say. Not a 2 because it covers multiple common request variations rather than a single keyword.

3 / 3

Distinctiveness Conflict Risk

Occupies a clear niche — OpenSpec change-artifact planning — with distinct triggers unlikely to fire for unrelated skills. Not a 2 because the OpenSpec-specific triggers are far from generic 'works with files' overlap.

3 / 3

Total

12

/

12

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.

Validation16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository
jabrena/cursor-rules-java
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.