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.

68

Quality

85%

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 tightly written, fully executable workflow: concrete CLI commands, parsed JSON contracts, explicit validation checkpoints (status re-checks, file-existence verification), and user-input feedback loops. The only issues are mild redundancy across the Guidelines/Guardrails sections and a body slightly long for a single-file skill.

DimensionReasoningScore

Conciseness

The body is lean and command-driven with no concept explanations, but there is repetition that could be trimmed: 'read dependency artifacts before creating a new one' appears in Steps, Artifact Creation Guidelines, and Guardrails, and 'IMPORTANT' is used twice for near-identical context/rules warnings. These minor redundancies keep it below the every-token-earns-its-place anchor of 5.

4 / 5

Actionability

Every step gives copy-paste-ready commands (`openspec new change "<name>"`, `openspec status --change "<name>" --json`, `openspec instructions <artifact-id> --change "<name>" --json`) plus explicit JSON fields to parse (applyRequires, template, outputPath, dependencies) and exact output phrasing. The only unspecified content — the artifact file itself — is correctly delegated to the CLI-provided template rather than duplicated.

5 / 5

Workflow Clarity

The five-step sequence is explicit with a dependency-ordered loop, a re-check after each artifact (re-run `openspec status` and stop when all applyRequires artifacts are 'done'), a file-existence verification guardrail, and feedback loops (ask via AskUserQuestion when context is unclear; suggest continuing an existing change). This matches the anchor for clear sequencing with explicit validation and error-recovery loops.

5 / 5

Progressive Disclosure

With no bundle files, the ~90-line body is appropriately self-contained and well-sectioned (Input, Steps, Output, Artifact Creation Guidelines, Guardrails) — nothing here belongs in a separate reference since the CLI supplies templates at runtime. It sits just past the under-50-line threshold and lacks an explicit overview section header, so 'good structure with minor organization gaps' (4) fits better than 5.

4 / 5

Total

18

/

20

Passed

Description

73%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 concise, third-person description with an explicit 'Use when' clause, a well-defined niche, and natural trigger phrasing. Its main weakness is thin action coverage — it names the overall effect (fast-forward, create all artifacts) without enumerating the concrete capabilities a 5-level description would list.

Suggestions

Enumerate 2-3 concrete actions to lift specificity, e.g., 'Scaffold a new change, generate artifacts in dependency order (specs, design, tasks), and verify apply-readiness via openspec status.'

Add common user synonyms and command names to the trigger terms, such as 'change', 'proposal', 'tasks', or 'openspec new', so users phrasing the request differently still match.

DimensionReasoningScore

Specificity

The description names the domain ("OpenSpec artifact creation") and one concrete action ("quickly create all artifacts needed for implementation"), matching the anchor for a domain plus 1-2 concrete actions. It does not list several distinct actions (e.g., scaffolding the change, sequencing artifacts by dependency), so it falls short of a 4.

3 / 5

Completeness

Both parts are present: the 'what' ("Fast-forward through OpenSpec artifact creation... create all artifacts") and an explicit 'when' ("Use when the user wants to quickly create all artifacts needed for implementation"). The 'when' is explicit but generic — no concrete trigger phrases like 'mentions artifacts, proposals, or /opsx:create' — so it does not reach the anchor-5 example.

4 / 5

Trigger Term Quality

Natural phrases like "OpenSpec artifact creation", "quickly create all artifacts", and "without stepping through each one individually" align well with what a user would say. A few natural variations are missing (e.g., "change", "proposal", "spec", "tasks", "scaffold"), keeping it below the comprehensive-synonyms anchor of 5.

4 / 5

Distinctiveness Conflict Risk

The tightly scoped niche (OpenSpec change artifacts) plus the explicit contrast with step-by-step creation ("without stepping through each one individually") makes it clearly distinguishable from generic scaffolding or git fast-forward skills. Conflict risk is minimal.

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

dwmkerr/git-workforest

Path

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