vybekiit 0.7.0 → 0.7.2

package/dist/global-skills/add-ai/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: add-ai
-description: the builder wants smart replies or another AI feature in their app. Use when the builder says something like: add ai; chatbot; smart replies.
+description: "the builder wants smart replies or another AI feature in their app. Use when the builder says something like: add ai; chatbot; smart replies."
 metadata:
   vybekiit-generated: buyer-skill-stub
 ---

package/dist/global-skills/add-analytics/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: add-analytics
-description: the builder can see who uses their app — visitor stats in plain language. Use when the builder says something like: visitor stats; analytics; track usage.
+description: "the builder can see who uses their app — visitor stats in plain language. Use when the builder says something like: visitor stats; analytics; track usage."
 metadata:
   vybekiit-generated: buyer-skill-stub
 ---

package/dist/global-skills/add-blog/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: add-blog
-description: the builder wants a blog or changelog on their site. Use when the builder says something like: add a blog; write articles; changelog.
+description: "the builder wants a blog or changelog on their site. Use when the builder says something like: add a blog; write articles; changelog."
 metadata:
   vybekiit-generated: buyer-skill-stub
 ---

package/dist/global-skills/add-crud/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: add-crud
-description: scaffold create/read/update/delete routes for a resource. Use when the builder says something like: crud; create read update delete.
+description: "scaffold create/read/update/delete routes for a resource. Use when the builder says something like: crud; create read update delete."
 metadata:
   vybekiit-generated: buyer-skill-stub
 ---

package/dist/global-skills/add-files/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: add-files
-description: users can upload files and images, and see them back in the app. Use when the builder says something like: upload; store files; attachments.
+description: "users can upload files and images, and see them back in the app. Use when the builder says something like: upload; store files; attachments."
 metadata:
   vybekiit-generated: buyer-skill-stub
 ---

package/dist/global-skills/add-images/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: add-images
-description: add logos, hero images, icons, and other pictures that ship with the app (not user uploads). Use when the builder says something like: add my logo; hero image; app icon; add images.
+description: "add logos, hero images, icons, and other pictures that ship with the app (not user uploads). Use when the builder says something like: add my logo; hero image; app icon; add images."
 metadata:
   vybekiit-generated: buyer-skill-stub
 ---

package/dist/global-skills/add-language/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: add-language
-description: make the app speak another language — the builder asks in plain words ("make it Hebrew",. Use when the builder says something like: translate my app; add spanish; make it hebrew.
+description: "make the app speak another language — the builder asks in plain words (\"make it Hebrew\",. Use when the builder says something like: translate my app; add spanish; make it hebrew."
 metadata:
   vybekiit-generated: buyer-skill-stub
 ---

package/dist/global-skills/add-notifications/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: add-notifications
-description: the builder's users get notified — by email first; push can come later. Use when the builder says something like: notify users; send alerts.
+description: "the builder's users get notified — by email first; push can come later. Use when the builder says something like: notify users; send alerts."
 metadata:
   vybekiit-generated: buyer-skill-stub
 ---

package/dist/global-skills/add-realtime/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: add-realtime
-description: the builder's app can push live updates to signed-in users. Use when the builder says something like: live updates; real-time; push changes instantly; refresh without reload.
+description: "the builder's app can push live updates to signed-in users. Use when the builder says something like: live updates; real-time; push changes instantly; refresh without reload."
 metadata:
   vybekiit-generated: buyer-skill-stub
 ---

package/dist/global-skills/add-route/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: add-route
-description: add a new API endpoint without hand-writing boilerplate. Use when the builder says something like: add an endpoint; add api; new route.
+description: "add a new API endpoint without hand-writing boilerplate. Use when the builder says something like: add an endpoint; add api; new route."
 metadata:
   vybekiit-generated: buyer-skill-stub
 ---

package/dist/global-skills/add-search/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: add-search
-description: users can search the builder's data in plain language. Use when the builder says something like: let users search; find things; search my data.
+description: "users can search the builder's data in plain language. Use when the builder says something like: let users search; find things; search my data."
 metadata:
   vybekiit-generated: buyer-skill-stub
 ---

package/dist/global-skills/add-signin/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: add-signin
-description: people can create accounts and log in to the builder's app. Use when the builder says something like: sign in; log in; create accounts; add users.
+description: "people can create accounts and log in to the builder's app. Use when the builder says something like: sign in; log in; create accounts; add users."
 metadata:
   vybekiit-generated: buyer-skill-stub
 ---

package/dist/global-skills/add-teams/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: add-teams
-description: the builder can invite teammates and work in shared organizations. Use when the builder says something like: invite teammates; add my team; organizations.
+description: "the builder can invite teammates and work in shared organizations. Use when the builder says something like: invite teammates; add my team; organizations."
 metadata:
   vybekiit-generated: buyer-skill-stub
 ---

package/dist/global-skills/add-upload/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: add-upload
-description: let clients upload files safely. Use when the builder says something like: upload; store files; attachments; file upload endpoint.
+description: "let clients upload files safely. Use when the builder says something like: upload; store files; attachments; file upload endpoint."
 metadata:
   vybekiit-generated: buyer-skill-stub
 ---

package/dist/global-skills/aws-serverless/SKILL.md

@@ -2,50 +2,50 @@
 name: aws-serverless
 description: Builds, deploys, manages, debugs, configures, and optimizes serverless applications on AWS using Lambda, API Gateway, Step Functions, EventBridge, and SAM/CDK. Covers cold starts, CORS debugging, event source mappings, troubleshooting, concurrency, SnapStart, Powertools, function URLs, EventBridge Scheduler, Lambda layers, and production readiness. Triggers on mentions of Lambda, API Gateway, Step Functions, SAM templates, CDK serverless stacks, DynamoDB stream triggers, SQS event sources, cold starts, timeouts, 502/504 errors, throttling, concurrency, CORS, Powertools, or any event-driven architecture on AWS, even without the word "serverless." Does not apply to EC2, ECS/Fargate containers, or Amplify hosting.
 version: 1
+metadata:
+  service: [lambda, api-gateway, step-functions, eventbridge, dynamodb, sqs, sns, s3, kinesis]
+  task: [build, deploy, debug, optimize]
+  persona: [developer, devops]
+  workload: [serverless]
 ---
 
 # AWS Serverless
-
-Domain expertise for building serverless applications on AWS: Lambda, API Gateway, Step Functions, EventBridge, event source mappings, concurrency, cold starts, deployment, and troubleshooting.
-
-**Works best with** the [AWS MCP server](https://docs.aws.amazon.com/aws-mcp/) — run CLI commands, query CloudWatch, validate configs directly. All guidance also works with standard AWS CLI access.
-
-## Specialized skills — check these first
-
-These cover capabilities and procedures the general references below do **not**. Several are specialized features or step-by-step tested procedures you would otherwise miss. Route to the matching skill before falling back to the references.
-
-### Advanced Lambda compute (easy to overlook)
-
-| Use this skill | When the workload involves |
-|---|---|
-| **aws-lambda-microvms** | Strong tenant isolation, sandboxed/untrusted code execution (AI agent code sandboxes, REPLs, notebooks, CI runners), long-lived sessions, suspend/resume with preserved state, port-listening servers (gRPC, WebSocket, custom TCP), Firecracker microVMs, snapshot-resumable compute, up to 8-hour lifetimes |
-| **aws-lambda-durable-functions** | Durable execution, checkpoint-and-replay, long-running multi-step workflows written as plain code (TS/Python/Java), automatic state persistence, saga pattern in code, human-in-the-loop callbacks, executions up to 1 year, `context.step`/`context.wait`/`context.invoke`, `withDurableExecution`, `durable-execution-sdk` |
-| **aws-lambda-managed-instances** | Lambda Managed Instances (LMI), capacity providers, EC2-backed Lambda, steady high-volume traffic (50M+ req/mo) wanting Savings Plans / Reserved Instance pricing, `PerExecutionEnvironmentMaxConcurrency`, `CapacityProviderConfig`, multi-concurrent execution environments |
-
-### Step-by-step task procedures (tested CLI SOPs)
-
-| Use this skill | For the task |
-|---|---|
-| **connecting-lambda-to-api-gateway** | Wire an existing Lambda to a new REST/HTTP API: proxy integration, permissions, CORS, throttling, access logging, deployment |
-| **connecting-lambda-to-dynamodb** | Connect Lambda to DynamoDB: IAM execution role, read/write permissions, stream event source mapping |
-| **creating-api-gateway-stage** | Create an API Gateway stage with CloudWatch logging, X-Ray tracing, throttling, WAF association, and authorization |
-| **deploying-custom-domain-rest-api** | Deploy a Regional REST API with custom domain: ACM cert, Lambda backend, request authorizer, base path mapping, Route 53 DNS |
-| **debugging-lambda-timeouts** | Systematically diagnose a timing-out Lambda: config, CloudWatch logs/metrics, VPC, cold starts, memory, downstream calls |
-| **processing-s3-uploads-with-step-functions** | Deploy an event-driven workflow: S3 upload → EventBridge → Step Functions → Lambda (small files) or Fargate (large files), with VPC/ECR/ECS/IAM |
-
-## Routing (general references in this skill)
-
-| User need | Read |
-|-----------|------|
-| Building a new serverless app — pattern selection | [architecture.md](references/architecture.md) |
-| Lambda config, cold starts, SnapStart, memory, VPC, layers, Function URLs | [lambda.md](references/lambda.md) |
-| Concurrency (reserved, provisioned, ESM controls) | [concurrency.md](references/concurrency.md) |
-| Event sources (SQS, DynamoDB Streams, SNS, Kinesis), filtering, batch failures | [event-sources.md](references/event-sources.md) |
-| Step Functions, EventBridge rules/pipes/scheduler | [orchestration.md](references/orchestration.md) |
-| API Gateway quotas, authorizers, WebSocket | [api-gateway.md](references/api-gateway.md) |
-| SAM/CDK resource types and fast iteration | [deployment.md](references/deployment.md) |
-| Production readiness, observability, anti-patterns | [production.md](references/production.md) |
-| Debugging an error (exact string → cause → fix) | [troubleshooting.md](references/troubleshooting.md) |
-| Powertools handler template | [powertools-handler.py](assets/powertools-handler.py) |
-
-**Note:** Reference files contain specific runtime versions, quotas, and feature matrices that change. When precision matters (production, runtime choice, quotas), confirm against current AWS documentation. The references focus on values and gotchas that are easy to get wrong — not on basics.
+## Overview
+
+Domain expertise for building serverless applications on AWS. Covers Lambda configuration, API Gateway debugging, Step Functions orchestration, EventBridge patterns, event source mappings, concurrency tuning, cold start optimization, deployment with SAM/CDK, production readiness, and troubleshooting across all serverless services.
+
+**Works best with** the [AWS MCP server](https://docs.aws.amazon.com/aws-mcp/) — enables running CLI commands, querying CloudWatch, and validating configurations directly. All guidance also works with standard AWS CLI access.
+
+**Note:** Reference files contain specific runtime versions, quota values, and feature matrices that may change. When precision matters (e.g., deploying to production, choosing a runtime, or checking a quota), confirm values against current AWS documentation rather than relying solely on the values in these files.
+
+## Routing
+
+| User need | Action |
+|-----------|--------|
+| Building a new serverless app | Read [architecture.md](references/architecture.md) for pattern selection, then [deployment.md](references/deployment.md) for SAM/CDK templates |
+| Debugging an error | Read [troubleshooting.md](references/troubleshooting.md) — starts with the 5 most common fixes |
+| Optimizing performance or cost | Read [lambda.md](references/lambda.md) for cold starts and memory tuning, [production.md](references/production.md) for readiness checklist |
+| Configuring event sources (SQS, DDB Streams, SNS) | Read [event-sources.md](references/event-sources.md) |
+| Step Functions, EventBridge, or orchestration | Read [orchestration.md](references/orchestration.md) |
+| Concurrency configuration | Read [concurrency.md](references/concurrency.md) |
+| API Gateway setup | Read [api-gateway.md](references/api-gateway.md) |
+| Common anti-patterns | Read the anti-patterns section in [production.md](references/production.md) |
+| Starting with Powertools | Use [powertools-handler.py](assets/powertools-handler.py) as a template |
+| Lambda Managed Instances, LMI, capacity providers, EC2-backed Lambda, PerExecutionEnvironmentMaxConcurrency | Use the **aws-lambda-managed-instances** skill instead |
+| Durable functions, durable execution, checkpoint-and-replay | Use the **aws-lambda-durable-functions** skill instead |
+| Firecracker microVMs, strong tenant isolation, sandboxed/untrusted code execution, long-lived sessions, suspend/resume, port-listening servers, snapshot-resumable compute | Use the **aws-lambda-microvms** skill instead |
+| Spans multiple areas | Read the most specific reference first, then consult others as needed |
+
+## Files
+
+| File | Content |
+|------|---------|
+| [lambda.md](references/lambda.md) | Runtime, memory/CPU, cold starts, SnapStart, layers, containers |
+| [api-gateway.md](references/api-gateway.md) | REST vs HTTP API, stages, auth, throttling, mapping |
+| [event-sources.md](references/event-sources.md) | SQS, DDB Streams, SNS, S3, Kinesis triggers |
+| [orchestration.md](references/orchestration.md) | Step Functions, EventBridge rules/pipes/scheduler |
+| [concurrency.md](references/concurrency.md) | Reserved vs provisioned, scaling, ESM concurrency |
+| [architecture.md](references/architecture.md) | Patterns, reference architectures, service selection |
+| [deployment.md](references/deployment.md) | SAM/CDK resource types, globals, fast iteration |
+| [production.md](references/production.md) | Readiness checklist, observability, anti-patterns |
+| [troubleshooting.md](references/troubleshooting.md) | Error → cause → fix for all serverless services |

package/dist/global-skills/aws-serverless/assets/powertools-handler.py

@@ -13,8 +13,7 @@ from aws_lambda_powertools.utilities.typing import LambdaContext
 
 logger = Logger()
 tracer = Tracer()
-# Namespace is required (or set POWERTOOLS_METRICS_NAMESPACE); flushing without one raises SchemaValidationError.
-metrics = Metrics(namespace="MyApp")
+metrics = Metrics()
 persistence = DynamoDBPersistenceLayer(table_name="IdempotencyTable")
 
 # Idempotency key: "body" deduplicates identical payloads.