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

84%

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

85%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.

The body is an exceptionally actionable, well-sequenced workflow with explicit commands, validation checkpoints, and error-recovery loops. Its main weaknesses are a monolithic single-file structure with no progressive disclosure of dense reference material, and some duplicated statements that could be trimmed.

Suggestions

Move the store-selection semantics and the required-set/dependency-walk rules (step 5b) into a reference file (e.g. references/store-selection.md), keeping SKILL.md to the core workflow.

Deduplicate the planning-boundary statement and the re-read-from-disk rule, each of which appears both in the body and again in the Guardrails section.

Tighten the store-selection paragraph, which is the wordiest section and repeats the --store flag instructions given later in step 3.

DimensionReasoningScore

Conciseness

The body is dense and operational with no explanations of concepts Claude already knows, but there is repetition to trim: the planning boundary is stated in both the opening paragraph and Guardrails, the re-read-from-disk rule appears in step 5a and Guardrails, and the store-selection paragraph is wordy. Efficient with minor instances of over-explanation fits 4; not 5 because of this duplicated content.

4 / 5

Actionability

Every step has copy-paste-ready commands with exact flags (openspec new change "<name>" --schema "<schema-name>", openspec status --change "<name>" --json, openspec instructions <artifact-id> --change "<name>" --json), the JSON fields to parse are named, and the user prompts and progress strings are given verbatim. Fully executable guidance covering the common cases matches the 5 anchor.

5 / 5

Workflow Clarity

A clear 6-step sequence with explicit validation checkpoints (re-run openspec status --json after each artifact; "Verify each artifact file exists after writing before proceeding to next"), feedback loops for error recovery (skipped/blocked/missing artifact handling, user-clarification loop), todo-list tracking, and explicit stop conditions. This matches the 5 anchor; not 4 because no validation checkpoint is missing.

5 / 5

Progressive Disclosure

A single ~137-line SKILL.md with no bundle files: it is well-sectioned with clear headers, but dense inline content (store-selection semantics, the required-set/dependency-walk rules in step 5b) sits in SKILL.md rather than being split into reference files. Some structure but content that should be separate is inline fits 3; not 4 because there are no references and separable content is inlined, not 2 because the structure is good and navigable.

3 / 5

Total

17

/

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 that clearly states what the skill does and when to use it, with concrete deliverables and a natural trigger scenario. It could be sharpened with explicit trigger keywords (openspec, spec-driven, plan a change) to improve both trigger coverage and distinctiveness.

Suggestions

Add explicit trigger keywords to the when-clause, e.g. "Use when the user asks to propose, plan, or spec out a change with OpenSpec" so it matches the natural phrases users say.

Mention 'openspec' or 'spec-driven' explicitly to sharpen distinctiveness against generic build/planning skills.

DimensionReasoningScore

Specificity

"Propose a new change with all artifacts generated in one step" names concrete actions and enumerates the deliverables ("design, specs, and tasks"), matching the several-specific-actions anchor with minor gaps in coverage. It falls short of 5 because it does not comprehensively cover the workflow's actions, and exceeds 3 because it goes beyond 1-2 actions by listing the full artifact set.

4 / 5

Completeness

It 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..."), but the when-clause is a scenario description rather than sharp, concrete trigger phrases. Both present with a when that could be more explicit places it at 4, not 5, and clearly above 3.

4 / 5

Trigger Term Quality

Natural phrases like "describe what they want to build", "proposal", and "design, specs, and tasks" give good keyword coverage, but common variations such as "plan a change", "spec out", or "openspec" are missing. Good coverage with a few natural terms missing fits the 4 anchor better than 3 (partial coverage) or 5 (comprehensive with synonyms).

4 / 5

Distinctiveness Conflict Risk

Domain-specific vocabulary ("change", "proposal", "specs", "tasks" in the openspec sense) carves a mostly distinct niche with only minor overlap risk against a sibling apply skill or generic build/plan requests. Not 5 because "describe what they want to build" is broad enough to overlap with general build requests; not 3 because the artifact vocabulary clearly distinguishes it from similar skills.

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

partme-ai/full-stack-skills

Path

.kimi-code/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.