Smithy SDK Generator
Developmentsmithy-sdk-generatorSmithy SDK Generator is an Agent Skill for development published in the a5c-ai/babysitter repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.
AWS Smithy-based SDK generation for enterprise-grade APIs
QUICK START
How to use this skill
Bring this guide into your coding agent with a prompt tailored to the tool you use.
- Open your project in Codex.
- Copy and paste the prompt below.
- Review files and risks before approving any action.
Prompt to paste
Inspect the Agent Skill at https://github.com/a5c-ai/babysitter/blob/HEAD/library/specializations/sdk-platform-development/skills/smithy-sdk-generator/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/smithy-sdk-generator, but wait for my approval before writing files or running scripts.
Copying this prompt does not install or run the skill. Review third-party files before use.
Smithy SDK Generator Skill
Overview
This skill leverages AWS Smithy to generate enterprise-grade SDKs with AWS-style patterns including waiters, paginators, and automatic retries. Smithy provides a protocol-agnostic approach to API modeling.
Capabilities
- Design Smithy models with traits for rich API semantics
- Generate SDKs with AWS-style patterns (waiters, paginators, retries)
- Implement custom code generation plugins
- Support multiple protocols (REST, RPC, etc.)
- Configure middleware and interceptor chains
- Generate comprehensive API documentation
- Implement client-side validation from constraints
Target Processes
- SDK Code Generation Pipeline
- SDK Architecture Design
- Multi-Language SDK Strategy
Integration Points
- AWS Smithy core and build plugins
- smithy-typescript for TypeScript SDK generation
- smithy-go for Go SDK generation
- smithy-rs for Rust SDK generation
- Custom code generators
Input Requirements
- Smithy model files (.smithy)
- Trait configurations for behaviors
- Target language specifications
- Custom template overrides (if any)
- Protocol selection (restJson1, awsJson1_1, etc.)
Output Artifacts
- Generated SDK source code
- API documentation
- Waiter configurations
- Paginator implementations
- Client configuration options
- Build artifacts per target language
Usage Example
skill:
name: smithy-sdk-generator
context:
modelDirectory: ./model
targetLanguages:
- typescript
- python
- go
protocol: restJson1
generateWaiters: true
generatePaginators: true
customTraits: ./traits
Best Practices
- Use semantic traits to enrich API behavior
- Define clear resource hierarchies
- Implement proper pagination patterns
- Add waiter definitions for async operations
- Use validation constraints for input validation
- Document all operations and shapes thoroughly