Agent skill

Plan Interview

by pskoett in pskoett/pskoett-ai-skills

Ensures alignment between user and Claude during feature/spec planning through a structured interview process.

No licenceAuto-check passedDevelopment

Install Plan Interview

skills CLI
$ npx skills add pskoett/pskoett-ai-skills --skill plan-interview -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install pskoett/pskoett-ai-skills plan-interview --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/pskoett/pskoett-ai-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/plan-interview .claude/skills/plan-interview && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
plan-interview
GitHub stars
311
Token cost
~3.7k tokens
SKILL.md length
1,485 words
Files
2 (incl. references)
Skills in repo
24
Repo updated
First seen
Licence
None found

At a glance

Ensures alignment between user and Claude during feature/spec planning through a structured interview process.

  • Works in 4 steps: Upfront Interview (Before Exploration) → Codebase Exploration → Plan Generation → …
  • The user invokes /plan-interview before implementing a new feature
  • SKILL.md covers Install, Philosophy, Purpose and When Invoked, plus 5 more sections
  • Calls gh and npx

What it does

Plan Interview is an agent skill from pskoett/pskoett-ai-skills. 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…

Its SKILL.md is about 3.7k tokens, which your agent loads only when the skill is triggered. The skill folder holds 2 other files, including reference files (for example `references/iterative-plan-refinement-prompts.md`).

It sits in Development, covering Debugging, PRD writing and Refactoring.

When your agent uses it

  • The user invokes /plan-interview before implementing a new feature
  • Any non-trivial implementation task
  • : pure research/exploration tasks
  • Simple bug fixes

Example prompts

  • “Use the plan-interview skill to ensure alignment between user and Claude during feature/spec planning through a structured interview process”
  • “/plan-interview”

Requirements

  • Node.js

Workflow steps

4 steps, taken from the step headings in SKILL.md.

  1. Upfront Interview (Before Exploration)
  2. Codebase Exploration
  3. Plan Generation
  4. Post-Approval

What it can do on your machine

Read from SKILL.md and the folder at commit 5a836dc. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • gh
    • npx

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md. Its commands use gh and npx, which can reach the network depending on how they are called.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Plan Interview loads about 3.7k tokens when it runs, and up to ~4.6k if it reads all its reference files. Until then it costs about 150 tokens; SKILL.md has 1,485 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~150
When it runs · the whole SKILL.md, loaded when a task matches
~3.7k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~4.6k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

Without a licence we can't republish the file, so here is its outline and opening line. It has 1,485 words (~3,662 tokens).

“Fallback using the Agent Skills CLI:”

— opening of SKILL.md by pskoett
name
plan-interview

Read the full SKILL.md on GitHub

Files

SKILL.md and 1 other file (references) in skills/plan-interview of pskoett/pskoett-ai-skills.

  • SKILL.md
  • references/iterative-plan-refinement-prompts.md

Open the folder on GitHubat commit 5a836dc

Compare with similar skills

Plan Interview next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Plan Interview compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Plan Interview this skillpskoett/pskoett-ai-skills311—~3.7kAutomated safety check: PassNone
Panel Reviewstacklok/mecatl241—~5.8kAutomated safety check: PassApache-2.0
Grilling Ideasopsmill/infrahub531—~3.8kAutomated safety check: PassApache-2.0
Code Review Graph Navigatorhandsontable/handsontable22k—~939Automated safety check: PassCustom licence
Andrej Karpathy Skillduolahypercho/andrej-karpathy-skills248—~793Automated safety check: PassMIT
Verdaccio Change Implementationverdaccio/verdaccio18k—~1.3kAutomated safety check: PassMIT

Similar skills

  • Panel Review

    stacklok/mecatl

    Review completed non-trivial code across four independent axes: Spec, Standards, Test adequacy, and installed Domain specialists.

    241 GitHub stars~5.8k tokensUpdated today
    DevelopmentAuto-check passed
  • Grilling Ideas

    opsmill/infrahub

    Stress-tests a fuzzy or vague feature idea before any PRD, spec, or ticket is written.

    531 GitHub stars~3.8k tokensUpdated today
    Product & Project ManagementAuto-check passed
  • Code Review Graph Navigator

    handsontable/handsontable

    Queries a pre-built, Tree-sitter-based code graph of the whole monorepo instead of grepping call chains, for exploring, debugging, refactoring or reviewing code.

    22k GitHub stars~939 tokensUpdated today
    DevelopmentAuto-check passed
  • Andrej Karpathy Skill

    duolahypercho/andrej-karpathy-skills

    Apply Andrej Karpathy-inspired coding-agent guidelines in Codex.

    248 GitHub stars~793 tokensUpdated 4 mo ago
    DevelopmentAuto-check passed
  • A workflow for implementing a Verdaccio bug fix, feature or refactor: pick the release lines, check existing options, edit the owning layer, test and add a changeset.

    18k GitHub stars~1.3k tokensUpdated yesterday
    DevelopmentAuto-check passed
  • Roam

    Cranot/roam-code

    Codebase comprehension via roam-code CLI. An agent skill from Cranot/roam-code.

    517 GitHub stars~2.4k tokensUpdated 4 days ago
    DevelopmentAuto-check passed

More from pskoett/pskoett-ai-skills

All 24 skills in this repo
  • Self Improvement

    pskoett/pskoett-ai-skills

    Captures learnings, errors, corrections, and feature requests to enable continuous improvement.

    311 GitHub stars~5k tokensUpdated 3 days ago
    Auto-check passed
  • Self Improvement

    pskoett/pskoett-ai-skills

    Captures learnings, errors, corrections, and feature requests to enable continuous improvement.

    311 GitHub stars~5.4k tokensUpdated 3 days ago
    Auto-check passed
  • Self Healing

    pskoett/pskoett-ai-skills

    Active runtime recovery for coding agents: when something breaks mid-task, diagnose the root cause, write a fix, VERIFY by re-running the broken thing, then file a HEAL- entry to .learnings/HEALS.md…

    311 GitHub stars~5.3k tokensUpdated 3 days ago
    Auto-check: notes
  • Skill Tester

    pskoett/pskoett-ai-skills

    Validates all interactive skills in this repo against the Agent Skills spec, project conventions, and structural requirements.

    311 GitHub stars~1.3k tokensUpdated 3 days ago
    Auto-check passed
  • Skill Tester CI

    pskoett/pskoett-ai-skills

    Validates all CI skills in this repo. An agent skill from pskoett/pskoett-ai-skills.

    311 GitHub stars~845 tokensUpdated 3 days ago
    Auto-check passed
  • Context Decay

    pskoett/pskoett-ai-skills

    Revalidate persistent agent knowledge by classifying why it can become stale and how quickly it changes, then retain, revise, externalize, or retire it.

    311 GitHub stars~3.3k tokensUpdated 3 days ago
    Auto-check passed

Categories

Questions about Plan Interview

What does Plan Interview do?

Ensures alignment between user and Claude during feature/spec planning through a structured interview process. Plan Interview is an agent skill from pskoett/pskoett-ai-skills. Ensures alignment between user and Claude during feature/spec planning through a structured interview process.

When should I use Plan Interview?

Plan Interview fits situations like: the user invokes /plan-interview before implementing a new feature; any non-trivial implementation task; : pure research/exploration tasks; simple bug fixes.

How do I install Plan Interview in Claude Code?

Run `npx skills add pskoett/pskoett-ai-skills --skill plan-interview -a claude-code`. Or copy the skill folder (skills/plan-interview in pskoett/pskoett-ai-skills) into .claude/skills/plan-interview in your project. Claude Code loads it when a task matches its description.

How do I install Plan Interview in Codex?

Run `npx skills add pskoett/pskoett-ai-skills --skill plan-interview -a codex`. Or copy the skill folder (skills/plan-interview in pskoett/pskoett-ai-skills) into .agents/skills/plan-interview in your project. Codex loads it when a task matches its description.

Can I use Plan Interview in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add pskoett/pskoett-ai-skills --skill plan-interview -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/plan-interview, .gemini/skills/plan-interview, .github/skills/plan-interview and .opencode/skills/plan-interview in your project.

What does Plan Interview need to run?

Going by SKILL.md and its folder, Plan Interview needs the command-line tools its instructions call (gh and npx). Our summary lists: Node.js.

Does Plan Interview access the network?

SKILL.md contains no URLs. Its commands use gh and npx, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Plan Interview safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Plan Interview use?

No licence was found for Plan Interview or its repository. Without one, default copyright applies: ask the author before reusing or redistributing it.

How many tokens does Plan Interview use?

About 3.7k tokens (SKILL.md is roughly 15k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 958 tokens, read only when the agent opens those files.

What are the alternatives to Plan Interview?

Skills that share tags, products or a category with Plan Interview: Panel Review (stacklok/mecatl, 241 stars), Grilling Ideas (opsmill/infrahub, 531 stars), Code Review Graph Navigator (handsontable/handsontable, 22k stars) and Andrej Karpathy Skill (duolahypercho/andrej-karpathy-skills, 248 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Plan Interview?

pskoett (a GitHub user) maintains it in pskoett/pskoett-ai-skills, which has 311 GitHub stars. The repository holds 24 skills in this directory. The repository was last updated on October 5, 2026.

Source: pskoett/pskoett-ai-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.