vm-agent-skill-analyzer

# VM Agent Skill Analyzer

## When To Use This Skill

- Planning new agent or skill development (called by 0 - Meta - AI Agent Builder in Phase 2)
- Evaluating if a capability already exists in the workspace
- Checking if an existing skill can be adapted to cover a new request
- Mapping the agent/skill portfolio for composition opportunities

**Do NOT use this skill when:**
- Creating or modifying agents/skills (that is the agent builder's job)
- Validating an agent against standards (use Section 17 checklist from AGENT_DEVELOPMENT_STANDARDS.md)
- Building architectural diagrams (use Documentation Generation Agent)

## Unitary Function

**ONE RESPONSIBILITY:** Scan the workspace for agents and skills, score them against a capability request, and recommend an action.

**NOT RESPONSIBLE FOR:**
- Creating or modifying agents or skills
- Validating agents against standards (reports gaps only)
- Building specifications
- Selecting tools or models for new agents

## Input

```json
{
  "capability_request": "Natural language description of desired capability",
  "analysis_depth": "quick | standard | comprehensive"
}
```

| Parameter | Type | Required | Description |
|---|---|---|---|
| capability_request | string | MUST | What capability is needed, in plain language |
| analysis_depth | string | SHOULD | quick (names/descriptions only), standard (reads SKILL.md/agent files), comprehensive (full dependency mapping). Default: standard |

## Output

```json
{
  "generated_by": {
    "skill": "vm-agent-skill-analyzer",
    "version": "2.0.0"
  },
  "capability_requested": "string",
  "analysis_depth": "quick | standard | comprehensive",
  "repository_inventory": {
    "total_agents": 0,
    "total_skills": 0,
    "agents": [
      {
        "name": "Agent Name",
        "path": ".github/agents/file.agent.md",
        "version": "X.Y.Z",
        "risk_classification": "Read-Only | Write | Destructive"
      }
    ],
    "skills": [
      {
        "name": "vm-skill-name",
        "path": ".github/skills/category/skill-id/SKILL.md",
        "version": "X.Y.Z",
        "category": "category-name",
        "responsibility": "ONE RESPONSIBILITY statement"
      }
    ]
  },
  "matches": [
    {
      "name": "capability name",
      "path": "file path",
      "type": "agent | skill",
      "match_score": 85,
      "match_reason": "Why this matches the request",
      "gap": "What is missing, if anything",
      "can_reuse": true,
      "requires_adaptation": false,
      "adaptation_suggestions": []
    }
  ],
  "composition_option": {
    "feasible": false,
    "components": [],
    "orchestration_needed": "Description of how components connect",
    "rationale": "Why composition works or does not"
  },
  "recommendation": {
    "action": "REUSE | ADAPT | COMPOSE | CREATE",
    "rationale": "Evidence-based explanation",
    "evidence": ["file paths and specific features that support the recommendation"]
  }
}
```

## Implementation Logic

### Analysis Levels