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

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-explore/SKILL.md

The canonical home for this skill is openspec-explore in dwmkerr/git-workforest

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.

The body is a well-structured, highly actionable stance definition: concrete commands, exact artifact paths, a capture-mapping table, and worked example dialogues make the desired behavior unambiguous. Its main weakness is token efficiency — the Guardrails section and the meta-diagram duplicate earlier content, and the long example transcripts inflate length without adding proportional guidance.

Suggestions

Trim the Guardrails section to only non-duplicated rules — "Don't implement" and "Don't auto-capture" restate the opening IMPORTANT note and "The user decides" guidance verbatim in spirit.

Cut or shrink the decorative meta ASCII diagram in the Visualize section; the four worked example dialogues already demonstrate diagram usage concretely.

Consider moving the four example dialogues to a references/ file (e.g., EXAMPLES.md) and keeping a one-line pointer plus the strongest example inline, reducing SKILL.md's token footprint.

DimensionReasoningScore

Conciseness

The body is mostly efficient instruction content, but the Guardrails section restates rules already covered ("Don't implement" repeats the opening "you must NEVER write code"; "Don't auto-capture" repeats "The user decides... Don't pressure. Don't auto-capture"), and the meta ASCII diagram about using diagrams is decorative rather than instructive. It is not 2 because it never explains concepts Claude already knows (no PDF-style filler); it is not 4 because the redundant restating and the decorative diagram are unnecessary tokens that could be trimmed.

3 / 5

Actionability

For an instruction-only skill the guidance is fully actionable: a copy-paste command ("openspec list --json"), exact artifact paths ("openspec/changes/<name>/proposal.md" etc.), a concrete insight-to-artifact capture table, quoted example offers, and four fully worked example dialogues covering the common entry points. It is not 4 because the examples comprehensively cover the common cases with specific commands, paths, and responses.

5 / 5

Workflow Clarity

The skill deliberately declares "There are no fixed steps" (it is a stance), yet still defines a clear entry procedure (run "openspec list --json"), explicit branching (no change exists vs. change exists, with a numbered 4-step sequence for reading artifacts), and defined endings. It is not 5 because there are no validation/checkpoint steps (though the mode forbids risky writes, so the destructive-operation cap does not apply); it is not 3 because the branching flow and entry check are explicit rather than implicit.

4 / 5

Progressive Disclosure

It is a single self-contained file with no bundle, organized into clearly headed, well-separated sections (Stance, What You Might Do, OpenSpec Awareness, Entry Points, Ending, Guardrails) that are easy to navigate. It is not 5 because the ~100 lines of example dialogues in "Handling Different Entry Points" could arguably live in a separate examples file to keep SKILL.md leaner (and the file exceeds the under-50-line simple-skill case); it is not 3 because the structure is good and nothing that clearly belongs in a separate file is inlined — the dialogues are core teaching material for a conversational stance.

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" and "when" with an explicit trigger clause and natural phrasing, but the capability list is a set of near-synonyms rather than distinct actions, and it misses common trigger synonyms like "brainstorm". Distinctiveness is moderate — the change-workflow framing helps, but the exploration/clarification territory overlaps with generic planning skills.

Suggestions

Add more distinct trigger phrases and synonyms to the "Use when" clause (e.g., "brainstorm", "talk through an approach", "bounce ideas", "compare options") to broaden natural-term coverage.

Replace the near-synonymous capability list ("exploring ideas, investigating problems, clarifying requirements") with more distinct concrete actions such as "map existing architecture, compare implementation approaches, sketch tradeoffs, surface risks".

Mention the OpenSpec context explicitly (e.g., "within an OpenSpec change workflow") to sharpen distinctiveness against generic brainstorming/planning skills.

DimensionReasoningScore

Specificity

"a thinking partner for exploring ideas, investigating problems, and clarifying requirements" names the domain and a couple of actions, but these are near-synonymous framings of "think about things" rather than distinct concrete capabilities. It is not 4 because it lacks several specific, differentiated actions like the anchor's "Extracts text, fills forms, converts pages"; it is not 2 because the domain and actions are named, not merely generic.

3 / 5

Completeness

The description has both a clear "what" ("a thinking partner for exploring ideas, investigating problems, and clarifying requirements") and an explicit "when" ("Use when the user wants to think through something before or during a change"). It is not 5 because the "when" is a single trigger clause without multiple concrete trigger phrases; it is not 3 because the "when" is explicitly stated, not merely implied.

4 / 5

Trigger Term Quality

"think through something", "exploring ideas", and "clarifying requirements" are natural phrases a user would plausibly say, giving good keyword coverage. It is not 5 because common variations and synonyms such as "brainstorm", "talk through an approach", or "bounce ideas off" are missing; it is not 3 because the natural terms present go beyond a single generic keyword.

4 / 5

Distinctiveness Conflict Risk

"explore mode" and "before or during a change" tie the description to a change-exploration niche, but "exploring ideas" and "clarifying requirements" are broad territory that overlaps with generic planning and brainstorming skills. It is not 4 because the overlap risk extends beyond closely related skills; it is not 2 because the change-workflow framing gives it some specificity.

3 / 5

Total

14

/

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