CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

openspec-explore

Enter explore mode - a thinking partner for exploring ideas, investigating problems, and clarifying requirements. Use when the user wants to think through something before or during a change.

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 ./.zcode/skills/openspec-explore/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

67%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 delivers a clear, well-structured stance with genuinely concrete OpenSpec commands and a capture workflow that includes validation feedback loops. Its weaknesses are verbosity from repeated store-flag guidance and redundant sections, and capture-workflow steps written as dense conditional paragraphs rather than scannable checklists.

Suggestions

State the '--store' stickiness rule once (in the Store selection section) and refer back to it from the workflow steps instead of repeating the parenthetical in steps 2, 3, and 4.

Merge 'What You Don't Have To Do' and 'Guardrails' or trim overlaps with 'This is a stance, not a workflow' to cut redundant tokens.

Break the run-on conditional paragraphs in the capture workflow into a short checklist with an explicit 'after each artifact: re-run status' checkpoint for both the new-change and existing-change branches.

DimensionReasoningScore

Conciseness

The body is mostly efficient — stance bullets, concrete commands, and example dialogues all earn their place — but it has noticeable tightening opportunities: the '--store' stickiness rule is restated nearly verbatim in the Store-selection paragraph and again inside steps 2, 3, and 4 of the capture workflow, and the 'What You Don't Have To Do' and 'Guardrails' sections repeat points already made by 'This is a stance, not a workflow' and 'Don't auto-capture'. This fits anchor 3 (mostly efficient but could be tightened) rather than anchor 2, since the padding is redundancy in otherwise valuable guidance, not explanation of concepts Claude already knows.

3 / 5

Actionability

Concrete, executable commands appear throughout: `openspec list --json`, `openspec new change "<name>"`, `openspec status --change "<name>" --json`, `openspec instructions "<artifact-id>" --change "<name>" --json`, plus a specific decision table mapping insight types to capture locations. This matches anchor 4 (mostly executable guidance with minor gaps); it does not reach anchor 5 because several directives remain necessarily abstract ('Follow the returned template and instruction fields', 'Use root.path returned above') without worked examples of the JSON fields in play, and it is above anchor 3 because the guidance that can be concrete is given as exact commands rather than pseudocode.

4 / 5

Workflow Clarity

The capture workflow is a clearly numbered 1-4 sequence with an explicit validation feedback loop in step 4 ('After creating each artifact, re-run `openspec status --change "<name>" --json` ... and continue until every requested artifact is done, skipped, or was deliberately skipped'), and error-recovery paths (blocked prerequisites, conditional skips) are enumerated. This fits anchor 4 (clear sequence with most checkpoints present). It falls short of anchor 5 because steps 2-4 are dense run-on paragraphs with nested conditionals that are hard to follow as a checklist, and the 'when a change exists' branch has checkpoints ('re-run status') only implied rather than stated.

4 / 5

Progressive Disclosure

There are no bundle files, so everything lives in SKILL.md (~290 lines), but the single file is well organized into clear, well-signaled sections (The Stance, What You Might Do, OpenSpec Awareness, Handling Different Entry Points, Ending Discovery, Guardrails) that are easy to navigate. This matches anchor 4 (good structure; most content appropriately placed). It does not reach anchor 5 because the ~100 lines of example dialogues in 'Handling Different Entry Points' are content that could plausibly live in a references file, and it is above anchor 3 because nothing that clearly belongs in a separate file (like an API reference) is inlined and no nested or buried references exist.

4 / 5

Total

15

/

20

Passed

Description

78%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 is compact, explicit, and answers both what the skill does and when to use it, with a natural trigger phrase. Its main weakness is that the stated capabilities are abstract role language ('thinking partner') rather than concrete actions, leaving a reader without the body only a general sense of what will actually happen.

Suggestions

Replace or supplement the abstract role phrases with one or two concrete capabilities, e.g. 'map architecture, compare options, and surface risks' or 'capture exploration into OpenSpec change proposals'.

Add one or two natural synonyms users might say, such as 'brainstorm' or 'talk through an approach', to broaden trigger coverage.

DimensionReasoningScore

Specificity

The description lists actions — 'a thinking partner for exploring ideas, investigating problems, and clarifying requirements' — but these are abstract role descriptions rather than concrete capabilities (no mention of e.g. reading the codebase, mapping architecture, or creating change proposals). It matches anchor 3 (names domain and 1-2 concrete actions, but not comprehensive); it is below anchor 4 because the actions named are not specific, executable operations, and above anchor 2 because it does enumerate several distinct facets of the domain rather than a bare domain label.

3 / 5

Completeness

Both questions are answered explicitly: the what ('a thinking partner for exploring ideas, investigating problems, and clarifying requirements') and the when ('Use when the user wants to think through something before or during a change'), with 'think through something before or during a change' serving as a concrete trigger phrase. This matches anchor 5; anchor 4 would apply only if the 'when' were implicit or less explicit, which it is not.

5 / 5

Trigger Term Quality

Natural phrases a user would say are present: 'think through something', 'exploring ideas', 'investigating problems', 'clarifying requirements'. It sits at anchor 4 (good keyword coverage; a few natural terms missing) rather than 5 because common synonyms like 'brainstorm', 'talk through', 'discuss', or 'spike' are absent, and it is above anchor 3 because the phrases included are ones users naturally say, not just domain jargon.

4 / 5

Distinctiveness Conflict Risk

The niche ('Enter explore mode', 'thinking partner', 'before or during a change') is distinct and unlikely to fire for unrelated skills, matching anchor 4 (mostly distinct; minor overlap risk). It falls short of anchor 5 because 'exploring ideas' and 'investigating problems' are broad phrases that could overlap with general brainstorming or research skills, but it is clearly above anchor 3 since the explore-mode framing and change-lifecycle timing are specific to this skill's ecosystem.

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

.zcode/skills/openspec-explore/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.