CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

deep-interview

Socratic deep interview with mathematical ambiguity gating before explicit execution approval

Quality

63%

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 ./skills/deep-interview/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

58%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 skill is exceptionally actionable and its multi-phase workflow is unambiguous with validation checkpoints throughout. Its weaknesses are token efficiency (heavy rule repetition) and progressive disclosure: a 50KB monolithic body with no working external references loads everything into context at all times.

Suggestions

State each cross-cutting rule once in an authoritative section: the prompt-budget/threshold rules are currently repeated across Execution_Policy, Phase 1, Step 2a, Phase 4, Phase 5, and the Final_Checklist.

Move the Examples section, the Phase 4 spec template, and the Advanced configuration into a references/ directory, keeping SKILL.md as a concise overview with clearly signaled one-level-deep links.

Fix or remove the dangling docs/company-context-interface.md reference, and document the state_write/state_read interface it depends on (or link to where it is defined).

DimensionReasoningScore

Conciseness

The ~800-line body restates the same rules many times: prompt-budget handling appears in Execution_Policy, Phase 1 step 3.6, Step 2a, Phase 4, Phase 5, and the Final_Checklist, and the Phase 0 threshold protocol is repeated in step 3.5, the announcement, and the checklist, plus plugin-internal material like the 'Native Plugin Invocation Guard (Issue #3030)'. This is noticeably verbose with several padded/redundant sections, matching anchor 2 rather than the mostly-efficient profile of anchor 3.

2 / 5

Actionability

The body provides copy-paste-ready artifacts: the full ambiguity-scoring prompt, exact formulas, exact JSON state schemas, exact spec paths, a complete spec template, and concrete Good/Bad examples. Minor gaps keep it below anchor 5: state_write/state_read are used without interface detail, and the docs/company-context-interface.md reference has no backing file in the bundle.

4 / 5

Workflow Clarity

Phases 0-5 are explicitly sequenced with per-round validation (score after every answer, threshold gate, weakest-dimension targeting), soft limits at rounds 10/20, escalation and stop conditions, and a final checklist. This matches the anchor for a clear sequence with explicit validation steps, feedback loops, and checklists.

5 / 5

Progressive Disclosure

No references/, scripts/, or assets/ files exist; everything including the Examples section, the full spec template, and Advanced configuration is inlined into one ~50KB monolithic SKILL.md, and the one external pointer (docs/company-context-interface.md) is dangling. Content that clearly belongs in separate files is inlined, matching anchor 2; it is above anchor 1 only because the internal section structure is well organized.

2 / 5

Total

13

/

20

Passed

Description

53%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 specific and distinct within its niche, but it answers only 'what' and never 'when'. Adding an explicit 'Use when...' clause with natural trigger phrases would address its main weakness.

Suggestions

Add an explicit 'Use when' clause with concrete trigger phrases such as 'Use when the user has a vague idea, says interview me, or wants requirements clarified before execution' to satisfy the completeness dimension.

Include natural user-facing synonyms ('vague idea', 'requirements gathering', 'clarify', 'ask me everything') alongside 'Socratic' and 'deep interview' to broaden trigger term coverage.

Name the core concrete actions in plain language (asks one question at a time, scores ambiguity per answer, writes a spec) instead of compressing them into jargon like 'mathematical ambiguity gating'.

DimensionReasoningScore

Specificity

The description names its domain ('Socratic deep interview') and two concrete mechanisms ('mathematical ambiguity gating', 'explicit execution approval'), matching the anchor for 1-2 concrete actions without comprehensive coverage. It does not list several specific actions, so it is not a 4.

3 / 5

Completeness

It conveys a clear 'what' (Socratic interviewing gated by an ambiguity threshold before execution approval) but provides no 'when' / 'Use when' guidance at all, which caps completeness at 3 per the judging guidelines. The 'what' is concrete enough that it is not the vague-what-no-when case of anchor 2.

3 / 5

Trigger Term Quality

'Socratic' and 'deep interview' are natural keywords some users would say, but the description omits common phrasings like 'vague idea', 'interview me', or 'clarify requirements' and leans on jargon ('mathematical ambiguity gating'). Keyword coverage is partial with missing variations, matching anchor 3 rather than the good coverage of anchor 4.

3 / 5

Distinctiveness Conflict Risk

'Socratic deep interview' carves a distinct niche (requirements clarification) with triggers unlikely to collide with file-manipulation or execution skills; only minor overlap risk with general planning/spec skills, matching anchor 4 rather than the minimal-conflict clarity of anchor 5.

4 / 5

Total

13

/

20

Passed

Validation

87%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

skill_md_line_count

SKILL.md is long (816 lines); consider splitting into references/ and linking

Warning

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

14

/

16

Passed

Repository

Yeachan-Heo/oh-my-claudecode

Path

skills/deep-interview/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.