CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

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.

88

2.70x
Quality

85%

Does it follow best practices?

Impact

100%

2.70x

Average score across 3 eval scenarios

SecuritybySnyk

Passed

No findings from the security scan

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

SKILL.md
Quality
Evals
Security

Quality

Content

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

A well-engineered process skill: the workflow is unambiguously sequenced with explicit validation gates and feedback loops, and the guidance is as concrete as an instruction-only skill can be (templates, tables, paths, worked example). Its one real weakness is token efficiency — repeated mandates across sections, a narrative philosophy section, and inlined example/template blocks keep the body longer than the content strictly earns.

Suggestions

Cut the Philosophy section down to its operative sentence ('look for structural friction; propose a preparatory refactor as a distinct first step') since Phase 2 already restates the guidance, and drop the 'Every skill in this collection...' meta-commentary.

State each mandate once: consolidate the repeated fresh-eyes, no-scope-reduction, and structural-friction instructions into their primary location (Phase 2/3) and reference them by name from Fast Mode and Resume Support instead of restating them.

Move the worked OAuth example and the full required-elements plan template into references/ (e.g. references/plan-template.md and references/example-plan.md) so SKILL.md stays a lean overview while the reference pattern already established for the refinement prompts is reused.

DimensionReasoningScore

Conciseness

The body is mostly prescriptive rather than educational, but includes unnecessary material that could be tightened: the narrative Philosophy section ('Every skill in this collection is built around a core philosophy...') is collection meta-commentary, the 'fresh-eyes' mandate, structural-friction guidance, and 'do NOT remove agreed features' each recur in 2-3 places (Phase 2, Phase 3 loop, Constraints, Fast Mode, Resume), and the full mock-dialogue example adds length. It is above a 2 because nearly all content is actionable instruction rather than concept explanation, but below a 4 because the repetition and narrative sections go beyond 'minor instances' of over-explanation.

3 / 5

Actionability

For an instruction-only skill the guidance is fully concrete: exact output path ('docs/plans/plan-NNN-<slug>.md where NNN is sequential'), a copy-paste-ready required-elements plan template including the Knowledge Map table, quantitative constraints ('2-3 questions per batch'), a planning-depth calibration table, an edge-case action table, install commands, and a worked OAuth example covering the common case. Host-tool flexibility ('ask_user, AskUserQuestion, or an equivalent') is explicitly justified, and the couple of inherently judgment-based steps ('improve architecture... where it clearly helps users') are constrained by enumerated stop conditions.

5 / 5

Workflow Clarity

The multi-phase process is explicitly sequenced (Interview → Exploration → Knowledge Audit → Plan Generation → Post-Approval) with validation checkpoints throughout: a mandatory fresh-eyes re-read before each refinement pass, enumerated loop stop conditions, a knowledge-audit gate that blocks 'nowhere reachable' steps, an edge-case handling table, user approval before implementation, and progress-vs-plan comparison at natural breakpoints. Feedback loops (draft → refine → re-check, blocked-step → surface to user) are explicit, matching the 5 anchor including checklists for the complex process.

5 / 5

Progressive Disclosure

Structure is good: clearly labeled sections, and the single bundle reference is well signaled one level deep ('Reusable prompt templates... live in references/iterative-plan-refinement-prompts.md') and the file exists with content matching that description. It is not a 5 because the ~320-line body is more than an overview — sizable blocks like the full plan template, the mock-dialogue example, and the pipeline interoperability section could be split into reference files to keep SKILL.md lean, which is exactly the 'minor organization gaps' of the 4 anchor.

4 / 5

Total

17

/

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.

A strong description: it explicitly states both what the skill does and when to use it, names the four requirement domains, includes concrete trigger phrasing tied to the /plan-interview invocation, and adds negative triggers that carve it apart from generic planning. The only meaningful gaps are a slightly narrow action vocabulary and a few missing natural synonyms (e.g. 'design', 'spec out').

DimensionReasoningScore

Specificity

The description lists several concrete actions — 'runs an upfront interview to gather requirements across technical constraints, scope boundaries, risk tolerance, and success criteria' — naming the four requirement domains explicitly. It falls short of a 5 because the action set centers on one process (interview + gather requirements) rather than multiple distinct concrete capabilities, but exceeds a 3 because it enumerates several specific sub-actions rather than only 1-2.

4 / 5

Completeness

Both questions are explicitly answered: what ('Ensures alignment... through a structured interview process... runs an upfront interview to gather requirements across [four named domains]') and when ('Use this skill when the user invokes /plan-interview before implementing a new feature, refactoring, or any non-trivial implementation task'), with concrete trigger phrases plus an explicit do-not-use clause. This matches the 5 anchor directly; the 'when' is not merely present but concrete.

5 / 5

Trigger Term Quality

Natural trigger terms are well covered: 'invokes /plan-interview', 'implementing a new feature', 'refactoring', 'non-trivial implementation task', plus negative triggers ('pure research/exploration tasks, simple bug fixes'). It is not a 5 because common phrasings users would naturally say — 'design a feature', 'spec out', 'plan a feature' — are only partially represented by 'feature/spec planning'.

4 / 5

Distinctiveness Conflict Risk

The skill is pinned to a distinct niche — a structured pre-planning interview — and explicitly disclaims overlap ('Do NOT use this skill... when the user just wants standard planning without the interview process'), which sharply reduces conflict with generic planning skills. It is not a 5 because 'feature/spec planning' is a crowded category and the interview framing is the only real differentiator, leaving minor overlap risk with closely related 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.

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository

pskoett/pskoett-ai-skills

Path

.agents/skills/plan-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.