`DW-Agents/dw-agents/agent-skills-manager/README.md`

162 lines
# Skills Manager Agent

## Purpose
Centralized management of AI capabilities and skills available to all agents, tracking skill usage, performance, and providing a registry of available Claude AI skills.

## Core Responsibilities
- Maintain registry of all available AI skills
- Track skill usage across agents
- Monitor skill performance and success rates
- Provide skill discovery and documentation
- Manage skill versions and updates
- Recommend skills for specific tasks
- Generate skill usage analytics

## Technical Details
- **Port**: 9894
- **Main File**: skills-manager-agent.ts
- **Data Store**: skills-records.json
- **Integration**: Claude AI skills ecosystem

## Key Features
- **Skills Registry**:
  - Complete catalog of available skills
  - Skill descriptions and capabilities
  - Usage instructions and examples
  - Version tracking
  - Compatibility information

- **Skill Categories**:
  - **Documents**: docx, pdf-anthropic, pdf-processing-pro
  - **Spreadsheets**: xlsx, excel-analysis
  - **Presentations**: pptx
  - **Communication**: email-composer, internal-comms
  - **Design**: canvas-design, theme-factory
  - **Development**: mcp-builder, skill-creator
  - **Testing**: webapp-testing
  - **Reporting**: dw-eod-report-generator

- **Usage Tracking**:
  - Skill invocation counts
  - Success/failure rates
  - Performance metrics
  - Agent-specific usage patterns
  - Time-based usage analytics

- **Performance Monitoring**:
  - Execution time tracking
  - Error rate monitoring
  - Output quality assessment
  - Resource consumption

- **AI Skill Assistant**:
  - Claude AI integration for skill recommendations
  - Task-to-skill mapping
  - Skill combination suggestions
  - Best practice guidance

## Available Skills (Examples)
1. **docx**: Document creation and editing
2. **pptx**: Presentation development
3. **xlsx**: Spreadsheet analysis
4. **excel-analysis**: Advanced data analysis
5. **email-composer**: Professional email drafting
6. **canvas-design**: Visual design creation
7. **theme-factory**: Artifact theming
8. **internal-comms**: Company communications
9. **mcp-builder**: MCP server development
10. **webapp-testing**: Web application testing
11. **skill-creator**: Create new skills
12. **git-commit-helper**: Git commit messages

## Data Structure (skills-records.json)
```json
{
  "skills": [
    {
      "name": "skill-name",
      "description": "Skill description",
      "category": "category",
      "usageCount": 0,
      "successRate": 100,
      "lastUsed": "timestamp",
      "averageExecutionTime": 0,
      "agents": ["agent1", "agent2"]
    }
  ]
}
```

## Integration Points
- **All Agents**: Skill usage tracking
- **CEO Dashboard**: Executive skill access
- **Task Orchestrator**: Task-to-skill routing
- **Claude AI**: Skill execution
- **Agents Viewer (9111)**: Skill display

## Analytics Provided
- **Usage Analytics**:
  - Most used skills
  - Usage trends over time
  - Agent-specific usage patterns
  - Peak usage times

- **Performance Analytics**:
  - Success rates by skill
  - Average execution times
  - Error patterns
  - Resource consumption

- **Recommendation Engine**:
  - Suggest skills for tasks
  - Identify underutilized skills
  - Recommend skill combinations
  - Optimize skill selection

## Use Cases
- "What skills are available for document creation?"
- "Show usage statistics for excel-analysis skill"
- "Which skills does the marketing agent use most?"
- "Recommend skills for creating a business report"
- "Track performance of email-composer skill"
- "List all presentation-related skills"

## Skill Management Workflows
1. **Skill Registration**: Add new skills to registry
2. **Usage Tracking**: Record each skill invocation
3. **Performance Monitoring**: Track execution metrics
4. **Analytics Generation**: Create usage reports
5. **Recommendation**: Suggest skills for tasks
6. **Optimization**: Identify improvement opportunities

## Reports Available
- Skill usage summary reports
- Performance analytics dashboards
- Agent-specific skill usage
- Trend analysis reports
- Skill effectiveness reports
- Recommendation reports

## API Endpoints (if applicable)
- `GET /skills` - List all available skills
- `GET /skills/:name` - Get skill details
- `POST /skills/track` - Record skill usage
- `GET /skills/stats` - Get usage statistics
- `GET /skills/recommendations` - Get skill recommendations

## Executive Access
CEO and executive dashboards have direct access to skills manager for:
- Strategic skill deployment
- Resource planning
- Capability assessment
- Training and development

## Authentication
Uses shared-auth.ts SSO system

## Security
- Read access for all agents
- Write access restricted to admin
- Usage data privacy
- Audit trail of skill usage