skills.rest
aws-samples
aws-samplesOFFICIAL
Explore all skills by this author →
WebsiteGitHub

research-api-surface

Identify and validate AWS service API surfaces against SAR condition keys.

43|13|Updated Feb 6, 2026
Search Tags:#API#research#validation#AWS#service approval
One-click install
npx skills add https://github.com/aws-samples/sample-agentic-value-accelerator --skill research-api-surface
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: research-api-surface
Source: https://github.com/aws-samples/sample-agentic-value-accelerator/tree/main/platform/control_plane/service_approval/plugin/.claude-plugin/skills/research-api-surface
Command: npx skills add https://github.com/aws-samples/sample-agentic-value-accelerator --skill research-api-surface

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires aws-documentation, awsknowledge, and includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill discovers the full API surface for an AWS service, including all operations, parameters, and cross-validation against SAR condition keys, simplifying research and integration processes.

Core Features & Use Cases

  • API Surface Discovery: Comprehensive research of both control-plane and data-plane operations for any AWS service.
  • Cross-Reference Validation: Ensures that API operations align with SAR condition keys for accuracy.
  • Output JSON: Delivers a JSON file that is consumed by the research merge step for further analysis.

Quick Start

Run the research-api-surface skill with the --service=<name> flag to retrieve the API surface for the specified AWS service.

Frequently Asked Questions about research-api-surface

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I discover the complete API surface of an AWS service?▼

You can discover the complete AWS service API surface by running this skill with the `--service=<name>` flag. It identifies all control-plane and data-plane operations, retrieving comprehensive parameters via botocore.

How do I validate AWS API operations against Service Authorization Reference condition keys?▼

Validating AWS API operations against Service Authorization Reference (SAR) condition keys requires cross-referencing the discovered API surface with SAR data. This skill automates that cross-reference validation to ensure operations align accurately.

Can I use botocore to research AWS service control-plane and data-plane operations?▼

Yes, you can use botocore to research AWS service operations. This skill utilizes botocore and aws-documentation MCP calls to comprehensively collect data on both control-plane and data-plane operations for research workflows.

Does this API surface research output a format for downstream service approval workflows?▼

Yes, the API surface research outputs a JSON file containing the discovered operations and validation results. This JSON file is specifically designed to be consumed by the research merge step for further service approval analysis.

What is the best way to retrieve all AWS service operations and parameters for research?▼

The best way to retrieve all AWS service operations and parameters is using an automated skill that cross-references botocore with aws-documentation. This ensures comprehensive data collection and SAR condition key validation in one pass.

Why do I need to cross-reference AWS API operations with SAR condition keys?▼

Cross-referencing AWS API operations with SAR condition keys is needed to ensure accuracy in service approval and integration processes. It validates that the discovered API surface aligns with authorization reference data.

Related Skills

Explore More Software Engineering Skills→
hongmaple0820hongmaple0820
9

aws-mcp-setup

Configure AWS MCP servers for API calls and documentation lookups.

Community
Intermediate
brikkoAIbrikkoAI
1

goplaces

Provides cryptocurrrency price and volume data for selected coins.

Official
Intermediate
framerslabframerslab

company-research

Enrich company and contact data using the Clearbit API.

Official
Intermediate
aws-samplesaws-samples
3

ops-resilience

Apply time-limited retries and fallbacks for AWS control plane failures.

Official
Advanced