MCPInstall

questioning

One-shot question answering using the research process. Answers inline without generating documents, then offers handoff to brainstorm or research.

Installs
277
Last 24h
—
Trending rank
—
Security
Not audited

Install

Works with every agent the skills CLI supports.

npx skills add https://github.com/desplega-ai/ai-toolbox --skill questioning
  1. 01

    Install

    Run the command in your project. The CLI asks which agents to install for.

  2. 02

    Describe the task

    Ask your agent for something this skill covers. It loads questioning automatically when relevant.

  3. 03

    Review the result

    The agent follows the SKILL.md steps, scripts and references bundled with the skill.

SKILL.md

The instructions your agent reads when the skill is triggered.

Questioning

You are answering a question directly and concisely using the research process. No documents are created by default — the answer is the deliverable.

When to Use

This skill activates when:

  • User invokes /question command
  • Another skill references desplega:questioning
  • User asks a focused question that doesn't need a full research document

Philosophy

This is the fastest path from question to answer. Unlike /research (which documents comprehensively) or /brainstorm (which explores interactively), /question gets straight to the point:

  1. Hear the question
  2. Investigate as needed
  3. Answer inline
  4. Offer next steps

No ceremony — no autonomy prompts, no preference setup, no working agreement. Just answer the question.

When you do need to ask the user something (handoff, follow-up choice), use AskUserQuestion per desplega:ask-user conventions.

Process

Step 1: Analyze the Question

Classify the question to determine what investigation is needed:

Question TypeInvestigation NeededExample
Factual/locationalQuick codebase search"Where is the auth middleware defined?"
Conceptual/howRead relevant files"How does the plugin system discover skills?"
Why/root causeDeep read + history"Why does brainstorming default to verbose?"
ComparativeRead multiple areas"What's the difference between research and question skills?"
External/librarycontext7 or web search"How does Bun's SQLite driver handle transactions?"

Step 2: Investigate

Based on the question type, use the appropriate tools. Spawn sub-agents only when needed — many questions can be answered by reading a few files directly.

For codebase questions:

  • Read directly mentioned files first (use Read tool WITHOUT limit/offset)
  • Use codebase-locator agent if you need to find WHERE something lives
  • Use codebase-analyzer agent if you need to understand HOW something works
  • Use codebase-pattern-finder agent if you need examples of a pattern

For library/framework questions:

  • Use context7 MCP to fetch documentation (resolve-library-id → query-docs)

For external/web questions:

  • Use web-search-researcher agent for documentation or examples

Efficiency rule: If you can answer by reading 1-3 files, just read them. Don't spawn sub-agents for simple lookups.

Step 3: Answer

Present the answer as inline text (not a document). Structure it naturally based on the question:

  • Short answers: 1-3 sentences with a file:line reference
  • Medium answers: A paragraph or two with key references
  • Detailed answers: Structured with headings if needed, but keep it focused

Unlike research, you MAY:

  • Suggest improvements if the question implies a problem
  • Perform root cause analysis if the question asks "why"
  • Give opinions when asked ("which approach is better?")
  • Be direct and opinionated rather than exhaustively neutral

Always include:

  • Specific file:line references for any claims about the codebase
  • Code snippets when they clarify the answer (keep them short)

Step 4: Handoff

After answering, use AskUserQuestion with:

QuestionOptions
"What would you like to do next?"1. Ask another question, 2. Save this answer to thoughts, 3. Start a brainstorm from this topic (→ /brainstorm), 4. Start research from this topic (→ /research), 5. Done

Based on the answer:

  • Ask another question: Use AskUserQuestion to ask "What's your next question?" and loop back to Step 1
  • Save this answer: Write the Q&A to thoughts/<user>/questions/YYYY-MM-DD-<topic>.md using the template at cc-plugin/base/skills/questioning/template.md. Path selection: use the user's name if known, fall back to thoughts/shared/questions/
  • Brainstorm: Suggest /brainstorm <topic> with the question's topic as context
  • Research: Suggest /research <topic> with the question's topic as context
  • Done: No further action

Looping Behavior

When the user selects "Ask another question," the skill loops:

  1. Ask for the next question via AskUserQuestion
  2. Investigate and answer (Steps 1-3)
  3. Present handoff options again (Step 4)

Each iteration is independent — no state accumulates between questions unless the user explicitly connects them.

Learning Capture

OPTIONAL SUB-SKILL: If significant insights, patterns, gotchas, or decisions emerged during this workflow, consider using desplega:learning to capture them via /learning capture. Focus on learnings that would help someone else in a future session.

What This Skill is NOT

  • Not research: No comprehensive document, no frontmatter ceremony, no multi-section output
  • Not brainstorming: No Socratic Q&A loop, no progressive document
  • Not a chatbot: Each question gets proper investigation with codebase evidence, not surface-level responses

FAQ

What does the questioning skill do?

One-shot question answering using the research process. Answers inline without generating documents, then offers handoff to brainstorm or research.

How do I install questioning?

Run npx skills add https://github.com/desplega-ai/ai-toolbox --skill questioning in your project. The skills CLI detects the agents you use and copies the skill into the right folder. For Claude Code you can also place the skill folder at ~/.claude/skills/questioning/ (personal) or .claude/skills/questioning/ (project).

Which AI agents can use questioning?

Any agent that supports the open Agent Skills format (a folder with a SKILL.md file), including Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf, Cline, OpenCode and more.

Is questioning safe to install?

No partner security audit is available yet. Skills can run commands and scripts, so read the SKILL.md and any bundled files before installing.

Who maintains questioning?

It is published by desplega-ai in desplega-ai/ai-toolbox. It has 277 recorded installs.

More from desplega-ai/ai-toolbox

View all →

researching

desplega-ai/ai-toolbox

Comprehensive codebase research skill. Documents codebase as-is by spawning parallel sub-agents and synthesizing findings into research documents.

planning

desplega-ai/ai-toolbox

Open the skill to read its SKILL.md instructions.

tdd-planning

desplega-ai/ai-toolbox

TDD-focused implementation planning. Creates plans with strict Red-Green-Commit/Rollback cycles for each step.

implementing

desplega-ai/ai-toolbox

Plan implementation skill. Executes approved technical plans phase by phase with verification checkpoints.

wts-expert

desplega-ai/ai-toolbox

Git worktree management expert for @desplega.ai/wts. Use when the user asks about git worktrees, wts commands, worktree workflows, or wants help managing multiple branches simultaneously.

ask-user

desplega-ai/ai-toolbox

Conventions for asking the user questions during a workflow via the AskUserQuestion tool. Other skills reference this to keep prompts consistent and structured.

AI & Agents284 installs

Popular code quality & workflow skills

View category →

grill-me

mattpocock/skills

A relentless interview to sharpen a plan or design.

Scan a codebase for deepening opportunities, present them as a visual HTML report, then grill through whichever one you pick.

handoff

mattpocock/skills

Compact the current conversation into a handoff document for another agent to pick up.

domain-modeling

mattpocock/skills

Build and sharpen a project's domain model. Use when discussing codebase terminology, writing or editing a GLOSSARY.md, or recording or editing an ADR.

codebase-design

mattpocock/skills

Shared vocabulary for designing deep modules. Use when the user wants to design or improve a module's interface, find deepening opportunities, decide where a seam goes, make code more testable or AI-navigable, or when another skill needs the deep-module vocabulary.

diagnosing-bugs

mattpocock/skills

Diagnosis loop for hard bugs and performance regressions. Use when the user says "diagnose"/"debug this", or reports something broken/throwing/failing/slow.