CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

openspec-propose

Propose a new change with all artifacts generated in one step. Use when the user wants to quickly describe what they want to build and get a complete proposal with design, specs, and tasks ready for implementation.

Quality

85%

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

81%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 body with exact commands, parse guidance, and strong validation feedback loops. Its main weakness is redundancy: the planning boundary and --store stickiness rules are each stated multiple times, inflating token cost without adding guidance.

Suggestions

State the planning-only boundary once (either the opening paragraph or the Guardrails) and cross-reference it from the other location instead of repeating it nearly verbatim.

Explain --store stickiness once in the Store selection paragraph and have steps 2 and 3 simply say "append the sticky --store flag" rather than re-describing the rule.

Merge the "re-read dependency artifacts from disk" instruction (currently in both step 5a and Guardrails) into a single place.

DimensionReasoningScore

Conciseness

Mostly procedural with no explanations of concepts Claude already knows, but noticeably repetitive: the planning boundary is stated in the opening paragraph and again almost verbatim in Guardrails; --store handling is explained in the Store selection paragraph, then repeated in steps 2 and 3; "re-read dependencies from disk, not conversation memory" appears twice. Fits the "mostly efficient but could be tightened" anchor rather than the "minor instances" of score 4.

3 / 5

Actionability

Fully executable throughout: exact commands ("openspec new change \"<name>\" --schema \"<schema-name>\"", "openspec instructions <artifact-id> --change \"<name>\" --json"), the JSON fields to parse (applyRequires, requires edges, resolvedOutputPath), and per-artifact verification. Copy-paste ready and covers the common cases including store selection and skipped artifacts.

5 / 5

Workflow Clarity

A clear numbered sequence with explicit validation checkpoints (re-run "openspec status --change \"<name>\" --json" after each artifact, verify the file exists at resolvedOutputPath), error-recovery paths (skipped/blocked artifacts, unclear input, existing change name), and a final status step. Matches the top anchor's feedback loops and checkpoint structure.

5 / 5

Progressive Disclosure

No bundle files exist, so everything lives in one SKILL.md; that is appropriate for a cohesive multi-step workflow, and sections (Store selection, Steps, Artifact Creation Guidelines, Guardrails) are clearly headed and easy to navigate. Not 5 because some inline material (the long store-selection rules and duplicated boundary statements) could be consolidated or moved out, leaving minor organization gaps.

4 / 5

Total

17

/

20

Passed

Description

83%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 clearly and explicitly states both what the skill does and when to use it, with concrete deliverables and natural trigger phrasing. Minor gaps: the product name "openspec" is absent and a few natural synonyms ("plan", "spec out") would sharpen trigger matching further.

DimensionReasoningScore

Specificity

Names the domain and several concrete deliverables ("complete proposal with design, specs, and tasks ready for implementation") plus the action "Propose a new change with all artifacts generated in one step". Not 5 because "change" is domain jargon left unpacked and the actions around each artifact are not elaborated; not 3 because more than 1-2 concrete actions are named.

4 / 5

Completeness

Explicitly answers both: what ("Propose a new change with all artifacts generated in one step") and when ("Use when the user wants to quickly describe what they want to build and get a complete proposal with design, specs, and tasks ready for implementation") with concrete trigger phrasing, matching the top anchor.

5 / 5

Trigger Term Quality

Includes natural phrases users would say ("describe what they want to build", "proposal", "design, specs, and tasks", "ready for implementation"). Good coverage but a few natural synonyms (e.g. "plan this change", "spec it out") and the product name "openspec" are missing, so it falls just short of the comprehensive anchor.

4 / 5

Distinctiveness Conflict Risk

The change/proposal/specs/tasks cluster carves a distinct planning niche with minimal conflict risk, but "change" and "proposal" are generic words and "openspec" is never named, leaving minor overlap risk with generic planning or roadmap skills.

4 / 5

Total

17

/

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

partme-ai/full-stack-skills

Path

.zcode/skills/openspec-propose/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.