# Clarify User Intent Before Execution

Ambiguous requests can lead to incorrect plans, wasted work, and missed constraints. This skill analyzes intent, asks focused questions, and produces a clear execution brief.

## Install

```bash
npx skillstore add dnyoussef/when-analyzing-user-intent-use-intent-analyzer
```

## Metadata

- Status: approved
- Slug: dnyoussef-when-analyzing-user-intent-use-intent-analyzer
- Version: 1.0.0
- Author version: 1.0.0
- Skillstore revision: r1
- Version status: valid
- Tree hash: b57c69560505e9fded7e83d273cf15713d7ec98ec16b8801e2080228c44eea80
- Author: DNYoussef
- GitHub username: DNYoussef
- License: MIT
- Repository: https://github.com/DNYoussef/ai-chrome-extension/tree/main/.claude/skills/utilities/when-analyzing-user-intent-use-intent-analyzer
- Ref: 72d5025b022c77f7a51bdf5c1637c689c80e89d1
- Supported tools: Claude, Codex, Claude Code
- Audit status: complete
- Agent install advisory: confirmation\_required
- Manual install advisory: allowed
- Artifact signature: available
- Audit attestation: unavailable
- Human verification: not\_verified
- Risk factors: filesystem, external\_commands, env\_access
- Quality score: 38
- Quality tier: warning
- Public page: https://skillstore.pages.dev/skills/dnyoussef-when-analyzing-user-intent-use-intent-analyzer
- Manifest: https://skillstore.pages.dev/api/skills/dnyoussef-when-analyzing-user-intent-use-intent-analyzer/manifest

## Capabilities

- Breaks a request into actions, subjects, constraints, and desired outcomes.
- Ranks multiple interpretations with probability and confidence labels.
- Generates up to three clarifying questions for high-impact ambiguities.
- Synthesizes a final understanding with scope, approach, deliverables, and risks.
- Creates handoff artifacts such as an execution brief and next-step plan.

## Use Cases

- Clarify Vague Feature Requests: Turn a short or unclear feature request into scoped work with assumptions and next steps.
- Prepare Stakeholder Briefs: Convert rough stakeholder input into a clear execution brief before planning begins.
- Reduce Operational Ambiguity: Ask focused questions before acting on unclear support, DevOps, or workflow requests.

## Prompt Templates

### Clarify a Simple Request

```
Analyze this request for intent. Identify the likely goal, missing details, and one clarifying question: [paste request].
```

### Rank Possible Interpretations

```
List three possible interpretations of this request. Rank them by likelihood and explain the evidence for each one: [paste request].
```

### Create an Execution Brief

```
Create an execution brief from this request. Include interpreted intent, assumptions, constraints, risks, and confirmation questions: [paste request].
```

### Analyze a High-Stakes Request

```
Perform a careful intent analysis for this high-stakes request. Limit context to nonsecret data, rank interpretations, and require confirmation before action: [paste request].
```

## Limitations

- Requires user confirmation for uncertain interpretations.
- Examples assume claude-flow tooling is available.
- May over-collect context unless environment and filesystem access are limited.
- Does not execute the final development task by itself.

## Best Practices

- Use this skill for ambiguous, complex, or high-impact requests.
- Limit context collection and redact secrets before analysis starts.
- Confirm the final interpretation before handing work to another workflow.

## Anti Patterns

- Do not run command examples without reviewing dependencies and file paths.
- Do not treat a probability score as user consent.
- Do not ask more clarifying questions than the decision requires.

## Security Audit

- Audited at: 2026-07-06T11:51:38.863\+00:00
- Summary: The audit confirmed real risks around full environment capture, mutable npx-based external tooling, shell script examples, and predictable /tmp output paths. Most static backtick findings were false positives caused by markdown fences or JavaScript template literals, and no prompt injection text was found.

## Stats

- Views: 271
- Downloads: 6
- Favorites: 0
- Popularity score: 0