skills/dnyoussef/intent-analyzer/SKILL.md
Advanced intent interpretation system that analyzes user requests using cognitive science principles and extrapolates logical volition. Use when user requests are ambiguous, when deeper understanding would improve response quality, or when helping users clarify what they truly need. Applies probabilistic intent mapping, first principles decomposition, and Socratic clarification to transform vague requests into well-understood goals.
npx skillsauth add aiskillstore/marketplace intent-analyzerInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
An advanced system for deeply understanding user intent by going beyond surface-level requests to discover underlying goals, unstated constraints, and true needs.
Intent Analyzer represents a sophisticated approach to understanding what users really want. Rather than taking requests at face value, it employs cognitive science principles to examine underlying intent, identify implicit assumptions, recognize unstated constraints, and help users articulate their true goals clearly.
This skill draws inspiration from coherent extrapolated volition in AI alignment theory—determining what someone would want if they "knew more, thought faster, and were more the person they wished they were." Applied practically, this means understanding not just what the user explicitly requested, but what they would have requested with complete knowledge of possibilities, perfect clarity about their goals, and full awareness of relevant constraints.
Apply Intent Analyzer when:
This skill is particularly valuable for complex, open-ended, or high-stakes requests where misunderstanding intent could lead to significant wasted effort or poor outcomes.
Intent Analyzer operates on five fundamental principles:
Break down every request to its most fundamental goals. Question surface-level assumptions about what is being asked. Often, the stated request is a proxy for a deeper underlying need.
For example:
Identify these underlying intentions by decomposing the request to its fundamental purpose.
Every user message carries multiple possible interpretations with varying probabilities. Construct a probability distribution over potential intents considering:
When multiple high-probability interpretations exist, explicitly acknowledge uncertainty and seek clarification rather than guessing. When one interpretation is clearly dominant (>80% confidence), proceed while remaining open to correction.
Recognize which category of request this represents based on established taxonomies:
Each category has characteristic patterns, common unstated assumptions, and typical underlying goals. Use pattern recognition to inform interpretation.
Identify both explicit and implicit constraints:
Explicit constraints: Directly stated requirements like word limits, specific formats, deadline pressures, technical requirements, or resource limitations
Implicit constraints: Emerge from context such as:
Surface implicit constraints through strategic questioning when they significantly impact the response.
When facing genuine uncertainty, engage in targeted questioning designed to reveal:
These questions are strategically chosen to disambiguate between competing interpretations, not to gather exhaustive details. Quality questions prevent wasted effort on wrong interpretations.
Upon receiving a request, immediately engage in comprehensive internal analysis:
Intent Archaeology: Excavate the layers of intent:
Goal Extrapolation: Construct a model of what the user is ultimately trying to achieve:
For example, someone asking for code to scrape a website might be:
Each underlying goal suggests different optimal responses.
Constraint Detection: Identify constraints both explicit and implicit:
Pattern Recognition: Map the request to established categories and identify which prompting patterns would be most beneficial. Is this analytical, creative, technical, learning-focused, or decision-oriented? Each benefits from different approaches.
Ambiguity Assessment: Quantify uncertainty in interpretation:
After internal analysis, choose between two paths:
Path A - High Confidence Interpretation: When analysis reveals clear dominant interpretation (confidence >80%), proceed directly while:
Path B - Clarification Required: When analysis identifies:
Engage in Socratic clarification before proceeding.
When clarification is needed, ask strategic questions:
Disambiguation Questions: Distinguish between competing interpretations:
Constraint Revelation Questions: Surface unstated constraints:
Context Gathering Questions: Build essential understanding:
Assumption Validation Questions: Verify implicit assumptions:
Keep clarification focused and efficient. Avoid overwhelming with questions. Ask 1-3 strategic questions maximum in a single turn.
After clarification (if needed), reconstruct the request with improved clarity:
Intent Synthesis: Combine explicit statements with uncovered implicit goals into comprehensive understanding of true intent.
Assumption Surfacing: Make previously implicit assumptions explicit:
Approach Signaling: Indicate the approach being taken:
This transparency allows users to correct misunderstandings early.
Different request patterns suggest different underlying intents:
Patterns: "Write," "Create," "Design," "Come up with" Common underlying goals:
Key questions to disambiguate:
Patterns: "Analyze," "Evaluate," "Compare," "Assess" Common underlying goals:
Key questions to disambiguate:
Patterns: "Fix," "Debug," "Build," "Implement" Common underlying goals:
Key questions to disambiguate:
Patterns: "Explain," "How does," "Teach me," "I don't understand" Common underlying goals:
Key questions to disambiguate:
Patterns: "Should I," "Which is better," "What do you recommend" Common underlying goals:
Key questions to disambiguate:
Consider timing-related intent signals:
Identify who will consume the output:
Assess user's expertise from:
Adjust explanation depth and technical detail accordingly.
Identify requests that are actually about the conversation itself:
When making significant interpretive leaps:
Make implicit assumptions explicit when relevant:
Users can always override interpretation:
Don't immediately jump to maximum complexity:
Calibrate interpretation based on user sophistication:
Detect expertise through:
Different domains have different conventions:
When users express dissatisfaction or correction:
Treat conversations as iterative refinement:
Clarify when:
Proceed when:
Could mean:
Disambiguate: Check if they've already tried something or if starting from scratch
Could mean:
Disambiguate: Ask what they're trying to decide or evaluate
Could mean:
Disambiguate: Ask what aspects they want improved or what "better" means
Intent Analyzer transforms request interpretation from surface-level reading to deep understanding. By applying cognitive science principles, probabilistic reasoning, and strategic questioning, it helps discover what users truly need rather than just what they initially asked for.
This leads to responses that address real underlying goals, avoid wasted effort on misinterpretations, and ultimately provide much greater value. The investment in understanding intent deeply pays dividends through higher-quality, more relevant responses that truly help users achieve their goals.
Use Intent Analyzer thoughtfully—not every request needs deep analysis, but complex, ambiguous, or high-stakes requests benefit enormously from this systematic approach to understanding what users really want.
development
Apple Human Interface Guidelines for content display components. Use this skill when the user asks about charts component, collection view, image view, web view, color well, image well, activity view, lockup, data visualization, content display, displaying images, rendering web content, color pickers, or presenting collections of items in Apple apps. Also use when the user says how should I display charts, what's the best way to show images, should I use a web view, how do I build a grid of items, what component shows media, or how do I present a share sheet. Cross-references: hig-foundations for color/typography/accessibility, hig-patterns for data visualization patterns, hig-components-layout for structural containers, hig-platforms for platform-specific component behavior.
tools
Automate HelpDesk tasks via Rube MCP (Composio): list tickets, manage views, use canned responses, and configure custom fields. Always search tools first for current schemas.
testing
Expert Haskell engineer specializing in advanced type systems, pure functional design, and high-reliability software. Use PROACTIVELY for type-level programming, concurrency, and architecture guidance.
tools
GraphQL gives clients exactly the data they need - no more, no less. One endpoint, typed schema, introspection. But the flexibility that makes it powerful also makes it dangerous. Without proper controls, clients can craft queries that bring down your server. This skill covers schema design, resolvers, DataLoader for N+1 prevention, federation for microservices, and client integration with Apollo/urql. Key insight: GraphQL is a contract. The schema is the API documentation. Design it carefully.