
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- 01
Install
Run the command in your project. The CLI asks which agents to install for.
- 02
Describe the task
Ask your agent for something this skill covers. It loads questioning automatically when relevant.
- 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
/questioncommand - 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:
- Hear the question
- Investigate as needed
- Answer inline
- 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 Type | Investigation Needed | Example |
|---|---|---|
| Factual/locational | Quick codebase search | "Where is the auth middleware defined?" |
| Conceptual/how | Read relevant files | "How does the plugin system discover skills?" |
| Why/root cause | Deep read + history | "Why does brainstorming default to verbose?" |
| Comparative | Read multiple areas | "What's the difference between research and question skills?" |
| External/library | context7 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:linereferences for any claims about the codebase - Code snippets when they clarify the answer (keep them short)
Step 4: Handoff
After answering, use AskUserQuestion with:
| Question | Options |
|---|---|
| "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>.mdusing the template atcc-plugin/base/skills/questioning/template.md. Path selection: use the user's name if known, fall back tothoughts/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:
- Ask for the next question via AskUserQuestion
- Investigate and answer (Steps 1-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
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.
Popular code quality & workflow skills
grill-me
mattpocock/skills
A relentless interview to sharpen a plan or design.
improve-codebase-architecture
mattpocock/skills
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.