SECURITY REVIEW
Not yet assessed
Review the original instructions and requested permissions before installing.
No security review is available for this catalog entry yet.
Aws · Backend / AGENT SKILL
new-aws-service
0
Scaffold an AWS service wrapper using the established CloudFormation service pattern.
Scaffold a new AWS service wrapper in pkg/aws/<servicename>/ following the established cloudformationservice pattern
Understand the trade-offs.
SKILL QUALITY
Not yet assessed
How clearly the skill guides your agent, how complete its workflow is, and how you can check the outcome.
No quality assessment is available for this catalog entry yet.
The full skill.
Original instructions from the publisher’s SKILL.md
When the user asks to add a new AWS service wrapper (or invokes `/new-aws-service <servicename>`), create the full package at `pkg/aws/<servicename>/` following the `pkg/aws/cloudformationservice/` pattern.
## Steps
1. **Determine the service name** from `$ARGUMENTS` or ask the user.
2. **Read the canonical example** to understand the pattern:
- `pkg/aws/cloudformationservice/service.go` — interface + implementation
- `pkg/aws/cloudformationservice/mock_client_test.go` — mock of the AWS client interface
- `pkg/aws/cloudformationservice/service_test.go` — unit tests using mocks
- `pkg/aws/cloudformationservice/service_integration_test.go` — LocalStack integration tests
3. **Create `pkg/aws/<servicename>/service.go`**:
- Define an interface for the AWS SDK client methods you need (keeps the dependency mockable)
- Define a `<ServiceName>Service` struct that wraps the client
- Implement the public methods the rest of the app will call
- Return structured errors using `fmt.Errorf("context: %w", err)` wrapping
4. **Create `pkg/aws/<servicename>/mock_client_test.go`**:
- Hand-write a mock struct that implements the client interface
- Include configurable return values for each method
5. **Create `pkg/aws/<servicename>/service_test.go`**:
- Use the mock client to test each method in isolation
- Cover happy path and key error cases
6. **Create `pkg/aws/<servicename>/service_integration_test.go`**:
- Gate with `//go:build integration`
- Use `testhelpers.StartLocalStack()` to spin up a container
- Test the critical end-to-end path against real LocalStack
7. **Wire it up** in `internal/dependencies/dependencies.go` alongside existing clients.
8. After scaffolding, run `go test ./pkg/aws/<servicename>/...` to confirm unit tests pass, and remind the user to run integration tests with `-tags integration` once Docker is available.