CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

openspec-ff-change

Fast-forward through OpenSpec artifact creation. Use when the user wants to quickly create all artifacts needed for implementation without stepping through each one individually.

Quality

76%

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 ./bcs-runtime/bcs-k8s/bcs-component/bcs-drplan-controller/.claude/skills/openspec-ff-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 well-structured, highly actionable instruction-only skill: every step is backed by a concrete CLI command, the loop has an explicit termination condition, and validation checkpoints exist. Its main weaknesses are mild redundancy (the context/rules warning stated twice) and the absence of error-recovery guidance for failed commands or writes.

DimensionReasoningScore

Conciseness

The body is dense and command-driven with no padding about concepts Claude already knows, but the "context and rules are constraints, do NOT copy them" guidance is repeated nearly verbatim in step 4a and again in the Artifact Creation Guidelines section, which could be consolidated. This matches anchor 4 (efficient with minor instances that could be trimmed) rather than 5, and is well above anchor 3 since there is no unnecessary conceptual explanation.

4 / 5

Actionability

Concrete copy-paste-ready commands are given for every phase (`openspec new change "<name>"`, `openspec status --change "<name>" --json`, `openspec instructions <artifact-id> --change "<name>" --json`) along with the exact JSON fields to parse and the outputPath to write to. Minor gaps (no handling for command failures, no example of an actual artifact write) keep it at anchor 4 rather than 5.

4 / 5

Workflow Clarity

A clearly numbered 5-step sequence with a dependency-ordered creation loop, an explicit stop condition ("Stop when all `applyRequires` artifacts are done"), and validation checkpoints (re-running status after each artifact, "Verify each artifact file exists after writing before proceeding to next") plus a guardrail for pre-existing changes. Validation is present so the batch-operation cap does not apply, but there is no explicit error-recovery loop (what to do when a command or write fails), which keeps it below anchor 5.

4 / 5

Progressive Disclosure

Sections (Input, Steps, Output, Artifact Creation Guidelines, Guardrails) are clearly headed and navigation is easy, and the skill effectively delegates detail to the CLI's `instructions` output at runtime rather than inlining it. At ~90 lines with some repeated guidance that could be consolidated, it sits at anchor 4 rather than 5, which is reserved for a tighter overview with well-signaled split-out references.

4 / 5

Total

16

/

20

Passed

Description

66%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 cleanly answers both what the skill does and when to use it, with an explicit differentiator against a step-by-step variant and strong niche distinctiveness thanks to the OpenSpec branding. Its weaknesses are moderate: it does not enumerate the concrete artifacts produced and lacks natural trigger synonyms a user might say.

Suggestions

Enumerate the concrete artifacts produced (e.g., proposal, specs, design, tasks) to raise specificity, e.g., "Scaffold a new OpenSpec change and generate all required artifacts (proposal, specs, tasks) in one pass."

Add natural trigger terms and synonyms users would actually say, such as "scaffold", "openspec change", "generate specs and tasks", or "batch-create artifacts", so the skill surfaces when users phrase the request differently.

Ground the "Use when" clause in observable user phrasing rather than intent, e.g., "Use when the user asks to fast-forward, scaffold, or batch-create an OpenSpec change instead of stepping through artifacts one by one."

DimensionReasoningScore

Specificity

"Fast-forward through OpenSpec artifact creation" and "quickly create all artifacts needed for implementation" name the domain and one bundled action, but the description never enumerates which artifacts are produced (e.g., proposal, specs, tasks, design). This matches anchor 3 (domain and 1-2 concrete actions, not comprehensive) and falls short of anchor 4, which expects several specific listed actions.

3 / 5

Completeness

The description has a clear "what" ("Fast-forward through OpenSpec artifact creation") and an explicit "Use when the user wants to quickly create all artifacts needed for implementation without stepping through each one individually" clause, so both parts are present. It stops short of anchor 5 because the "when" describes user intent rather than concrete trigger phrases the user would actually utter (compare anchor 5's "when the user mentions PDFs, forms, or document extraction").

4 / 5

Trigger Term Quality

Relevant keywords like "OpenSpec", "artifact", "create", and "implementation" appear, but common natural variations users would say are missing — "scaffold", "openspec change", "specs", "tasks", "generate artifacts". This fits anchor 3 (some relevant keywords, missing common variations or synonyms) rather than anchor 4's fuller keyword coverage.

3 / 5

Distinctiveness Conflict Risk

"OpenSpec" is a distinct niche tool and the clause "without stepping through each one individually" explicitly differentiates this skill from a step-by-step sibling, giving it a clear niche with distinct triggers and minimal conflict risk (anchor 5). It is clearly above anchor 4, which only requires minor overlap risk.

5 / 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

TencentBlueKing/bk-bcs

Path

bcs-runtime/bcs-k8s/bcs-component/bcs-drplan-controller/.claude/skills/openspec-ff-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.