How do I install the Deploy skill?

Run npx skillmds@latest add forever-efficient/deploy in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Deploy safe to use?

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Deploy?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Deploy free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Deploy?

forever-efficient (@forever-efficient) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Deploy by forever-efficient — Agent Skill

Name: Deploy
Author: forever-efficient

Deploy

Deploy the Pitfal Solutions website to AWS. Use when user says deploy, push to production, or update live site. Runs pre-checks, builds Next.js, deploys Terraform infrastructure, syncs to S3, and invalidates CloudFront cache.

File contents

Deploy to AWS

Deploy the Pitfal Solutions website following this sequence:

Pre-deployment Checks

Verify all tests pass: pnpm test
Verify TypeScript compiles: pnpm type-check
Check for uncommitted changes: git status

Build Process

Build the Next.js application: pnpm build
Verify the out/ directory was created

Infrastructure Deployment

Navigate to terraform: cd infrastructure/terraform
Initialize if needed: terraform init
Plan changes: terraform plan -out=tfplan
Show plan summary to user and confirm before applying
Apply changes: terraform apply tfplan

Static Site Deployment

Sync static assets to S3:

aws s3 sync out/ s3://pitfal-static-site \
  --delete \
  --cache-control "public, max-age=31536000, immutable" \
  --exclude "*.html" \
  --profile pitfal

Sync HTML with no-cache:

aws s3 sync out/ s3://pitfal-static-site \
  --cache-control "public, max-age=0, must-revalidate" \
  --include "*.html" \
  --profile pitfal

Post-deployment

Get CloudFront Distribution ID (if not already known):

# Option 1: From Terraform output
cd infrastructure/terraform && terraform output cloudfront_distribution_id

# Option 2: From AWS CLI (finds distribution for pitfal.solutions)
aws cloudfront list-distributions --profile pitfal \
  --query "DistributionList.Items[?contains(Aliases.Items, 'pitfal.solutions')].Id" \
  --output text

# Option 3: Export as environment variable for reuse
export DISTRIBUTION_ID=$(terraform -chdir=infrastructure/terraform output -raw cloudfront_distribution_id)

Invalidate CloudFront cache:

aws cloudfront create-invalidation \
  --distribution-id $DISTRIBUTION_ID \
  --paths "/*" \
  --profile pitfal \
  --no-cli-pager

Note: Cache invalidation takes 1-5 minutes to propagate globally.

Verify site is accessible at https://pitfal.solutions
Run smoke tests if available

Rollback

If deployment fails:

Check Terraform state: terraform state list
Restore previous S3 version if needed
Provide specific rollback instructions based on failure point

---name: deploydescription: Deploy the Pitfal Solutions website to AWS. Use when user says deploy, push to production, or update live site. Runs pre-checks, builds Next.js, deploys Terraform infrastructure, syncs to S3, and invalidates CloudFront cache.---# Deploy to AWSDeploy the Pitfal Solutions website following this sequence:## Pre-deployment Checks1. Verify all tests pass: `pnpm test`2. Verify TypeScript compiles: `pnpm type-check`3. Check for uncommitted changes: `git status`## Build Process1. Build the Next.js application: `pnpm build`2. Verify the `out/` directory was created## Infrastructure Deployment1. Navigate to terraform: `cd infrastructure/terraform`2. Initialize if needed: `terraform init`3. Plan changes: `terraform plan -out=tfplan`4. Show plan summary to user and confirm before applying5. Apply changes: `terraform apply tfplan`## Static Site Deployment1. Sync static assets to S3: ```bash aws s3 sync out/ s3://pitfal-static-site \ --delete \ --cache-control "public, max-age=31536000, immutable" \ --exclude "*.html" \ --profile pitfal ```2. Sync HTML with no-cache: ```bash aws s3 sync out/ s3://pitfal-static-site \ --cache-control "public, max-age=0, must-revalidate" \ --include "*.html" \ --profile pitfal ```## Post-deployment1. Get CloudFront Distribution ID (if not already known): ```bash # Option 1: From Terraform output cd infrastructure/terraform && terraform output cloudfront_distribution_id # Option 2: From AWS CLI (finds distribution for pitfal.solutions) aws cloudfront list-distributions --profile pitfal \ --query "DistributionList.Items[?contains(Aliases.Items, 'pitfal.solutions')].Id" \ --output text # Option 3: Export as environment variable for reuse export DISTRIBUTION_ID=$(terraform -chdir=infrastructure/terraform output -raw cloudfront_distribution_id) ```2. Invalidate CloudFront cache: ```bash aws cloudfront create-invalidation \ --distribution-id $DISTRIBUTION_ID \ --paths "/*" \ --profile pitfal \ --no-cli-pager ``` Note: Cache invalidation takes 1-5 minutes to propagate globally.3. Verify site is accessible at https://pitfal.solutions4. Run smoke tests if available## RollbackIf deployment fails:1. Check Terraform state: `terraform state list`2. Restore previous S3 version if needed3. Provide specific rollback instructions based on failure point

Frequently asked questions