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

88%

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.

An instruction-only workflow skill with excellent actionability and workflow clarity — executable CLI commands, explicit validation loops, and precise stop conditions throughout. Its only weaknesses are minor repetition of the planning-boundary and store-flag rules, and monolithic inline storage of edge-case details that could live in a reference file.

DimensionReasoningScore

Conciseness

The body is efficient, procedural, and assumes Claude's competence (no explanations of basic concepts, exact JSON fields to parse, exact commands). Minor redundancy could be trimmed — the planning-boundary rule is restated nearly verbatim in "Planning boundary" and "Guardrails", and the store-flag instruction appears in both the "Store selection" preamble and Steps 2–3.

4 / 5

Actionability

Commands are copy-paste ready with placeholders ("openspec new change \"<name>\"", "openspec instructions <artifact-id> --change \"<name>\" --json") and the skill specifies exactly which JSON fields to read (applyRequires, requires edges, resolvedOutputPath). This fully matches the anchor for executable guidance covering the common cases.

5 / 5

Workflow Clarity

The six steps are clearly sequenced with explicit feedback loops (re-run `openspec status --change` after each artifact), explicit stop conditions ("Stop when every artifact in the required set is done, skipped, or was deliberately skipped"), and per-artifact verification ("Verify each artifact file exists after writing before proceeding to next"). This matches the anchor with validation steps and error-recovery checkpoints for a batch operation.

5 / 5

Progressive Disclosure

The body is well organized with headers, steps, and guidelines, and there are no nested or dead references. However, at ~137 lines with no bundle files, detailed edge-case material (store-selection mechanics, required-set closure rules, schema-resolution branches) is inlined in the main file rather than split into a one-level-deep reference, leaving minor organization gaps relative to the score-5 anchor.

4 / 5

Total

18

/

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 explicitly answers both what the skill does and when to use it, in third person, with concrete artifact-level specifics. The only weakness is trigger-term breadth: it misses obvious synonyms like "openspec" or "plan a change" that a user would naturally say.

Suggestions

Add natural trigger synonyms to the description — e.g., "Use when the user wants to plan, propose, or spec out a change in OpenSpec" — to broaden trigger-term coverage beyond the current phrasing.

Enumerate the artifact set more completely (e.g., mention the change directory and spec deltas) to lift specificity from several actions toward comprehensive coverage.

DimensionReasoningScore

Specificity

"Propose a new change with all artifacts generated in one step" and "proposal with design, specs, and tasks" name several concrete actions with specific artifact types, matching the score-4 anchor of several specific actions with minor gaps. It falls short of 5 because coverage is not comprehensive — the artifact set is only partially enumerated.

4 / 5

Completeness

Both parts are explicit: the what ("Propose a new change with all artifacts generated in one step... proposal with design, specs, and tasks") and the when ("Use when the user wants to quickly describe what they want to build and get a complete proposal..."). This clearly matches the score-5 anchor with concrete trigger phrasing.

5 / 5

Trigger Term Quality

Natural phrases users would say are present ("describe what they want to build", "proposal", "design, specs, and tasks"), giving good keyword coverage. A few natural terms are missing (e.g., "openspec", "spec change", "plan a change"), so it does not reach the comprehensive synonym coverage of 5.

4 / 5

Distinctiveness Conflict Risk

The artifact vocabulary (proposal, design, specs, tasks) gives it a mostly distinct niche with minor overlap risk against generic planning/proposal skills via the broad trigger "describe what they want to build". It fits score 4 better than 3 (which would imply real overlap with similar skills) or 5 (which would require fully distinct triggers).

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

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