CtrlK
BlogDocsLog inGet started
Tessl Logo

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.

69

Quality

83%

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

92%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-engineered, CLI-driven workflow skill: fully executable commands, explicit JSON parsing guidance, validation checkpoints, and a status-recheck loop that doubles as progressive disclosure by pulling artifact templates dynamically. The only real improvement is consolidating the thrice-repeated context/rules warning to trim a few tokens.

DimensionReasoningScore

Conciseness

The body is efficient overall — literal commands, structured steps, and no explanations of concepts Claude already knows. The one recurring flaw is that the "context and rules are constraints for YOU, do NOT copy them into the file" instruction is repeated three times (in step 4a, in the Artifact Creation Guidelines, and in the Guardrails), which could be consolidated; this is minor over-emphasis rather than the padded sections of anchor 3.

4 / 5

Actionability

Every step gives copy-paste-ready commands (`openspec new change "<name>"`, `openspec status --change "<name>" --json`, `openspec instructions <artifact-id> --change "<name>" --json`) with the JSON fields to parse (`applyRequires`, `artifacts`, `template`, `outputPath`) fully specified. Pulling detailed templates from the CLI at runtime is a complete, executable design that covers the common cases; it is not anchor 4 because there are no real gaps in what to execute.

5 / 5

Workflow Clarity

The 5-step sequence is explicit with a dependency-ordered artifact loop, validation checkpoints ("Verify each artifact file exists after writing before proceeding to next"), and a genuine feedback loop ("After creating each artifact, re-run openspec status --change ... Stop when all applyRequires artifacts are done") plus a recovery path ("If an artifact requires user input ... Use AskUserQuestion tool"). Validation is present, so the batch-operation cap does not apply, and the Guardrails section serves as the checklist anchor 5 asks for.

5 / 5

Progressive Disclosure

There are no bundle files, and none are needed: the skill is a single coherent workflow whose per-artifact detail is deliberately fetched at runtime via `openspec instructions`, which is progressive disclosure done right. The body is cleanly sectioned (Input, Steps, Output, Artifact Creation Guidelines, Guardrails) with no content that belongs in a separate file, so nothing is inlined that should be split out.

5 / 5

Total

19

/

20

Passed

Description

75%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 solid description with an explicit third-person what-statement and a detailed "Use when..." trigger clause covering intent and deliverables (design, specs, tasks). Its main gaps are unenumerated artifact-level specifics and a single trigger phrasing that misses common synonyms users might say.

Suggestions

Name the concrete deliverables (e.g., "generates proposal.md, design.md, and tasks.md") instead of the abstract "all artifacts" to sharpen the what-statement.

Broaden the trigger clause with variations users would naturally say, e.g., "Use when the user wants to propose a change, spec out a feature, or plan work before implementing".

DimensionReasoningScore

Specificity

The description names the domain (proposing changes) and lists concrete outputs — "all artifacts generated in one step" and "a complete proposal with design, specs, and tasks ready for implementation" — giving several specific capabilities. It falls short of a 5 because it never names the actual artifacts (proposal.md, design.md, tasks.md) or the concrete actions (create change, generate specs), and "propose a new change" is domain jargon; it exceeds anchor 3 because more than 1-2 specific items are enumerated.

4 / 5

Completeness

It answers both questions explicitly: the what ("Propose a new change with all artifacts generated in one step") and the when ("Use when the user wants to quickly describe what they want to build and get a complete proposal"). The when-clause is explicit and detailed, but it is a single trigger clause without the multiple concrete trigger variations ("or when the user mentions X, Y") that anchor 5 requires.

4 / 5

Trigger Term Quality

The when-clause includes natural phrases users would say: "describe what they want to build", "proposal", "design, specs, and tasks", "ready for implementation". A few natural variations are missing (e.g., "spec out", "plan a feature", "draft a change"), keeping it below the comprehensive synonym coverage of anchor 5 but clearly above the sparse keyword coverage of anchor 3.

4 / 5

Distinctiveness Conflict Risk

The proposal/spec-generation niche is mostly distinct — the trigger (describing what to build to get a full proposal) is unlikely to fire for unrelated skills. There is minor overlap risk with closely related planning or spec-writing skills (and with sibling openspec commands like apply), which keeps it below anchor 5's "clear niche with distinct triggers; minimal conflict risk".

4 / 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
rpamis/comet
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.