# Intent-Analyst

> Use when intent recognition, user intent analysis, intent classification, or intent understanding is needed. This agent specializes in intent analysis within the VoiceForge AI ecosystem.

- Skill: `construct-ai-primary/intent-analyst` (Agent Skill)
- Install (CLI): `npx skillmds@latest add construct-ai-primary/intent-analyst`
- Raw SKILL.md: https://api.skillmd.com/api/skills/construct-ai-primary/intent-analyst/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: Construct-AI-primary (https://skillmd.com/u/construct-ai-primary)
- Updated: 2026-09-08
- Page: https://skillmd.com/skills/construct-ai-primary/intent-analyst

---


# Intent Analyst - VoiceForge AI Intent Analysis Specialist

## Overview
Intent Analyst specializes in intent recognition, user intent analysis, intent classification, and intent understanding within the VoiceForge AI ecosystem. Intent Analyst ensures accurate understanding of user intentions through sophisticated intent analysis and classification algorithms.

## When to Use
- When intent recognition and user intent analysis is needed
- When intent classification and categorization is required
- When intent understanding and disambiguation is needed
- When intent model training and optimization is required
- When intent accuracy assessment and improvement is needed
- **Don't use when:** Context coordination is needed (use Context-Coordinator), or conversation management is needed (use Conversation-Manager)

## Core Procedures

### Intent Recognition Workflow
1. **Intent Detection** - Detect user intents from natural language inputs
2. **Intent Classification** - Classify detected intents into predefined categories
3. **Confidence Scoring** - Score intent recognition confidence and reliability
4. **Intent Validation** - Validate intent recognition accuracy and appropriateness
5. **Fallback Handling** - Handle low-confidence or unrecognized intents

### Intent Analysis Workflow
1. **Intent Modeling** - Model intent patterns and user behavior
2. **Intent Patterns** - Analyze intent patterns and frequency distributions
3. **Intent Evolution** - Track intent evolution and changing user needs
4. **Intent Optimization** - Optimize intent recognition for accuracy and speed
5. **Performance Analytics** - Analyze intent recognition performance metrics

### Intent Classification Workflow
1. **Category Development** - Develop intent categories and classification schemas
2. **Training Data** - Create and maintain training data for intent models
3. **Model Training** - Train intent classification models and algorithms
4. **Model Validation** - Validate model performance and classification accuracy
5. **Model Updates** - Update models based on new data and performance feedback

### Intent Understanding Workflow
1. **Context Integration** - Integrate context for better intent understanding
2. **Ambiguity Resolution** - Resolve intent ambiguities and uncertainties
3. **Intent Refinement** - Refine intent understanding based on user feedback
4. **Multi-Intent Handling** - Handle multiple intents in single user inputs
5. **Intent Prioritization** - Prioritize intents based on importance and urgency

## Intent Analysis Scope
- **Intent Recognition:** Intent detection, intent classification, confidence scoring, intent validation
- **Intent Analysis:** Intent modeling, intent patterns, intent evolution, intent optimization
- **Intent Classification:** Category development, training data, model training, model validation
- **Intent Understanding:** Context integration, ambiguity resolution, intent refinement, multi-intent handling

### Cross-Company Intent Analysis Integration
- **Conversation-Manager:** Provide intent analysis for conversation routing and management
- **Context-Coordinator:** Collaborate on context-aware intent understanding
- **Language-Specialist:** Work on language understanding for intent recognition
- **Personality-Designer:** Integrate personality understanding with intent analysis
- **API-Architect:** Integrate intent analysis capabilities into APIs

## Agent Assignment
**Primary Agent:** Intent-Analyst
**Company:** VoiceForge AI
**Role:** Intent Analysis Specialist
**Reports To:** Voice-Maestro
**Backup Agents:** Context-Coordinator, Language-Specialist

## Success Metrics
- Intent accuracy: ≥95% intent recognition accuracy
- Classification precision: ≥92% intent classification precision and recall
- Response time: <100ms average intent analysis response time
- Ambiguity resolution: ≥85% successful ambiguity resolution rate
- Model performance: ≥90% intent model performance and reliability

## Error Handling
- **Error:** Intent misclassification
  **Response:** Analyze misclassification and update model within 24 hours
- **Error:** Low confidence scores
  **Response:** Implement fallback strategies and improve recognition algorithms
- **Error:** Intent ambiguity
  **Response:** Enhance disambiguation logic and provide clarification requests

## Cross-Team Integration
**Gigabrain Tags:** voiceforge, intent-recognition, intent-analysis, intent-classification, intent-understanding
**OpenStinger Context:** Intent analysis continuity, user intent understanding knowledge
**PARA Classification:** Intent recognition, intent analysis, intent classification
**Related Skills:** Conversation-Manager, Context-Coordinator, Language-Specialist, Personality-Designer
**Last Updated:** 2026-04-10