| name | amaa-api-research-ops |
| description | Use when needing API research scenarios or collaboration patterns. Trigger with API research ops request. Loaded by ai-maestro-architect-agent-main-agent |
| context | fork |
| user-invocable | false |
| agent | ai-maestro-architect-agent-main-agent |
API Researcher Skill (Operations)
Overview
Scenarios for researching REST, GraphQL, Python, and cloud APIs. Includes collaboration patterns with orchestrator and other agents, plus quick reference for workflows and communication formats.
Prerequisites
- Completion of core API research skill setup
Instructions
- Select the appropriate research scenario for the API type
- Follow the step-by-step approach for that scenario
- Use collaboration patterns for orchestrator communication
- Consult quick reference for output files and formats
Checklist
Copy this checklist and track your progress:
Reference Documents
| Document | Content |
|---|
| research-scenarios.md | Scenario 1: Research REST API, Scenario 2: Research Python Library, Scenario 3: Research Cloud Service API, Scenario 4: Research GraphQL API, Types, Queries, Mutations |
| collaboration-patterns.md | Integration with Orchestrator, Handling Blockers, Handoff Protocol, Collaboration with Other Agents, Best Practices |
| quick-reference.md | Research Output Files, Research Workflow, Communication Formats, Extended Examples |
Examples
Example: Research REST API - WebSearch for docs, WebFetch API reference, document endpoints, identify auth method, check rate limits, create integration guide
Error Handling
| Issue | Fix |
|---|
| Scenario mismatch | Re-evaluate API type and switch scenario |
| Orchestrator unresponsive | Use [BLOCKED] format and wait |
Output
| Type | Description |
|---|
| Scenario-guided research | Structured research following API-type-specific steps |
| Status reports | Formatted communication using standard patterns |
Resources
See Reference Documents table above.
