CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

openspec-apply-change

Implement tasks from an OpenSpec change. Use when the user wants to start implementing, continue implementation, or work through tasks.

Quality

78%

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

Fix and improve this skill with Tessl

tessl review fix ./.kimi-code/skills/openspec-apply-change/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

75%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 skill with copy-paste commands, explicit state handling, and useful output templates. Its weaknesses are repetition of the context/operationGuidance rules between Step 3 and Guardrails, one dense paragraph, and the absence of a verify-before-marking checkpoint.

Suggestions

State the context/operationGuidance handling rules once — either in Step 3 or as a short Guardrails bullet — instead of repeating them in both places.

Break the 150-word Store-selection paragraph into a short bulleted rule list (when to pass --store, which commands take it, stickiness) to cut reread cost.

Add a verify-before-marking checkpoint, e.g., confirm the change compiles or tests pass before flipping `- [ ]` to `- [x]`, and re-run `openspec status` on failure.

DimensionReasoningScore

Conciseness

The body is dense and free of concept-explaining filler, but the context/operationGuidance contract is stated in full in Step 3 ("Treat `context` as a required prompt-level input... They are not evidence of task completion...") and then repeated nearly point-for-point in the Guardrails list ("Do not use context or operation guidance as proof that a task is complete", "Apply relevant project context; report conflicts...", "Consider every guidance entry...", "Do not copy runtime context..."). This duplicated block plus the single 150-word Store-selection paragraph could be meaningfully tightened, matching the 3 anchor.

3 / 5

Actionability

Guidance is fully executable for an instruction-only skill: copy-paste-ready commands (`openspec status --change "<name>" --json`, `openspec instructions apply --change "<name>" --json`, `openspec list --json`), a concrete edit operation ("Mark task complete in the tasks file: `- [ ]` → `- [x]`"), explicit state handling for blocked/all_done, and complete output templates for in-progress, completion, and pause. Nothing is pseudocode and the common cases are covered, matching the 5 anchor.

5 / 5

Workflow Clarity

The seven steps are clearly sequenced with state checks up front, explicit pause conditions for error recovery ("Pause on errors, blockers, or unclear requirements - don't guess"), and a post-session status report, plus a Guardrails checklist. It falls short of 5 because there is no validation checkpoint before marking a task complete — the loop goes straight from "Make the code changes required" to "Mark task complete" without verifying the change (e.g., build/test) succeeded.

4 / 5

Progressive Disclosure

No bundle files exist and none are needed; the single body is well-sectioned (Steps, Output templates, Guardrails, Fluid Workflow Integration) with no nested or buried references, so it clears the monolithic and buried-reference anchors easily. It stays at 4 rather than 5 because the ~170-line body has minor organization gaps — the dense unbroken Store-selection paragraph and the repeated context/guidance rules read as inlined content that could be consolidated or trimmed.

4 / 5

Total

16

/

20

Passed

Description

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

The description uses third person, answers both what and when explicitly, and is anchored to a clear niche. Its main weaknesses are a thin single-action "what" and missing natural synonyms that would sharpen triggering and raise completeness.

Suggestions

Expand the 'what' with 2-3 concrete actions implementation involves, e.g., "Read proposal/specs/design context files, make the code changes, and mark tasks complete in the tasks file".

Add natural trigger synonyms such as "apply a change", "work on the tasks", or "finish a change" to broaden keyword coverage.

Disambiguate "continue implementation" from any sibling OpenSpec skills (e.g., continue-change) so the description triggers for the right skill.

DimensionReasoningScore

Specificity

"Implement tasks from an OpenSpec change" names the domain and essentially one concrete action, matching the anchor for 1-2 actions without comprehensive coverage. It is above score 2 because the action is domain-anchored rather than generic ("Processes PDF files"), but below score 4 because no secondary actions (e.g., reading context files, marking tasks complete) are stated.

3 / 5

Completeness

Both parts are explicit: the "what" ("Implement tasks from an OpenSpec change") and the "when" ("Use when the user wants to start implementing, continue implementation, or work through tasks"). It sits between 4 and 5: the trigger clause is explicit and multi-phrase, but the "what" is a single thin action rather than the comprehensive multi-action coverage of the 5 anchor.

4 / 5

Trigger Term Quality

"start implementing", "continue implementation", and "work through tasks" are natural phrases a user would say, giving good keyword coverage. It falls short of 5 because common synonyms like "apply a change", "finish the change", or file terms like "tasks.md" are missing.

4 / 5

Distinctiveness Conflict Risk

"OpenSpec change" carves out a clear niche, so conflict with unrelated skills is minimal. Minor overlap remains with closely related OpenSpec skills (e.g., a continue-change or apply-change sibling), since "continue implementation" and "work through tasks" could plausibly trigger those too — matching the 4 anchor rather than the fully distinct 5.

4 / 5

Total

15

/

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-apply-change/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.