masharratt Agent Discovery Skill
Purpose
Automatically discover and catalog available agents in the Claude Flow Novice system by scanning the .claude/agents/ directory and extracting metadata from agent definition files.
Key Features
- Scan
.claude/agents/*.mdfiles - Extract metadata: name, description, type, keywords/tags
- Generate structured JSON registry
- Categorize agents by loop (Loop 3 or Loop 2)
Agent Categorization
- Loop 3 (Implementers):
- Types: coder, developer, backend-dev, react-frontend-engineer, architect, researcher, designer, writer, analyst
- Loop 2 (Validators):
- Types: reviewer, tester, security-auditor, performance-analyzer, validator
- Coordinators: Separate category, not included in agent selection
Usage
./.claude/skills/agent-discovery/discover-agents.sh
Output
Generates .claude/skills/agent-discovery/agents-registry.json with comprehensive agent metadata.
Error Handling
- Robust parsing of agent files
- Handles missing or malformed frontmatter
- Generates sensible defaults for missing metadata
Performance
- Optimized for quick scanning of agent files
- Minimal computational overhead
- Periodic refresh recommended
Best Practices
- Keep agent definition files well-structured
- Include comprehensive frontmatter
- Use consistent metadata across agent definitions