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.

66

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 ./plugin/skills/plan-interview/SKILL.md

The canonical home for this skill is plan-interview in pskoett/pskoett-ai-skills

SKILL.md
Quality
Evals
Security

Quality

Content

73%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 content is a well-structured, actionable planning workflow with strong sequencing and validation. Its main weakness is conciseness — the Philosophy and Knowledge Audit sections and some duplication with the reference file add tokens that assume less of Claude than needed.

Suggestions

Tighten the Philosophy and Knowledge Audit sections: keep the principle and the stop-and-surface rule, drop the explanatory rationale Claude can infer.

Reduce overlap between the inline refinement-loop steps and references/iterative-plan-refinement-prompts.md by summarizing the loop in the body and pointing to the file for full templates.

Move the full required-elements markdown template into the reference file, keeping only the section list inline, to further lean out the body.

DimensionReasoningScore

Conciseness

Mostly efficient but padded in places — the Philosophy section and Knowledge Audit rationale explain concepts at length, and refinement guidance is repeated between the body and the references file.

3 / 5

Actionability

Provides concrete guidance — a file naming convention (docs/plans/plan-NNN-<slug>.md), a required-elements markdown template, named question domains, and a worked example — with only minor gaps.

4 / 5

Workflow Clarity

Four phases are clearly sequenced with explicit validation checkpoints: mandatory fresh-eyes refinement, stop-iterating criteria, a Knowledge Audit stop-and-surface rule, and user approval before implementation.

5 / 5

Progressive Disclosure

The body is well-sectioned and the reusable prompt templates are split into a clearly signaled one-level-deep reference (references/iterative-plan-refinement-prompts.md), though substantial detail remains inlined.

4 / 5

Total

16

/

20

Passed

Description

83%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 strong: it states concrete actions, gives clear trigger conditions and exclusions, and answers both 'what' and 'when'. Minor gains are possible by adding a few more natural synonyms and tightening the abstract opening line.

DimensionReasoningScore

Specificity

Names concrete actions — 'runs an upfront interview to gather requirements across technical constraints, scope boundaries, risk tolerance, and success criteria' — with only minor abstraction in the opening 'Ensures alignment' phrasing.

4 / 5

Completeness

Explicitly answers both what (structured interview that gathers requirements across four named domains) and when (use before implementing/refactoring non-trivial tasks), plus a concrete do-NOT-use clause.

5 / 5

Trigger Term Quality

Includes natural trigger phrases users would say ('implementing a new feature', 'refactoring', 'non-trivial implementation task') plus the /plan-interview invocation, though a few common synonyms are missing.

4 / 5

Distinctiveness Conflict Risk

The interview-before-exploration framing and explicit exclusion list make it mostly distinct, with only minor overlap risk against generic planning skills.

4 / 5

Total

17

/

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.

Validation16 / 16 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.