CtrlK
BlogDocsLog inGet started
Tessl Logo

plan-interview

Ensures alignment between user and Claude during feature/spec planning through a structured interview process. Use this skill when the user invokes /plan-interview before implementing a new feature, refactoring, or any non-trivial implementation task. The skill runs an upfront interview to gather requirements across technical constraints, scope boundaries, risk tolerance, and success criteria before any codebase exploration. Do NOT use this skill for: pure research/exploration tasks, simple bug fixes, or when the user just wants standard planning without the interview process.

82

2.00x
Quality

73%

Does it follow best practices?

Impact

96%

2.00x

Average score across 3 eval scenarios

SecuritybySnyk

Advisory

Suggest reviewing before use

Optimize this skill with Tessl

npx tessl skill review --optimize ./skills/plan-interview/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Discovery

85%

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

This is a strong skill description that clearly defines its purpose, trigger conditions, and boundaries. The explicit 'Use when' and 'Do NOT use' clauses provide excellent guidance for skill selection. The main weakness is that trigger terms lean on a slash command rather than natural language variations users might use when they need this capability.

Suggestions

Add natural language trigger terms beyond the slash command, such as 'requirements gathering', 'scoping session', 'discovery interview', or 'clarify requirements before building'.

DimensionReasoningScore

Specificity

Lists multiple specific concrete actions: 'structured interview process', 'gather requirements across technical constraints, scope boundaries, risk tolerance, and success criteria', and specifies it runs 'before any codebase exploration'. Also includes explicit exclusions (pure research, simple bug fixes).

3 / 3

Completeness

Clearly answers both 'what' (structured interview to gather requirements across technical constraints, scope boundaries, risk tolerance, success criteria) and 'when' (explicit 'Use this skill when' clause with triggers, plus a 'Do NOT use' clause for negative triggers). Both are explicit and well-defined.

3 / 3

Trigger Term Quality

Includes the explicit trigger '/plan-interview' and natural terms like 'feature', 'spec planning', 'refactoring', 'implementation task', but relies heavily on a slash command rather than natural language terms users might say. Missing variations like 'requirements gathering', 'discovery', 'scoping', or 'interview questions'.

2 / 3

Distinctiveness Conflict Risk

Highly distinctive due to the specific '/plan-interview' trigger, the structured interview process framing, and the explicit 'Do NOT use' exclusions that differentiate it from standard planning skills, research tasks, and bug fix workflows.

3 / 3

Total

11

/

12

Passed

Implementation

62%

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

This is a well-structured, highly actionable skill with excellent workflow clarity and a thorough multi-phase process. However, it suffers significantly from verbosity — philosophical preambles, install instructions, extensive explanations of concepts Claude already understands, and inline content that should be in reference files. The skill would be substantially improved by aggressive trimming and better use of progressive disclosure to separate the core operational instructions from supporting material.

Suggestions

Remove the Philosophy section and install instructions from the skill body — distill the 'preparatory refactor' insight into a single sentence within the Codebase Exploration phase where it's actionable.

Move the Interoperability section to a separate reference file (e.g., references/pipeline-integration.md) and replace with a one-line reference link.

Trim the Knowledge Audit section by ~50% — the concept is valuable but the explanation is over-detailed; Claude doesn't need to be told why guessing is bad.

Move the Multi-Plan Synthesis and Fast Mode sections to a reference file, keeping only a brief mention and link in the main skill.

DimensionReasoningScore

Conciseness

The skill is extremely verbose at ~300+ lines. It includes extensive philosophical preamble ('Make the change easy, then make the change'), explains concepts Claude already knows (what a knowledge audit is, what anti-patterns are), includes install instructions that aren't part of the skill's operational content, and has lengthy sections on pipeline interoperability that could be a simple reference link. Much of this could be cut by 50%+ without losing actionable guidance.

1 / 3

Actionability

The skill provides highly concrete, actionable guidance: specific question domains with examples, a clear plan template with required markdown sections, explicit handling of edge cases in a table, a knowledge audit classification scheme, and a complete worked example showing the interview flow with realistic user responses. The guidance is specific enough to execute directly.

3 / 3

Workflow Clarity

The four-phase workflow (Interview → Exploration → Plan Generation → Post-Approval) is clearly sequenced with explicit validation checkpoints: the knowledge audit between exploration and planning, the iterative refinement loop with clear stopping criteria, the fresh-eyes mandatory re-read step, and the resume support for interrupted sessions. Edge cases and feedback loops are well-defined.

3 / 3

Progressive Disclosure

The skill references external files (references/iterative-plan-refinement-prompts.md, context-surfing handoff files) which is good, but the main file itself is monolithic with too much inline content. The interoperability section, philosophy section, install instructions, and the detailed refinement prompts could be split into separate reference files. The structure within the file is decent with clear headers, but the sheer volume of inline content hurts discoverability.

2 / 3

Total

9

/

12

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.

Validation11 / 11 Passed

Validation for skill structure

No warnings or errors.

Repository
pskoett/pskoett-ai-skills
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.