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.

70

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.

A well-built instruction-only skill: fully executable CLI commands, explicit dependency-ordered artifact loop with status re-checks and file-existence verification, and clear guardrails for ambiguity and name collisions. Remaining improvements are minor — deduplicating the repeated context/rules and re-read guidance, and moving the Store-selection boilerplate into a shared reference file.

DimensionReasoningScore

Conciseness

The body is efficient — numbered steps, copy-paste commands, and no explanation of concepts Claude already knows — matching the 'efficient; minor instances of over-explanation that could be trimmed' anchor. Not a 5 because the context/rules constraint ("do NOT copy <context>, <rules>...") is stated in full twice, and 'read dependency artifacts, re-read from disk' guidance is likewise repeated in both step 4 and the Guidelines section.

4 / 5

Actionability

Commands are copy-paste ready (`openspec new change "<name>"`, `openspec status --change "<name>" --json`, `openspec instructions <artifact-id> --change "<name>" --json`) with the exact JSON fields to parse (`applyRequires`, `resolvedOutputPath`, etc.), matching the 'fully executable; copy-paste ready commands' anchor. The one abstract step (writing the artifact file) is legitimately driven by the CLI's runtime-provided template and resolved output path, which the skill handles explicitly.

5 / 5

Workflow Clarity

The sequence is explicit with validation checkpoints: loop artifacts in dependency order, re-run `openspec status --json` after each creation, stop only when every `applyRequires` artifact reports `status: "done"`, and "Verify each artifact file exists after writing before proceeding". This batch file-generation workflow includes feedback loops and error/ambiguity handling (AskUserQuestion, existing-change collision), matching the top anchor and avoiding the batch-operation cap since validation is present.

5 / 5

Progressive Disclosure

No bundle files exist (references/, scripts/, assets/ are absent) and none are referenced, so there are no broken or nested-reference issues; the body is organized into clear sections (Store selection, Input, Steps, Output, Guidelines, Guardrails), matching 'good structure; minor organization gaps'. Not a 5 because at ~113 lines it exceeds the under-50-line simple-skill case, and the Store selection paragraph is boilerplate that likely recurs across sibling OpenSpec skills and belongs in a shared reference file.

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 in correct third-person voice: it states what the skill does, names its concrete deliverables (design, specs, tasks), and includes an explicit 'Use when' trigger clause. The only gaps are slightly generic action verbs and missing a distinctive keyword (e.g. "openspec") that would fully de-risk conflicts with general planning skills.

Suggestions

Name the tooling in the description (e.g. "Propose a new OpenSpec change...") to sharpen distinctiveness and reduce conflict with generic planning skills.

Replace generic verbs with concrete artifact actions, e.g. "...generating proposal.md, design.md, and tasks.md in one step", to lift specificity toward comprehensive coverage.

Add common user phrasings as triggers, such as "plan a new feature" or "draft a spec", alongside the existing 'Use when' clause.

DimensionReasoningScore

Specificity

"Propose a new change with all artifacts generated in one step" and "get a complete proposal with design, specs, and tasks ready for implementation" name several concrete outputs (design, specs, tasks), matching the 'lists several specific actions; minor gaps' anchor. Not a 5 because the actions themselves stay generic ('propose', 'generate') without saying what is done to each artifact, and 'change' is domain jargon without clarification.

4 / 5

Completeness

The description 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..."), matching the anchor for clearly and explicitly answering both with concrete trigger phrases. Third-person voice is used correctly, so no penalty applies.

5 / 5

Trigger Term Quality

"describe what they want to build", "proposal", "design, specs, and tasks" are natural phrases users would say, giving good keyword coverage per the score-4 anchor. A few natural variants are missing — e.g. "plan a feature", "draft a spec", "openspec" — so it does not reach comprehensive synonym coverage.

4 / 5

Distinctiveness Conflict Risk

The artifact trio ("proposal with design, specs, and tasks ready for implementation") carves a clear niche in the OpenSpec workflow, so it is mostly distinct with only minor overlap risk against generic planning/spec-drafting skills — the score-4 anchor. Not a 5 because the description never names the tool or a unique term like "openspec change", leaving some risk of firing for ordinary 'plan my feature' requests.

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
jabrena/plinth
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.