[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M7A2XSWPHKEMWBEEDPSDV80W":3,"skill-same:01M7A2XSWPHKEMWBEEDPSDV80W":142},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":18,"publishedAt":19,"linkOnly":20,"markdownContent":21,"markdownBody":22,"frontMatter":23,"refName":42,"commitSha":43,"skillDirectory":44,"forksCount":45,"repositoryHtmlUrl":46,"repositoryHomepageUrl":6,"ownerHtmlUrl":47,"ownerBlogUrl":6,"ownerDescription":48,"updatedAt":49,"install":50,"resources":63},"01M7A2XSWPHKEMWBEEDPSDV80W","acm-private-ca-deployer",null,"Provisions AWS Private Certificate Authority (ACM PCA) with production defaults: CA creation (root vs subordinate), key algorithm (RSA_2048, EC_prime256v1), signing algorithm (SHA256withRSA, SHA256withECDSA), CRL configuration (S3 bucket, expiration, CNAME), certificate template selection, CA certificate issuance (self-signed root vs parent-signed subordinate), certificate revocation, audit via CloudTrail, CA deletion (7-30 day mandatory waiting period), CA permissions for ACM integration, and OCSP support. Emits a READY_TO_DEPLOY checklist with verification commands. Use when creating a private CA, issuing private certificates, configuring CRL revocation, setting up subordinate CA hierarchies, integrating ACM PCA with ACM, or deleting a private CA. Triggers: create private certificate authority, acm pca root ca, acm pca subordinate ca, issue private certificate, crl configuration s3, revoke certificate acm pca, ca deletion waiting period, acm pca permissions, acm managed private cert.","jhkchan\u002Faws-agent-skills","jhkchan","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F1083902?v=4","01M7A2SVQYP9GQTPTDXP5JKYQ4","Jacky Chan","01M7A2SVS117YWCTZABB75HZR1",4,"Apache-2.0","https:\u002F\u002Fgithub.com\u002Fjhkchan\u002Faws-agent-skills\u002Fblob\u002Fmain\u002Fskills\u002Facm-private-ca-deployer\u002FSKILL.md",[],[],"2026-11-15 14:19:17",false,"---\nname: acm-private-ca-deployer\ndescription: 'Provisions AWS Private Certificate Authority (ACM PCA) with production defaults: CA creation (root vs subordinate), key algorithm (RSA_2048, EC_prime256v1), signing algorithm (SHA256withRSA, SHA256withECDSA), CRL configuration (S3 bucket, expiration, CNAME), certificate template selection, CA certificate issuance (self-signed root vs parent-signed subordinate), certificate revocation, audit via CloudTrail, CA deletion (7-30 day mandatory waiting period), CA permissions for ACM integration, and OCSP support. Emits a READY_TO_DEPLOY checklist with verification commands. Use when creating a private CA, issuing private certificates, configuring CRL revocation, setting up subordinate CA hierarchies, integrating ACM PCA with ACM, or deleting a private CA. Triggers: create private certificate authority, acm pca root ca, acm pca subordinate ca, issue private certificate, crl configuration s3, revoke certificate acm pca, ca deletion waiting period, acm pca permissions, acm managed private cert.'\nlicense: Apache-2.0\ncompatibility: 'Agent runtime that reads SKILL.md (Claude Code, Cursor, Windsurf, Codex, Gemini). For live deployment: AWS CLI v2 with acm-pca and acm access. Works with Terraform aws_acmpca_certificate_authority \u002F aws_acmpca_certificate \u002F aws_acmpca_certificate_authority_certificate resources and CloudFormation AWS::ACMPCA::CertificateAuthority \u002F AWS::ACMPCA::Certificate templates.'\nmetadata:\n  domain: aws-cloudops\n  complexity: high\n  requires_llm: 'true'\n  phase: '1'\n  supports_pipeline: 'true'\n  entry_point: 'false'\n  family: Security\n  task_type: deploy\n  skill_class: capability\n  lifecycle_status: active\n  verdict_shape: READY_TO_DEPLOY | PREREQUISITES_MISSING\n  version: 0.1.0\n  author: Jacky Chan — AWS Community Builder\n  tags: aws, acm-pca, private-ca, cloudops, deploy, security, provisioning, pki, certificates, crl, revocation\n  dependencies: aws-orchestrator\n  keywords: aws, acm, acm pca, private certificate authority, private ca, cloudops, deploy, provisioning, root ca, subordinate ca, certificate, crl, ocsp, revocation, pki\n  when_to_use: Invoke when the user wants to create a private certificate authority (root or subordinate), issue private certificates, configure CRL revocation, set up a subordinate CA hierarchy, integrate ACM PCA with ACM for managed certificate lifecycle, delete a private CA, or revoke certificates. Do NOT invoke for public TLS certificates (use ACM public certificate skills), AWS Certificate Manager public issuance, or AWS Secrets Manager certificate storage.\n---\n\n# ACM Private CA Deployer\n\nAn AWS CloudOps agent skill that provisions AWS Private Certificate\nAuthority (ACM PCA) with correct defaults. The skill walks the operator\nthrough root vs subordinate CA creation, key and signing algorithm\nselection, CRL configuration, certificate issuance, CA permissions for\nACM integration, certificate revocation, and the mandatory CA deletion\nwaiting period. It captures hierarchy decisions, explains why each\ndefault matters, and emits a READY_TO_DEPLOY checklist with copy-\npasteable verification commands.\n\n## Activation keywords\n\ncreate private certificate authority, ACM PCA root CA, ACM PCA\nsubordinate CA, issue private certificate, CRL configuration S3, revoke\ncertificate ACM PCA, CA deletion waiting period, ACM PCA permissions,\nACM managed private cert.\n\n## STRICT output contract\n\nWhen this skill is invoked with an ACM PCA provisioning request (create\na private CA, issue a certificate, configure CRL, set up a subordinate\nhierarchy, delete a CA, or a partial configuration), the agent MUST\nrespond with the READY_TO_DEPLOY checklist defined in the \"Output\nformat\" section using the literal all-caps labels `ACM_PCA:`,\n`VERDICT:`, `CHECKLIST:`, and `VERIFICATION_COMMANDS:`. Do NOT preface\nthe checklist with prose, headings, or disclaimers — emit the block as\nthe first lines of the response. This contract is what assertion-based\nevals and downstream provisioning pipelines rely on; deviating from\nthe literal labels breaks automation silently.\n\nIf any prerequisite is missing, the verdict is `PREREQUISITES_MISSING`\nwith a specific gap citation in the checklist (marked `[✗]`), and\n`READY_TO_DEPLOY` MUST NOT also appear.\n\n## Quick navigation\n\n| Section | When to read |\n|---|---|\n| Prerequisites | Always — verify before provisioning |\n| Step 1 — CA type: root vs subordinate | Core CA model |\n| Step 2 — Key and signing algorithm selection | Cryptographic choice |\n| Step 3 — CRL configuration (S3 bucket) | Revocation infrastructure |\n| Step 4 — Create the CA and issue CA certificate | Provisioning step |\n| Step 5 — Certificate templates and end-entity issuance | Certificate issuance |\n| Step 6 — CA permissions for ACM integration | Cross-account \u002F ACM managed certs |\n| Step 7 — Certificate revocation and OCSP | Revocation lifecycle |\n| Step 8 — CA deletion (mandatory waiting period) | Decommissioning |\n| Step 9 — Audit via CloudTrail | Compliance |\n| Step 10 — Recent features | Latest |\n| NEVER do these things | Review before signing off |\n| Output format | The literal checklist template |\n| references\u002Fca-hierarchy-and-signing.md | Root\u002Fsubordinate detail |\n| references\u002Fcrl-and-revocation.md | CRL + revocation detail |\n| references\u002Fadvanced-patterns.md | Expert-heuristic deep dives + recent features |\n| references\u002Ferror-handling.md | Error remedies |\n\n## Mindset\n\n**One-line takeaway:** ACM PCA provides managed private CAs. A root CA\nis self-signed; a subordinate CA is signed by its parent CA and MUST\nhave the parent's permission to issue. CRL revocation requires an S3\nbucket with a policy granting the ACM PCA service principal write\naccess. CA deletion is NOT immediate — it enters a mandatory 7-30 day\nwaiting period before permanent deletion.\n\nThree misconceptions dominate ACM PCA misdesign at provisioning time:\n\n- **\"Creating the CA is enough to issue certificates.\"** It is not. A\n  newly created CA is in `PENDING_CERTIFICATE` status. For a root CA,\n  you must issue and import a self-signed certificate. For a\n  subordinate CA, you must request a certificate from the parent CA,\n  then import it. Until the CA is `ACTIVE`, no certificates can be\n  issued from it.\n\n- **\"CRL works automatically without an S3 bucket policy.\"** It does\n  not. The CRL distribution point requires an S3 bucket where ACM PCA\n  publishes the CRL. The bucket MUST have a policy granting the\n  `acm-pca.amazonaws.com` service principal `s3:PutObject` permission.\n  Without this policy, CRL publication silently fails and clients\n  cannot check revocation status.\n\n- **\"CA deletion is instant.\"** It is NOT. Deleting a CA initiates a\n  mandatory waiting period of 7 to 30 days (you choose the duration).\n  During this period the CA is in `DELETED` status but can be restored.\n  After the period expires, the CA and all its data are permanently\n  destroyed. This waiting period exists because certificates issued\n  by the CA may still be in use.\n\n## Configuration dependency graph (novel heuristic)\n\nACM PCA configurations are NOT independent. The CA must be ACTIVE\nbefore issuing certificates. CRL requires an S3 bucket with the correct\npolicy. Subordinate CAs require parent CA permission. Use this graph to\nsequence provisioning.\n\n| Configuration | Hard dependencies (API error without) | Silent failure \u002F immutability | Enables downstream |\n|---|---|---|---|\n| CA creation (root) | Key alg, signing alg, subject DN | CA is `CREATING` then `PENDING_CERTIFICATE`; NOT usable until `ACTIVE` | the CA ARN |\n| CA creation (subordinate) | Key alg, signing alg, subject DN, parent CA ARN | CA is `PENDING_CERTIFICATE` until parent signs it; parent MUST have `create-permission` | subordinate CA |\n| CA certificate (root) | CA created; CSR obtained | Root CA cert is self-signed; must issue then import | `ACTIVE` status |\n| CA certificate (subordinate) | Subordinate CA created; CSR obtained; parent CA `ACTIVE` | Parent CA must issue subordinate cert; then import into subordinate | subordinate `ACTIVE` status |\n| CRL configuration | S3 bucket exists | Bucket MUST have policy granting `acm-pca.amazonaws.com` `s3:PutObject`; without it CRL publication silently fails | revocation checking |\n| End-entity certificate | CA `ACTIVE`; certificate template ARN | Template determines key usage, path length, validity; wrong template = wrong certificate | private TLS certificate |\n| ACM integration | CA `ACTIVE`; `create-permission` granting ACM service principal | Without permission, ACM cannot request\u002Frenew certs from the CA | managed private cert lifecycle |\n| CA deletion | CA exists | 7-30 day mandatory waiting period; restorable until period expires | decommissioning |\n\n**The subordinate-parent-permission row is the one a baseline model\nmisses.** Creating a subordinate CA is not enough — the parent CA must\nhave a permission entry (`create-permission`) granting the requesting\nprincipal the right to issue. Without it, the subordinate CA cannot be\nsigned by the parent and stays in `PENDING_CERTIFICATE` forever.\n\n**Cross-dependency gotchas:**\n- A subordinate CA requires the parent CA to be `ACTIVE` AND to have a\n  `create-permission` entry. Both conditions must be met.\n- CRL publication requires the S3 bucket policy to grant\n  `acm-pca.amazonaws.com` write access. Missing the policy is a silent\n  failure — the CA appears to work, but CRL is never published.\n- ACM integration requires BOTH the CA to be `ACTIVE` AND a\n  `create-permission` granting the ACM service principal access.\n- CA deletion is reversible during the waiting period via\n  `restore-certificate-authority`. After the period, it is permanent.\n\n## Expert heuristic: root vs subordinate CA hierarchy\n\nFull hierarchy decision tree (root self-sign vs subordinate parent-sign flows): moved to [references\u002Fadvanced-patterns.md](references\u002Fadvanced-patterns.md); command-level detail in [references\u002Fca-hierarchy-and-signing.md](references\u002Fca-hierarchy-and-signing.md).\n\n## Expert heuristic: CRL S3 bucket policy\n\nCRL prerequisite checklist and silent-failure mode: moved to [references\u002Fadvanced-patterns.md](references\u002Fadvanced-patterns.md); bucket setup commands in [references\u002Fcrl-and-revocation.md](references\u002Fcrl-and-revocation.md).\n\n## Expert heuristic: CA deletion waiting period\n\nDeletion flow and restore semantics: moved to [references\u002Fadvanced-patterns.md](references\u002Fadvanced-patterns.md); delete\u002Frestore commands in [references\u002Fcrl-and-revocation.md](references\u002Fcrl-and-revocation.md).\n\n## Prerequisites (verify before provisioning)\n\nBefore emitting provisioning commands, verify these prerequisites. If\nany are missing, the verdict is **PREREQUISITES_MISSING**.\n\n| Prerequisite | Why it matters | How to verify |\n|---|---|---|\n| Key algorithm chosen | Determines CA key type | Confirm in plan |\n| Signing algorithm chosen | Must be compatible with key algorithm | Confirm in plan |\n| Subject distinguished name (DN) | Required for CA creation | Confirm subject |\n| S3 bucket for CRL (if CRL enabled) | CRL publication requires a writable bucket | `aws s3api head-bucket --bucket \u003Cname>` |\n| CRL bucket policy grants PCA access | Without it CRL publication silently fails | `aws s3api get-bucket-policy --bucket \u003Cname>` |\n| Parent CA ACTIVE (for subordinate) | Subordinate CA requires parent signing | `aws acm-pca describe-certificate-authority --certificate-authority-arn \u003Cparent-arn>` |\n| Parent CA create-permission (for subordinate) | Parent must grant permission to issue | `aws acm-pca list-permissions --certificate-authority-arn \u003Cparent-arn>` |\n| Certificate template identified | Template determines cert type, key usage, path length | Confirm template ARN |\n\nIf any prerequisite is missing, output `VERDICT: PREREQUISITES_MISSING`\nand cite the specific gap.\n\n## Step 1 — CA type: root vs subordinate\n\n| Feature | Root CA | Subordinate CA |\n|---|---|---|\n| Certificate source | Self-signed | Signed by parent CA |\n| Template for CA cert | `RootCACertificate\u002FV1` | `SubordinateCACertificate\u002FPathLen0\u002FV1` |\n| Trust anchor | Yes (clients trust directly) | No (clients trust root above it) |\n| Requires parent CA | No | Yes (parent ACTIVE + permission) |\n| Typical use | Offline root, trust anchor | Intermediate CA for daily cert issuance |\n\n**Best practice:** use a root CA as the offline trust anchor and\nsubordinate CAs for active certificate issuance. This limits root CA\nexposure.\n\n## Step 2 — Key and signing algorithm selection\n\n| Key algorithm | Valid signing algorithms | Notes |\n|---|---|---|\n| `RSA_2048` | `SHA256withRSA`, `SHA384withRSA`, `SHA512withRSA` | Default for most CAs |\n| `RSA_4096` | `SHA256withRSA`, `SHA384withRSA`, `SHA512withRSA` | Root CAs requiring extra margin |\n| `EC_prime256v1` | `SHA256withECDSA`, `SHA384withECDSA`, `SHA512withECDSA` | High-throughput subordinate CAs |\n| `EC_secp384r1` | `SHA256withECDSA`, `SHA384withECDSA`, `SHA512withECDSA` | Stronger EC |\n\n**Default:** `SHA256withRSA` for RSA keys, `SHA256withECDSA` for EC\nkeys. These have the broadest client compatibility.\n\n## Step 3 — CRL configuration (S3 bucket)\n\nBucket creation and PCA bucket-policy commands: [references\u002Fcrl-and-revocation.md](references\u002Fcrl-and-revocation.md).\n\n## Step 4 — Create the CA and issue CA certificate\n\ncreate-certificate-authority commands (root + subordinate): [references\u002Fca-hierarchy-and-signing.md](references\u002Fca-hierarchy-and-signing.md).\n\nRoot CA activation commands (CSR -> self-signed issue -> import): [references\u002Fca-hierarchy-and-signing.md](references\u002Fca-hierarchy-and-signing.md).\n\nSubordinate CA activation commands (parent signs CSR -> import chain): [references\u002Fca-hierarchy-and-signing.md](references\u002Fca-hierarchy-and-signing.md).\n\n**Verify CA is ACTIVE:**\n\n```bash\naws acm-pca describe-certificate-authority \\\n  --certificate-authority-arn \"$ROOT_CA_ARN\" \\\n  --query 'CertificateAuthority.Status' --region us-east-1\n# Expected: ACTIVE\n```\n\n**Common mistake:** assuming the CA is immediately usable. After\ncreation, the CA is in `PENDING_CERTIFICATE`. It must receive its CA\ncertificate to become `ACTIVE`.\n\n## Step 5 — Certificate templates and end-entity issuance\n\n| Template ARN suffix | Purpose | Path length |\n|---|---|---|\n| `RootCACertificate\u002FV1` | Self-signed root CA certificate | N\u002FA |\n| `SubordinateCACertificate_PathLen0\u002FV1` | Subordinate CA (cannot issue further CA certs) | 0 |\n| `SubordinateCACertificate_PathLen1\u002FV1` | Subordinate CA (can issue one more level) | 1 |\n| `EndEntityCertificate\u002FCertPassedPathLen\u002F0` | End-entity TLS certificate | N\u002FA |\n| `EndEntityCertificate\u002FV1` | Basic end-entity certificate | N\u002FA |\n| `CodeSigningCertificate\u002FV1` | Code signing certificate | N\u002FA |\n| `OCSPSigningCertificate\u002FV1` | OCSP responder signing | N\u002FA |\n\nissue-certificate end-entity command: [references\u002Fca-hierarchy-and-signing.md](references\u002Fca-hierarchy-and-signing.md).\n\n## Step 6 — CA permissions for ACM integration\n\nTo let AWS Certificate Manager (ACM) request, issue, and renew private\ncertificates from a PCA, grant the ACM service principal permission.\n\n```bash\naws acm-pca create-permission \\\n  --certificate-authority-arn \"$SUB_CA_ARN\" \\\n  --principal acm.amazonaws.com \\\n  --actions IssueCertificate GetCertificate ListPermissions \\\n  --region us-east-1\n```\n\nCross-account create-permission command: [references\u002Fca-hierarchy-and-signing.md](references\u002Fca-hierarchy-and-signing.md).\n\n## Step 7 — Certificate revocation and OCSP\n\nrevoke-certificate and OCSP enable commands: [references\u002Fcrl-and-revocation.md](references\u002Fcrl-and-revocation.md).\n\n## Step 8 — CA deletion (mandatory waiting period)\n\ndelete\u002Frestore-certificate-authority commands: [references\u002Fcrl-and-revocation.md](references\u002Fcrl-and-revocation.md).\n\n## Step 9 — Audit via CloudTrail\n\nAll ACM PCA API calls are logged to CloudTrail, providing a full audit\ntrail.\n\n| Event | Security significance |\n|---|---|\n| `CreateCertificateAuthority` | New CA created |\n| `IssueCertificate` | Certificate issued (who, what, template) |\n| `ImportCertificateAuthorityCertificate` | CA activated |\n| `RevokeCertificate` | Certificate revoked (who, why, serial) |\n| `DeleteCertificateAuthority` | CA deletion initiated (waiting period started) |\n| `CreatePermission` | Permission granted |\n| `DeletePermission` | Permission revoked |\n\n## Step 10 — Recent features\n\nFull feature list with dates: [references\u002Fadvanced-patterns.md](references\u002Fadvanced-patterns.md).\n\n## NEVER do these things\n\n1. **NEVER assume the CA is usable immediately after creation.** The\n   CA starts in `PENDING_CERTIFICATE`. It must receive its CA\n   certificate to become `ACTIVE`.\n\n2. **NEVER create a subordinate CA without verifying the parent CA is\n   ACTIVE and has `create-permission`.** Without permission, the\n   subordinate stays `PENDING_CERTIFICATE` indefinitely.\n\n3. **NEVER configure CRL without the S3 bucket policy.** CRL\n   publication silently fails without the policy granting\n   `acm-pca.amazonaws.com` write access. Revoked certs appear valid.\n\n4. **NEVER delete a CA without understanding the waiting period.**\n   Deletion enters a mandatory 7-30 day period. After expiration, the\n   CA is permanently destroyed and existing certs cannot be revoked.\n\n5. **NEVER use the wrong certificate template.** Templates define key\n   usage, extended key usage, and path length. Wrong template = wrong\n   certificate extensions.\n\n6. **NEVER forget to set up ACM permissions for managed cert lifecycle.**\n   Without `create-permission` for `acm.amazonaws.com`, ACM cannot\n   request or renew private certificates.\n\n7. **NEVER assume OCSP replaces CRL.** Some clients only support CRL.\n   Enable both for maximum client compatibility.\n\n8. **NEVER issue certificates from a root CA for daily operations.**\n   Use subordinate CAs for active issuance. Root CAs should be the\n   offline trust anchor.\n\n9. **NEVER revoke a certificate without recording the serial.** The\n   certificate serial is required for revocation. Always record issued\n   certificate serials in an asset inventory.\n\n10. **NEVER assume CA deletion is instant.** The mandatory waiting\n    period is 7-30 days. Plan decommissioning timelines accordingly.\n\n## Output format (STRICT output contract)\n\nWhen this skill is invoked with an ACM PCA provisioning request, the\nagent MUST respond with the block below using the literal all-caps\nlabels `ACM_PCA:`, `VERDICT:`, `CHECKLIST:`, and\n`VERIFICATION_COMMANDS:`. Do NOT preface the checklist with prose,\nheadings, or disclaimers — emit the block as the first lines of the\nresponse. This contract is what assertion-based evals and downstream\nprovisioning pipelines rely on; deviating from the literal labels\nbreaks automation silently.\n\nIf any prerequisite is missing, the verdict is `PREREQUISITES_MISSING`\nwith a specific gap citation in the checklist (marked `[✗]`), and\n`READY_TO_DEPLOY` MUST NOT also appear.\n\n### Decision tree — CA provisioning flow\n\n```text\nNeed a private CA?\n├── Need a self-signed trust anchor?\n│     → ROOT CA\n│       ├── Key: RSA_2048 (default) | RSA_4096 | EC_prime256v1 | EC_secp384r1\n│       ├── Signing: SHA256withRSA (RSA) | SHA256withECDSA (EC)\n│       ├── Template: RootCACertificate\u002FV1\n│       ├── CRL? → YES: create S3 bucket + policy → configure CrlConfiguration\n│       │          NO: skip (OCSP only or none)\n│       ├── ACM integration? → YES: create-permission for acm.amazonaws.com\n│       └── Activate: self-sign → import-certificate-authority-certificate\n│\n├── Need a CA signed by an existing parent?\n│     → SUBORDINATE CA\n│       ├── PREREQUISITE: parent CA ACTIVE + has create-permission\n│       ├── Template: SubordinateCACertificate_PathLen0\u002FV1\n│       └── Activate: parent signs CSR → import into subordinate\n│\n└── Need to issue end-entity certs (TLS)?\n      → CA (root or subordinate) must be ACTIVE\n      → Template: EndEntityCertificate\u002FCertPassedPathLen\u002F0\n      → For ACM-managed lifecycle: create-permission for acm.amazonaws.com\n```\n\n### Output template\n\n```text\nACM_PCA: \u003Cca-name> (\u003CROOT|SUBORDINATE>, \u003Ckey-algorithm>, \u003Csigning-algorithm>)\nVERDICT: READY_TO_DEPLOY | PREREQUISITES_MISSING\nCHECKLIST:\n  [✓|✗] CA type: ROOT | SUBORDINATE\n  [✓|✗] Key algorithm: RSA_2048 | RSA_4096 | EC_prime256v1 | EC_secp384r1\n  [✓|✗] Signing algorithm: SHA256withRSA | SHA256withECDSA | ...\n  [✓|✗] Subject DN: CN=\u003Ccn>, O=\u003Corg>, C=\u003Ccountry>\n  [✓|✗] CRL S3 bucket: \u003Cbucket-name> — exists\n  [✓|✗] CRL bucket policy: grants acm-pca.amazonaws.com s3:PutObject\n  [✓|✗] CRL expiration: \u003Cdays> days, CustomCname: \u003Ccname|none>\n  [✓|✗] OCSP: enabled | disabled\n  [✓|✗] CA status: CREATING | PENDING_CERTIFICATE | ACTIVE\n  [✓|✗] CA certificate: self-signed (root) | parent-signed (subordinate, parent \u003Cparent-arn>)\n  [✓|✗] Certificate template: \u003Ctemplate-arn-suffix>\n  [✓|✗] ACM integration: create-permission for acm.amazonaws.com (IssueCertificate, GetCertificate, ListPermissions)\n  [✓|✗] Parent CA permission: create-permission granted (for subordinate only)\n  [✓|✗] Tags: \u003Ckey=value list>\nVERIFICATION_COMMANDS:\n  aws acm-pca describe-certificate-authority --certificate-authority-arn \u003Cca-arn> --region \u003Cregion>\n  aws acm-pca list-permissions --certificate-authority-arn \u003Cca-arn> --region \u003Cregion>\n  aws s3api get-bucket-policy --bucket \u003Ccrl-bucket>\n```\n\n### FORBIDDEN NEVER patterns (output contract)\n\n1. **NEVER emit `VERDICT: READY_TO_DEPLOY` without confirming CA status\n   is `ACTIVE`.** A CA in `PENDING_CERTIFICATE` cannot issue\n   certificates. The checklist MUST show `CA status: ACTIVE` with `[✓]`.\n\n2. **NEVER mark CRL as `[✓]` without confirming the S3 bucket policy.**\n   CRL publication silently fails without the policy granting\n   `acm-pca.amazonaws.com` `s3:PutObject`. The checklist MUST show both\n   the bucket name AND the policy status as verified.\n\n3. **NEVER mark ACM integration as `[✓]` without confirming\n   `create-permission` for `acm.amazonaws.com`.** Without this\n   permission, ACM cannot request or renew private certificates. The\n   verification MUST include `list-permissions` output.\n\n4. **NEVER show a subordinate CA as `READY_TO_DEPLOY` without confirming\n   the parent CA is `ACTIVE` and has `create-permission`.** A\n   subordinate without parent signing stays `PENDING_CERTIFICATE`\n   indefinitely. Both conditions (parent ACTIVE AND permission granted)\n   must be met.\n\n5. **NEVER omit the certificate template from the checklist.** The\n   template determines key usage, extended key usage, and path length.\n   A missing or wrong template produces a certificate with incorrect\n   extensions that may be rejected by clients.\n\n6. **NEVER emit `VERDICT: PREREQUISITES_MISSING` without citing the\n   specific gap.** Each `[✗]` item MUST have a one-line reason citing\n   what is missing and how to fix it. A bare `[✗]` with no explanation\n   is non-compliant.\n\n### Perfect worked example — root CA with RSA_2048, CRL, and ACM end-entity issuance\n\n```text\nACM_PCA: Example Root CA (ROOT, RSA_2048, SHA256withRSA)\nVERDICT: READY_TO_DEPLOY\nCHECKLIST:\n  [✓] CA type: ROOT\n  [✓] Key algorithm: RSA_2048\n  [✓] Signing algorithm: SHA256withRSA\n  [✓] Subject DN: CN=Example Root CA, O=Example Org, C=US\n  [✓] CRL S3 bucket: acm-pca-crl-123456789012-us-east-1 — exists\n  [✓] CRL bucket policy: grants acm-pca.amazonaws.com s3:PutObject, s3:PutObjectAcl, s3:GetBucketAcl, s3:GetBucketLocation\n  [✓] CRL expiration: 7 days, CustomCname: crl.example.com\n  [✓] OCSP: enabled (OCSP + CRL both active for maximum client compatibility)\n  [✓] CA status: ACTIVE\n  [✓] CA certificate: self-signed (RootCACertificate\u002FV1 template, validity 10 years)\n  [✓] Certificate template: RootCACertificate\u002FV1 (CA cert); EndEntityCertificate\u002FCertPassedPathLen\u002F0 (end-entity issuance)\n  [✓] ACM integration: create-permission for acm.amazonaws.com — IssueCertificate, GetCertificate, ListPermissions granted\n  [✓] Tags: Environment=production, Purpose=trust-anchor, Owner=platform-team\nVERIFICATION_COMMANDS:\n  aws acm-pca describe-certificate-authority --certificate-authority-arn arn:aws:acm-pca:us-east-1:123456789012:certificate-authority\u002Faaaa-bbbb-cccc --region us-east-1\n  aws acm-pca list-permissions --certificate-authority-arn arn:aws:acm-pca:us-east-1:123456789012:certificate-authority\u002Faaaa-bbbb-cccc --region us-east-1\n  aws s3api get-bucket-policy --bucket acm-pca-crl-123456789012-us-east-1\n  aws acm-pca get-certificate-authority-certificate --certificate-authority-arn arn:aws:acm-pca:us-east-1:123456789012:certificate-authority\u002Faaaa-bbbb-cccc --region us-east-1\n```\n\n**How this example maps to provisioning steps:**\n\n1. Created S3 bucket `acm-pca-crl-123456789012-us-east-1` for CRL.\n2. Applied bucket policy granting `acm-pca.amazonaws.com` write access.\n3. Created ROOT CA with `RSA_2048` \u002F `SHA256withRSA`, CRL enabled (7-day\n   expiration, CNAME `crl.example.com`), OCSP enabled.\n4. Obtained CSR, issued self-signed certificate using\n   `RootCACertificate\u002FV1` template (10-year validity).\n5. Imported the certificate to activate the CA (`ACTIVE` status).\n6. Granted `create-permission` to `acm.amazonaws.com` so ACM can request\n   end-entity certificates using `EndEntityCertificate\u002FCertPassedPathLen\u002F0`\n   template.\n\n**Self-check before emit:**\n- [ ] CA status confirmed ACTIVE (not PENDING_CERTIFICATE)?\n- [ ] CRL bucket policy grants acm-pca.amazonaws.com s3:PutObject?\n- [ ] ACM create-permission confirmed via list-permissions?\n- [ ] Certificate template correct for the CA type?\n- [ ] For subordinate: parent CA ACTIVE + create-permission confirmed?\n\n## Error handling\n\nError remedies (stuck PENDING_CERTIFICATE, parent will not sign, CRL not publishing, ACM access denied, deletion delay): [references\u002Ferror-handling.md](references\u002Ferror-handling.md).\n\n## Domain\n\nAWS CloudOps \u002F AWS Private Certificate Authority (ACM PCA) Provisioning\n& PKI Management.\n\n## References (load on demand)\n\n- [CA hierarchy and signing](references\u002Fca-hierarchy-and-signing.md) — full root\u002Fsubordinate provisioning and activation flows, end-entity issuance, ACM + cross-account permissions, Terraform\n- [CRL and revocation](references\u002Fcrl-and-revocation.md) — CRL bucket setup and policy, revocation + OCSP commands, CA deletion\u002Frestore, CloudTrail auditing\n- [Advanced patterns](references\u002Fadvanced-patterns.md) — expert heuristics (hierarchy decision tree, CRL bucket policy, deletion waiting period), recent AWS features\n- [Error handling](references\u002Ferror-handling.md) — stuck-state and access-denied remedies\n\n## AWS documentation\n\n- **ACM PCA User Guide** — https:\u002F\u002Fdocs.aws.amazon.com\u002Fprivateca\u002Flatest\u002Fuserguide\u002FPcaWelcome.html\n- **Create a CA** — https:\u002F\u002Fdocs.aws.amazon.com\u002Fprivateca\u002Flatest\u002Fuserguide\u002FPcaCreateCa.html\n- **Issue a certificate** — https:\u002F\u002Fdocs.aws.amazon.com\u002Fprivateca\u002Flatest\u002Fuserguide\u002FPcaIssueCert.html\n- **CRL configuration** — https:\u002F\u002Fdocs.aws.amazon.com\u002Fprivateca\u002Flatest\u002Fuserguide\u002FPcaPlanDistribution.html\n- **OCSP configuration** — https:\u002F\u002Fdocs.aws.amazon.com\u002Fprivateca\u002Flatest\u002Fuserguide\u002Focsp.html\n- **CA permissions** — https:\u002F\u002Fdocs.aws.amazon.com\u002Fprivateca\u002Flatest\u002Fuserguide\u002FPcaCreatePerms.html\n- **Certificate templates** — https:\u002F\u002Fdocs.aws.amazon.com\u002Fprivateca\u002Flatest\u002Fuserguide\u002FPcaTemplates.html\n- **CA deletion** — https:\u002F\u002Fdocs.aws.amazon.com\u002Fprivateca\u002Flatest\u002Fuserguide\u002FPcaDeleteCa.html\n- **ACM integration** — https:\u002F\u002Fdocs.aws.amazon.com\u002Fprivateca\u002Flatest\u002Fuserguide\u002FPcaIntegration.html\n- **Revocation** — https:\u002F\u002Fdocs.aws.amazon.com\u002Fprivateca\u002Flatest\u002Fuserguide\u002FPcaRevoke.html\n","# ACM Private CA Deployer\n\nAn AWS CloudOps agent skill that provisions AWS Private Certificate\nAuthority (ACM PCA) with correct defaults. The skill walks the operator\nthrough root vs subordinate CA creation, key and signing algorithm\nselection, CRL configuration, certificate issuance, CA permissions for\nACM integration, certificate revocation, and the mandatory CA deletion\nwaiting period. It captures hierarchy decisions, explains why each\ndefault matters, and emits a READY_TO_DEPLOY checklist with copy-\npasteable verification commands.\n\n## Activation keywords\n\ncreate private certificate authority, ACM PCA root CA, ACM PCA\nsubordinate CA, issue private certificate, CRL configuration S3, revoke\ncertificate ACM PCA, CA deletion waiting period, ACM PCA permissions,\nACM managed private cert.\n\n## STRICT output contract\n\nWhen this skill is invoked with an ACM PCA provisioning request (create\na private CA, issue a certificate, configure CRL, set up a subordinate\nhierarchy, delete a CA, or a partial configuration), the agent MUST\nrespond with the READY_TO_DEPLOY checklist defined in the \"Output\nformat\" section using the literal all-caps labels `ACM_PCA:`,\n`VERDICT:`, `CHECKLIST:`, and `VERIFICATION_COMMANDS:`. Do NOT preface\nthe checklist with prose, headings, or disclaimers — emit the block as\nthe first lines of the response. This contract is what assertion-based\nevals and downstream provisioning pipelines rely on; deviating from\nthe literal labels breaks automation silently.\n\nIf any prerequisite is missing, the verdict is `PREREQUISITES_MISSING`\nwith a specific gap citation in the checklist (marked `[✗]`), and\n`READY_TO_DEPLOY` MUST NOT also appear.\n\n## Quick navigation\n\n| Section | When to read |\n|---|---|\n| Prerequisites | Always — verify before provisioning |\n| Step 1 — CA type: root vs subordinate | Core CA model |\n| Step 2 — Key and signing algorithm selection | Cryptographic choice |\n| Step 3 — CRL configuration (S3 bucket) | Revocation infrastructure |\n| Step 4 — Create the CA and issue CA certificate | Provisioning step |\n| Step 5 — Certificate templates and end-entity issuance | Certificate issuance |\n| Step 6 — CA permissions for ACM integration | Cross-account \u002F ACM managed certs |\n| Step 7 — Certificate revocation and OCSP | Revocation lifecycle |\n| Step 8 — CA deletion (mandatory waiting period) | Decommissioning |\n| Step 9 — Audit via CloudTrail | Compliance |\n| Step 10 — Recent features | Latest |\n| NEVER do these things | Review before signing off |\n| Output format | The literal checklist template |\n| references\u002Fca-hierarchy-and-signing.md | Root\u002Fsubordinate detail |\n| references\u002Fcrl-and-revocation.md | CRL + revocation detail |\n| references\u002Fadvanced-patterns.md | Expert-heuristic deep dives + recent features |\n| references\u002Ferror-handling.md | Error remedies |\n\n## Mindset\n\n**One-line takeaway:** ACM PCA provides managed private CAs. A root CA\nis self-signed; a subordinate CA is signed by its parent CA and MUST\nhave the parent's permission to issue. CRL revocation requires an S3\nbucket with a policy granting the ACM PCA service principal write\naccess. CA deletion is NOT immediate — it enters a mandatory 7-30 day\nwaiting period before permanent deletion.\n\nThree misconceptions dominate ACM PCA misdesign at provisioning time:\n\n- **\"Creating the CA is enough to issue certificates.\"** It is not. A\n  newly created CA is in `PENDING_CERTIFICATE` status. For a root CA,\n  you must issue and import a self-signed certificate. For a\n  subordinate CA, you must request a certificate from the parent CA,\n  then import it. Until the CA is `ACTIVE`, no certificates can be\n  issued from it.\n\n- **\"CRL works automatically without an S3 bucket policy.\"** It does\n  not. The CRL distribution point requires an S3 bucket where ACM PCA\n  publishes the CRL. The bucket MUST have a policy granting the\n  `acm-pca.amazonaws.com` service principal `s3:PutObject` permission.\n  Without this policy, CRL publication silently fails and clients\n  cannot check revocation status.\n\n- **\"CA deletion is instant.\"** It is NOT. Deleting a CA initiates a\n  mandatory waiting period of 7 to 30 days (you choose the duration).\n  During this period the CA is in `DELETED` status but can be restored.\n  After the period expires, the CA and all its data are permanently\n  destroyed. This waiting period exists because certificates issued\n  by the CA may still be in use.\n\n## Configuration dependency graph (novel heuristic)\n\nACM PCA configurations are NOT independent. The CA must be ACTIVE\nbefore issuing certificates. CRL requires an S3 bucket with the correct\npolicy. Subordinate CAs require parent CA permission. Use this graph to\nsequence provisioning.\n\n| Configuration | Hard dependencies (API error without) | Silent failure \u002F immutability | Enables downstream |\n|---|---|---|---|\n| CA creation (root) | Key alg, signing alg, subject DN | CA is `CREATING` then `PENDING_CERTIFICATE`; NOT usable until `ACTIVE` | the CA ARN |\n| CA creation (subordinate) | Key alg, signing alg, subject DN, parent CA ARN | CA is `PENDING_CERTIFICATE` until parent signs it; parent MUST have `create-permission` | subordinate CA |\n| CA certificate (root) | CA created; CSR obtained | Root CA cert is self-signed; must issue then import | `ACTIVE` status |\n| CA certificate (subordinate) | Subordinate CA created; CSR obtained; parent CA `ACTIVE` | Parent CA must issue subordinate cert; then import into subordinate | subordinate `ACTIVE` status |\n| CRL configuration | S3 bucket exists | Bucket MUST have policy granting `acm-pca.amazonaws.com` `s3:PutObject`; without it CRL publication silently fails | revocation checking |\n| End-entity certificate | CA `ACTIVE`; certificate template ARN | Template determines key usage, path length, validity; wrong template = wrong certificate | private TLS certificate |\n| ACM integration | CA `ACTIVE`; `create-permission` granting ACM service principal | Without permission, ACM cannot request\u002Frenew certs from the CA | managed private cert lifecycle |\n| CA deletion | CA exists | 7-30 day mandatory waiting period; restorable until period expires | decommissioning |\n\n**The subordinate-parent-permission row is the one a baseline model\nmisses.** Creating a subordinate CA is not enough — the parent CA must\nhave a permission entry (`create-permission`) granting the requesting\nprincipal the right to issue. Without it, the subordinate CA cannot be\nsigned by the parent and stays in `PENDING_CERTIFICATE` forever.\n\n**Cross-dependency gotchas:**\n- A subordinate CA requires the parent CA to be `ACTIVE` AND to have a\n  `create-permission` entry. Both conditions must be met.\n- CRL publication requires the S3 bucket policy to grant\n  `acm-pca.amazonaws.com` write access. Missing the policy is a silent\n  failure — the CA appears to work, but CRL is never published.\n- ACM integration requires BOTH the CA to be `ACTIVE` AND a\n  `create-permission` granting the ACM service principal access.\n- CA deletion is reversible during the waiting period via\n  `restore-certificate-authority`. After the period, it is permanent.\n\n## Expert heuristic: root vs subordinate CA hierarchy\n\nFull hierarchy decision tree (root self-sign vs subordinate parent-sign flows): moved to [references\u002Fadvanced-patterns.md](references\u002Fadvanced-patterns.md); command-level detail in [references\u002Fca-hierarchy-and-signing.md](references\u002Fca-hierarchy-and-signing.md).\n\n## Expert heuristic: CRL S3 bucket policy\n\nCRL prerequisite checklist and silent-failure mode: moved to [references\u002Fadvanced-patterns.md](references\u002Fadvanced-patterns.md); bucket setup commands in [references\u002Fcrl-and-revocation.md](references\u002Fcrl-and-revocation.md).\n\n## Expert heuristic: CA deletion waiting period\n\nDeletion flow and restore semantics: moved to [references\u002Fadvanced-patterns.md](references\u002Fadvanced-patterns.md); delete\u002Frestore commands in [references\u002Fcrl-and-revocation.md](references\u002Fcrl-and-revocation.md).\n\n## Prerequisites (verify before provisioning)\n\nBefore emitting provisioning commands, verify these prerequisites. If\nany are missing, the verdict is **PREREQUISITES_MISSING**.\n\n| Prerequisite | Why it matters | How to verify |\n|---|---|---|\n| Key algorithm chosen | Determines CA key type | Confirm in plan |\n| Signing algorithm chosen | Must be compatible with key algorithm | Confirm in plan |\n| Subject distinguished name (DN) | Required for CA creation | Confirm subject |\n| S3 bucket for CRL (if CRL enabled) | CRL publication requires a writable bucket | `aws s3api head-bucket --bucket \u003Cname>` |\n| CRL bucket policy grants PCA access | Without it CRL publication silently fails | `aws s3api get-bucket-policy --bucket \u003Cname>` |\n| Parent CA ACTIVE (for subordinate) | Subordinate CA requires parent signing | `aws acm-pca describe-certificate-authority --certificate-authority-arn \u003Cparent-arn>` |\n| Parent CA create-permission (for subordinate) | Parent must grant permission to issue | `aws acm-pca list-permissions --certificate-authority-arn \u003Cparent-arn>` |\n| Certificate template identified | Template determines cert type, key usage, path length | Confirm template ARN |\n\nIf any prerequisite is missing, output `VERDICT: PREREQUISITES_MISSING`\nand cite the specific gap.\n\n## Step 1 — CA type: root vs subordinate\n\n| Feature | Root CA | Subordinate CA |\n|---|---|---|\n| Certificate source | Self-signed | Signed by parent CA |\n| Template for CA cert | `RootCACertificate\u002FV1` | `SubordinateCACertificate\u002FPathLen0\u002FV1` |\n| Trust anchor | Yes (clients trust directly) | No (clients trust root above it) |\n| Requires parent CA | No | Yes (parent ACTIVE + permission) |\n| Typical use | Offline root, trust anchor | Intermediate CA for daily cert issuance |\n\n**Best practice:** use a root CA as the offline trust anchor and\nsubordinate CAs for active certificate issuance. This limits root CA\nexposure.\n\n## Step 2 — Key and signing algorithm selection\n\n| Key algorithm | Valid signing algorithms | Notes |\n|---|---|---|\n| `RSA_2048` | `SHA256withRSA`, `SHA384withRSA`, `SHA512withRSA` | Default for most CAs |\n| `RSA_4096` | `SHA256withRSA`, `SHA384withRSA`, `SHA512withRSA` | Root CAs requiring extra margin |\n| `EC_prime256v1` | `SHA256withECDSA`, `SHA384withECDSA`, `SHA512withECDSA` | High-throughput subordinate CAs |\n| `EC_secp384r1` | `SHA256withECDSA`, `SHA384withECDSA`, `SHA512withECDSA` | Stronger EC |\n\n**Default:** `SHA256withRSA` for RSA keys, `SHA256withECDSA` for EC\nkeys. These have the broadest client compatibility.\n\n## Step 3 — CRL configuration (S3 bucket)\n\nBucket creation and PCA bucket-policy commands: [references\u002Fcrl-and-revocation.md](references\u002Fcrl-and-revocation.md).\n\n## Step 4 — Create the CA and issue CA certificate\n\ncreate-certificate-authority commands (root + subordinate): [references\u002Fca-hierarchy-and-signing.md](references\u002Fca-hierarchy-and-signing.md).\n\nRoot CA activation commands (CSR -> self-signed issue -> import): [references\u002Fca-hierarchy-and-signing.md](references\u002Fca-hierarchy-and-signing.md).\n\nSubordinate CA activation commands (parent signs CSR -> import chain): [references\u002Fca-hierarchy-and-signing.md](references\u002Fca-hierarchy-and-signing.md).\n\n**Verify CA is ACTIVE:**\n\n```bash\naws acm-pca describe-certificate-authority \\\n  --certificate-authority-arn \"$ROOT_CA_ARN\" \\\n  --query 'CertificateAuthority.Status' --region us-east-1\n# Expected: ACTIVE\n```\n\n**Common mistake:** assuming the CA is immediately usable. After\ncreation, the CA is in `PENDING_CERTIFICATE`. It must receive its CA\ncertificate to become `ACTIVE`.\n\n## Step 5 — Certificate templates and end-entity issuance\n\n| Template ARN suffix | Purpose | Path length |\n|---|---|---|\n| `RootCACertificate\u002FV1` | Self-signed root CA certificate | N\u002FA |\n| `SubordinateCACertificate_PathLen0\u002FV1` | Subordinate CA (cannot issue further CA certs) | 0 |\n| `SubordinateCACertificate_PathLen1\u002FV1` | Subordinate CA (can issue one more level) | 1 |\n| `EndEntityCertificate\u002FCertPassedPathLen\u002F0` | End-entity TLS certificate | N\u002FA |\n| `EndEntityCertificate\u002FV1` | Basic end-entity certificate | N\u002FA |\n| `CodeSigningCertificate\u002FV1` | Code signing certificate | N\u002FA |\n| `OCSPSigningCertificate\u002FV1` | OCSP responder signing | N\u002FA |\n\nissue-certificate end-entity command: [references\u002Fca-hierarchy-and-signing.md](references\u002Fca-hierarchy-and-signing.md).\n\n## Step 6 — CA permissions for ACM integration\n\nTo let AWS Certificate Manager (ACM) request, issue, and renew private\ncertificates from a PCA, grant the ACM service principal permission.\n\n```bash\naws acm-pca create-permission \\\n  --certificate-authority-arn \"$SUB_CA_ARN\" \\\n  --principal acm.amazonaws.com \\\n  --actions IssueCertificate GetCertificate ListPermissions \\\n  --region us-east-1\n```\n\nCross-account create-permission command: [references\u002Fca-hierarchy-and-signing.md](references\u002Fca-hierarchy-and-signing.md).\n\n## Step 7 — Certificate revocation and OCSP\n\nrevoke-certificate and OCSP enable commands: [references\u002Fcrl-and-revocation.md](references\u002Fcrl-and-revocation.md).\n\n## Step 8 — CA deletion (mandatory waiting period)\n\ndelete\u002Frestore-certificate-authority commands: [references\u002Fcrl-and-revocation.md](references\u002Fcrl-and-revocation.md).\n\n## Step 9 — Audit via CloudTrail\n\nAll ACM PCA API calls are logged to CloudTrail, providing a full audit\ntrail.\n\n| Event | Security significance |\n|---|---|\n| `CreateCertificateAuthority` | New CA created |\n| `IssueCertificate` | Certificate issued (who, what, template) |\n| `ImportCertificateAuthorityCertificate` | CA activated |\n| `RevokeCertificate` | Certificate revoked (who, why, serial) |\n| `DeleteCertificateAuthority` | CA deletion initiated (waiting period started) |\n| `CreatePermission` | Permission granted |\n| `DeletePermission` | Permission revoked |\n\n## Step 10 — Recent features\n\nFull feature list with dates: [references\u002Fadvanced-patterns.md](references\u002Fadvanced-patterns.md).\n\n## NEVER do these things\n\n1. **NEVER assume the CA is usable immediately after creation.** The\n   CA starts in `PENDING_CERTIFICATE`. It must receive its CA\n   certificate to become `ACTIVE`.\n\n2. **NEVER create a subordinate CA without verifying the parent CA is\n   ACTIVE and has `create-permission`.** Without permission, the\n   subordinate stays `PENDING_CERTIFICATE` indefinitely.\n\n3. **NEVER configure CRL without the S3 bucket policy.** CRL\n   publication silently fails without the policy granting\n   `acm-pca.amazonaws.com` write access. Revoked certs appear valid.\n\n4. **NEVER delete a CA without understanding the waiting period.**\n   Deletion enters a mandatory 7-30 day period. After expiration, the\n   CA is permanently destroyed and existing certs cannot be revoked.\n\n5. **NEVER use the wrong certificate template.** Templates define key\n   usage, extended key usage, and path length. Wrong template = wrong\n   certificate extensions.\n\n6. **NEVER forget to set up ACM permissions for managed cert lifecycle.**\n   Without `create-permission` for `acm.amazonaws.com`, ACM cannot\n   request or renew private certificates.\n\n7. **NEVER assume OCSP replaces CRL.** Some clients only support CRL.\n   Enable both for maximum client compatibility.\n\n8. **NEVER issue certificates from a root CA for daily operations.**\n   Use subordinate CAs for active issuance. Root CAs should be the\n   offline trust anchor.\n\n9. **NEVER revoke a certificate without recording the serial.** The\n   certificate serial is required for revocation. Always record issued\n   certificate serials in an asset inventory.\n\n10. **NEVER assume CA deletion is instant.** The mandatory waiting\n    period is 7-30 days. Plan decommissioning timelines accordingly.\n\n## Output format (STRICT output contract)\n\nWhen this skill is invoked with an ACM PCA provisioning request, the\nagent MUST respond with the block below using the literal all-caps\nlabels `ACM_PCA:`, `VERDICT:`, `CHECKLIST:`, and\n`VERIFICATION_COMMANDS:`. Do NOT preface the checklist with prose,\nheadings, or disclaimers — emit the block as the first lines of the\nresponse. This contract is what assertion-based evals and downstream\nprovisioning pipelines rely on; deviating from the literal labels\nbreaks automation silently.\n\nIf any prerequisite is missing, the verdict is `PREREQUISITES_MISSING`\nwith a specific gap citation in the checklist (marked `[✗]`), and\n`READY_TO_DEPLOY` MUST NOT also appear.\n\n### Decision tree — CA provisioning flow\n\n```text\nNeed a private CA?\n├── Need a self-signed trust anchor?\n│     → ROOT CA\n│       ├── Key: RSA_2048 (default) | RSA_4096 | EC_prime256v1 | EC_secp384r1\n│       ├── Signing: SHA256withRSA (RSA) | SHA256withECDSA (EC)\n│       ├── Template: RootCACertificate\u002FV1\n│       ├── CRL? → YES: create S3 bucket + policy → configure CrlConfiguration\n│       │          NO: skip (OCSP only or none)\n│       ├── ACM integration? → YES: create-permission for acm.amazonaws.com\n│       └── Activate: self-sign → import-certificate-authority-certificate\n│\n├── Need a CA signed by an existing parent?\n│     → SUBORDINATE CA\n│       ├── PREREQUISITE: parent CA ACTIVE + has create-permission\n│       ├── Template: SubordinateCACertificate_PathLen0\u002FV1\n│       └── Activate: parent signs CSR → import into subordinate\n│\n└── Need to issue end-entity certs (TLS)?\n      → CA (root or subordinate) must be ACTIVE\n      → Template: EndEntityCertificate\u002FCertPassedPathLen\u002F0\n      → For ACM-managed lifecycle: create-permission for acm.amazonaws.com\n```\n\n### Output template\n\n```text\nACM_PCA: \u003Cca-name> (\u003CROOT|SUBORDINATE>, \u003Ckey-algorithm>, \u003Csigning-algorithm>)\nVERDICT: READY_TO_DEPLOY | PREREQUISITES_MISSING\nCHECKLIST:\n  [✓|✗] CA type: ROOT | SUBORDINATE\n  [✓|✗] Key algorithm: RSA_2048 | RSA_4096 | EC_prime256v1 | EC_secp384r1\n  [✓|✗] Signing algorithm: SHA256withRSA | SHA256withECDSA | ...\n  [✓|✗] Subject DN: CN=\u003Ccn>, O=\u003Corg>, C=\u003Ccountry>\n  [✓|✗] CRL S3 bucket: \u003Cbucket-name> — exists\n  [✓|✗] CRL bucket policy: grants acm-pca.amazonaws.com s3:PutObject\n  [✓|✗] CRL expiration: \u003Cdays> days, CustomCname: \u003Ccname|none>\n  [✓|✗] OCSP: enabled | disabled\n  [✓|✗] CA status: CREATING | PENDING_CERTIFICATE | ACTIVE\n  [✓|✗] CA certificate: self-signed (root) | parent-signed (subordinate, parent \u003Cparent-arn>)\n  [✓|✗] Certificate template: \u003Ctemplate-arn-suffix>\n  [✓|✗] ACM integration: create-permission for acm.amazonaws.com (IssueCertificate, GetCertificate, ListPermissions)\n  [✓|✗] Parent CA permission: create-permission granted (for subordinate only)\n  [✓|✗] Tags: \u003Ckey=value list>\nVERIFICATION_COMMANDS:\n  aws acm-pca describe-certificate-authority --certificate-authority-arn \u003Cca-arn> --region \u003Cregion>\n  aws acm-pca list-permissions --certificate-authority-arn \u003Cca-arn> --region \u003Cregion>\n  aws s3api get-bucket-policy --bucket \u003Ccrl-bucket>\n```\n\n### FORBIDDEN NEVER patterns (output contract)\n\n1. **NEVER emit `VERDICT: READY_TO_DEPLOY` without confirming CA status\n   is `ACTIVE`.** A CA in `PENDING_CERTIFICATE` cannot issue\n   certificates. The checklist MUST show `CA status: ACTIVE` with `[✓]`.\n\n2. **NEVER mark CRL as `[✓]` without confirming the S3 bucket policy.**\n   CRL publication silently fails without the policy granting\n   `acm-pca.amazonaws.com` `s3:PutObject`. The checklist MUST show both\n   the bucket name AND the policy status as verified.\n\n3. **NEVER mark ACM integration as `[✓]` without confirming\n   `create-permission` for `acm.amazonaws.com`.** Without this\n   permission, ACM cannot request or renew private certificates. The\n   verification MUST include `list-permissions` output.\n\n4. **NEVER show a subordinate CA as `READY_TO_DEPLOY` without confirming\n   the parent CA is `ACTIVE` and has `create-permission`.** A\n   subordinate without parent signing stays `PENDING_CERTIFICATE`\n   indefinitely. Both conditions (parent ACTIVE AND permission granted)\n   must be met.\n\n5. **NEVER omit the certificate template from the checklist.** The\n   template determines key usage, extended key usage, and path length.\n   A missing or wrong template produces a certificate with incorrect\n   extensions that may be rejected by clients.\n\n6. **NEVER emit `VERDICT: PREREQUISITES_MISSING` without citing the\n   specific gap.** Each `[✗]` item MUST have a one-line reason citing\n   what is missing and how to fix it. A bare `[✗]` with no explanation\n   is non-compliant.\n\n### Perfect worked example — root CA with RSA_2048, CRL, and ACM end-entity issuance\n\n```text\nACM_PCA: Example Root CA (ROOT, RSA_2048, SHA256withRSA)\nVERDICT: READY_TO_DEPLOY\nCHECKLIST:\n  [✓] CA type: ROOT\n  [✓] Key algorithm: RSA_2048\n  [✓] Signing algorithm: SHA256withRSA\n  [✓] Subject DN: CN=Example Root CA, O=Example Org, C=US\n  [✓] CRL S3 bucket: acm-pca-crl-123456789012-us-east-1 — exists\n  [✓] CRL bucket policy: grants acm-pca.amazonaws.com s3:PutObject, s3:PutObjectAcl, s3:GetBucketAcl, s3:GetBucketLocation\n  [✓] CRL expiration: 7 days, CustomCname: crl.example.com\n  [✓] OCSP: enabled (OCSP + CRL both active for maximum client compatibility)\n  [✓] CA status: ACTIVE\n  [✓] CA certificate: self-signed (RootCACertificate\u002FV1 template, validity 10 years)\n  [✓] Certificate template: RootCACertificate\u002FV1 (CA cert); EndEntityCertificate\u002FCertPassedPathLen\u002F0 (end-entity issuance)\n  [✓] ACM integration: create-permission for acm.amazonaws.com — IssueCertificate, GetCertificate, ListPermissions granted\n  [✓] Tags: Environment=production, Purpose=trust-anchor, Owner=platform-team\nVERIFICATION_COMMANDS:\n  aws acm-pca describe-certificate-authority --certificate-authority-arn arn:aws:acm-pca:us-east-1:123456789012:certificate-authority\u002Faaaa-bbbb-cccc --region us-east-1\n  aws acm-pca list-permissions --certificate-authority-arn arn:aws:acm-pca:us-east-1:123456789012:certificate-authority\u002Faaaa-bbbb-cccc --region us-east-1\n  aws s3api get-bucket-policy --bucket acm-pca-crl-123456789012-us-east-1\n  aws acm-pca get-certificate-authority-certificate --certificate-authority-arn arn:aws:acm-pca:us-east-1:123456789012:certificate-authority\u002Faaaa-bbbb-cccc --region us-east-1\n```\n\n**How this example maps to provisioning steps:**\n\n1. Created S3 bucket `acm-pca-crl-123456789012-us-east-1` for CRL.\n2. Applied bucket policy granting `acm-pca.amazonaws.com` write access.\n3. Created ROOT CA with `RSA_2048` \u002F `SHA256withRSA`, CRL enabled (7-day\n   expiration, CNAME `crl.example.com`), OCSP enabled.\n4. Obtained CSR, issued self-signed certificate using\n   `RootCACertificate\u002FV1` template (10-year validity).\n5. Imported the certificate to activate the CA (`ACTIVE` status).\n6. Granted `create-permission` to `acm.amazonaws.com` so ACM can request\n   end-entity certificates using `EndEntityCertificate\u002FCertPassedPathLen\u002F0`\n   template.\n\n**Self-check before emit:**\n- [ ] CA status confirmed ACTIVE (not PENDING_CERTIFICATE)?\n- [ ] CRL bucket policy grants acm-pca.amazonaws.com s3:PutObject?\n- [ ] ACM create-permission confirmed via list-permissions?\n- [ ] Certificate template correct for the CA type?\n- [ ] For subordinate: parent CA ACTIVE + create-permission confirmed?\n\n## Error handling\n\nError remedies (stuck PENDING_CERTIFICATE, parent will not sign, CRL not publishing, ACM access denied, deletion delay): [references\u002Ferror-handling.md](references\u002Ferror-handling.md).\n\n## Domain\n\nAWS CloudOps \u002F AWS Private Certificate Authority (ACM PCA) Provisioning\n& PKI Management.\n\n## References (load on demand)\n\n- [CA hierarchy and signing](references\u002Fca-hierarchy-and-signing.md) — full root\u002Fsubordinate provisioning and activation flows, end-entity issuance, ACM + cross-account permissions, Terraform\n- [CRL and revocation](references\u002Fcrl-and-revocation.md) — CRL bucket setup and policy, revocation + OCSP commands, CA deletion\u002Frestore, CloudTrail auditing\n- [Advanced patterns](references\u002Fadvanced-patterns.md) — expert heuristics (hierarchy decision tree, CRL bucket policy, deletion waiting period), recent AWS features\n- [Error handling](references\u002Ferror-handling.md) — stuck-state and access-denied remedies\n\n## AWS documentation\n\n- **ACM PCA User Guide** — https:\u002F\u002Fdocs.aws.amazon.com\u002Fprivateca\u002Flatest\u002Fuserguide\u002FPcaWelcome.html\n- **Create a CA** — https:\u002F\u002Fdocs.aws.amazon.com\u002Fprivateca\u002Flatest\u002Fuserguide\u002FPcaCreateCa.html\n- **Issue a certificate** — https:\u002F\u002Fdocs.aws.amazon.com\u002Fprivateca\u002Flatest\u002Fuserguide\u002FPcaIssueCert.html\n- **CRL configuration** — https:\u002F\u002Fdocs.aws.amazon.com\u002Fprivateca\u002Flatest\u002Fuserguide\u002FPcaPlanDistribution.html\n- **OCSP configuration** — https:\u002F\u002Fdocs.aws.amazon.com\u002Fprivateca\u002Flatest\u002Fuserguide\u002Focsp.html\n- **CA permissions** — https:\u002F\u002Fdocs.aws.amazon.com\u002Fprivateca\u002Flatest\u002Fuserguide\u002FPcaCreatePerms.html\n- **Certificate templates** — https:\u002F\u002Fdocs.aws.amazon.com\u002Fprivateca\u002Flatest\u002Fuserguide\u002FPcaTemplates.html\n- **CA deletion** — https:\u002F\u002Fdocs.aws.amazon.com\u002Fprivateca\u002Flatest\u002Fuserguide\u002FPcaDeleteCa.html\n- **ACM integration** — https:\u002F\u002Fdocs.aws.amazon.com\u002Fprivateca\u002Flatest\u002Fuserguide\u002FPcaIntegration.html\n- **Revocation** — https:\u002F\u002Fdocs.aws.amazon.com\u002Fprivateca\u002Flatest\u002Fuserguide\u002FPcaRevoke.html\n",{"name":5,"license":15,"metadata":24,"description":7,"compatibility":41},{"tags":25,"phase":26,"author":27,"domain":28,"family":29,"version":30,"keywords":31,"task_type":32,"complexity":33,"entry_point":34,"skill_class":35,"when_to_use":36,"dependencies":37,"requires_llm":38,"verdict_shape":39,"lifecycle_status":40,"supports_pipeline":38},"aws, acm-pca, private-ca, cloudops, deploy, security, provisioning, pki, certificates, crl, revocation","1","Jacky Chan — AWS Community Builder","aws-cloudops","Security","0.1.0","aws, acm, acm pca, private certificate authority, private ca, cloudops, deploy, provisioning, root ca, subordinate ca, certificate, crl, ocsp, revocation, pki","deploy","high","false","capability","Invoke when the user wants to create a private certificate authority (root or subordinate), issue private certificates, configure CRL revocation, set up a subordinate CA hierarchy, integrate ACM PCA with ACM for managed certificate lifecycle, delete a private CA, or revoke certificates. Do NOT invoke for public TLS certificates (use ACM public certificate skills), AWS Certificate Manager public issuance, or AWS Secrets Manager certificate storage.","aws-orchestrator","true","READY_TO_DEPLOY | PREREQUISITES_MISSING","active","Agent runtime that reads SKILL.md (Claude Code, Cursor, Windsurf, Codex, Gemini). For live deployment: AWS CLI v2 with acm-pca and acm access. Works with Terraform aws_acmpca_certificate_authority \u002F aws_acmpca_certificate \u002F aws_acmpca_certificate_authority_certificate resources and CloudFormation AWS::ACMPCA::CertificateAuthority \u002F AWS::ACMPCA::Certificate templates.","main","eeace51bd5dd1db2030729d83eeab988861553aa","skills\u002Facm-private-ca-deployer",0,"https:\u002F\u002Fgithub.com\u002Fjhkchan\u002Faws-agent-skills","https:\u002F\u002Fgithub.com\u002Fjhkchan","CTO & Co-Founder @Beever-AI  & @votee. CAISP. AWS Community Builder. Organizer@GDGCloudHK. MongoDB Champion. Technopreneur + Infornographer.","2026-09-24 08:54:10",{"source":8,"skillName":5,"commands":51,"prompt":61,"zipAvailable":62},[52,55,58],{"tool":53,"command":54},"npx","npx skills add jhkchan\u002Faws-agent-skills --skill acm-private-ca-deployer",{"tool":56,"command":57},"bunx","bunx skills add jhkchan\u002Faws-agent-skills --skill acm-private-ca-deployer",{"tool":59,"command":60},"pnpm","pnpm dlx skills add jhkchan\u002Faws-agent-skills --skill acm-private-ca-deployer","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fjhkchan\u002Faws-agent-skills\u002Fblob\u002Fmain\u002Fskills\u002Facm-private-ca-deployer\u002FSKILL.md",true,[64,70,74,78,82,86,90,94,98,102,106,110,114,118,122,126,130,134,138],{"path":65,"resourceType":66,"resourceTypeDesc":67,"sizeBytes":68,"sourceHtmlUrl":69},"eval\u002Ftest-cases.yaml","REFERENCE","参考文档",6115,"https:\u002F\u002Fgithub.com\u002Fjhkchan\u002Faws-agent-skills\u002Fblob\u002Fmain\u002Fskills\u002Facm-private-ca-deployer\u002Feval\u002Ftest-cases.yaml",{"path":71,"resourceType":66,"resourceTypeDesc":67,"sizeBytes":72,"sourceHtmlUrl":73},"evals\u002Fbaselines\u002Fca-deletion-waiting-period.md",676,"https:\u002F\u002Fgithub.com\u002Fjhkchan\u002Faws-agent-skills\u002Fblob\u002Fmain\u002Fskills\u002Facm-private-ca-deployer\u002Fevals\u002Fbaselines\u002Fca-deletion-waiting-period.md",{"path":75,"resourceType":66,"resourceTypeDesc":67,"sizeBytes":76,"sourceHtmlUrl":77},"evals\u002Fbaselines\u002Fend-entity-certificate-issuance.md",695,"https:\u002F\u002Fgithub.com\u002Fjhkchan\u002Faws-agent-skills\u002Fblob\u002Fmain\u002Fskills\u002Facm-private-ca-deployer\u002Fevals\u002Fbaselines\u002Fend-entity-certificate-issuance.md",{"path":79,"resourceType":66,"resourceTypeDesc":67,"sizeBytes":80,"sourceHtmlUrl":81},"evals\u002Fbaselines\u002Fmissing-crl-bucket-policy.md",941,"https:\u002F\u002Fgithub.com\u002Fjhkchan\u002Faws-agent-skills\u002Fblob\u002Fmain\u002Fskills\u002Facm-private-ca-deployer\u002Fevals\u002Fbaselines\u002Fmissing-crl-bucket-policy.md",{"path":83,"resourceType":66,"resourceTypeDesc":67,"sizeBytes":84,"sourceHtmlUrl":85},"evals\u002Fbaselines\u002Froot-ca-with-crl.md",799,"https:\u002F\u002Fgithub.com\u002Fjhkchan\u002Faws-agent-skills\u002Fblob\u002Fmain\u002Fskills\u002Facm-private-ca-deployer\u002Fevals\u002Fbaselines\u002Froot-ca-with-crl.md",{"path":87,"resourceType":66,"resourceTypeDesc":67,"sizeBytes":88,"sourceHtmlUrl":89},"evals\u002Fbaselines\u002Fsubordinate-ca-signed-by-root.md",869,"https:\u002F\u002Fgithub.com\u002Fjhkchan\u002Faws-agent-skills\u002Fblob\u002Fmain\u002Fskills\u002Facm-private-ca-deployer\u002Fevals\u002Fbaselines\u002Fsubordinate-ca-signed-by-root.md",{"path":91,"resourceType":66,"resourceTypeDesc":67,"sizeBytes":92,"sourceHtmlUrl":93},"evals\u002Feval_config.yaml",1800,"https:\u002F\u002Fgithub.com\u002Fjhkchan\u002Faws-agent-skills\u002Fblob\u002Fmain\u002Fskills\u002Facm-private-ca-deployer\u002Fevals\u002Feval_config.yaml",{"path":95,"resourceType":66,"resourceTypeDesc":67,"sizeBytes":96,"sourceHtmlUrl":97},"evals\u002Fevals.json",10363,"https:\u002F\u002Fgithub.com\u002Fjhkchan\u002Faws-agent-skills\u002Fblob\u002Fmain\u002Fskills\u002Facm-private-ca-deployer\u002Fevals\u002Fevals.json",{"path":99,"resourceType":66,"resourceTypeDesc":67,"sizeBytes":100,"sourceHtmlUrl":101},"evals\u002Fprompts\u002Fca-deletion-waiting-period.md",465,"https:\u002F\u002Fgithub.com\u002Fjhkchan\u002Faws-agent-skills\u002Fblob\u002Fmain\u002Fskills\u002Facm-private-ca-deployer\u002Fevals\u002Fprompts\u002Fca-deletion-waiting-period.md",{"path":103,"resourceType":66,"resourceTypeDesc":67,"sizeBytes":104,"sourceHtmlUrl":105},"evals\u002Fprompts\u002Fend-entity-certificate-issuance.md",570,"https:\u002F\u002Fgithub.com\u002Fjhkchan\u002Faws-agent-skills\u002Fblob\u002Fmain\u002Fskills\u002Facm-private-ca-deployer\u002Fevals\u002Fprompts\u002Fend-entity-certificate-issuance.md",{"path":107,"resourceType":66,"resourceTypeDesc":67,"sizeBytes":108,"sourceHtmlUrl":109},"evals\u002Fprompts\u002Fmissing-crl-bucket-policy.md",559,"https:\u002F\u002Fgithub.com\u002Fjhkchan\u002Faws-agent-skills\u002Fblob\u002Fmain\u002Fskills\u002Facm-private-ca-deployer\u002Fevals\u002Fprompts\u002Fmissing-crl-bucket-policy.md",{"path":111,"resourceType":66,"resourceTypeDesc":67,"sizeBytes":112,"sourceHtmlUrl":113},"evals\u002Fprompts\u002Froot-ca-with-crl.md",618,"https:\u002F\u002Fgithub.com\u002Fjhkchan\u002Faws-agent-skills\u002Fblob\u002Fmain\u002Fskills\u002Facm-private-ca-deployer\u002Fevals\u002Fprompts\u002Froot-ca-with-crl.md",{"path":115,"resourceType":66,"resourceTypeDesc":67,"sizeBytes":116,"sourceHtmlUrl":117},"evals\u002Fprompts\u002Fsubordinate-ca-signed-by-root.md",867,"https:\u002F\u002Fgithub.com\u002Fjhkchan\u002Faws-agent-skills\u002Fblob\u002Fmain\u002Fskills\u002Facm-private-ca-deployer\u002Fevals\u002Fprompts\u002Fsubordinate-ca-signed-by-root.md",{"path":119,"resourceType":66,"resourceTypeDesc":67,"sizeBytes":120,"sourceHtmlUrl":121},"examples\u002FREADME.md",9197,"https:\u002F\u002Fgithub.com\u002Fjhkchan\u002Faws-agent-skills\u002Fblob\u002Fmain\u002Fskills\u002Facm-private-ca-deployer\u002Fexamples\u002FREADME.md",{"path":123,"resourceType":66,"resourceTypeDesc":67,"sizeBytes":124,"sourceHtmlUrl":125},"references\u002Fadvanced-patterns.md",4134,"https:\u002F\u002Fgithub.com\u002Fjhkchan\u002Faws-agent-skills\u002Fblob\u002Fmain\u002Fskills\u002Facm-private-ca-deployer\u002Freferences\u002Fadvanced-patterns.md",{"path":127,"resourceType":66,"resourceTypeDesc":67,"sizeBytes":128,"sourceHtmlUrl":129},"references\u002Fca-hierarchy-and-signing.md",16221,"https:\u002F\u002Fgithub.com\u002Fjhkchan\u002Faws-agent-skills\u002Fblob\u002Fmain\u002Fskills\u002Facm-private-ca-deployer\u002Freferences\u002Fca-hierarchy-and-signing.md",{"path":131,"resourceType":66,"resourceTypeDesc":67,"sizeBytes":132,"sourceHtmlUrl":133},"references\u002Fcrl-and-revocation.md",15339,"https:\u002F\u002Fgithub.com\u002Fjhkchan\u002Faws-agent-skills\u002Fblob\u002Fmain\u002Fskills\u002Facm-private-ca-deployer\u002Freferences\u002Fcrl-and-revocation.md",{"path":135,"resourceType":66,"resourceTypeDesc":67,"sizeBytes":136,"sourceHtmlUrl":137},"references\u002Ferror-handling.md",1083,"https:\u002F\u002Fgithub.com\u002Fjhkchan\u002Faws-agent-skills\u002Fblob\u002Fmain\u002Fskills\u002Facm-private-ca-deployer\u002Freferences\u002Ferror-handling.md",{"path":139,"resourceType":66,"resourceTypeDesc":67,"sizeBytes":140,"sourceHtmlUrl":141},"skill.usf.yaml",4384,"https:\u002F\u002Fgithub.com\u002Fjhkchan\u002Faws-agent-skills\u002Fblob\u002Fmain\u002Fskills\u002Facm-private-ca-deployer\u002Fskill.usf.yaml",[143,150,157,164,171,178],{"skillNo":144,"name":145,"nameZh":6,"description":146,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":147,"categories":148,"keywords":149,"publishedAt":19},"01M7ADVD60X4PCAPKSE58P9NDC","xray-tracing-deployer","Deploys AWS X-Ray distributed tracing with production-grade configuration: X-Ray daemon deployment (EC2 systemd, ECS sidecar, EKS DaemonSet, Lambda built-in), SDK instrumentation (Java, Python, Node.js, Go, .NET) with annotations and metadata, sampling rules (default reservoir + rate vs custom rules with URL \u002F method \u002F service-name predicates), service map generation, trace query and retrieval, groups and insights, CloudWatch ServiceLens integration, IAM permissions (PutTraceSegments, GetSamplingRules), and latest features (Lambda Powertools tracing, OpenTelemetry \u002F ADOT Collector support, W3C trace context). Emits a READY_TO_DEPLOY checklist with every configuration item verified. Use when enabling X-Ray on a new application, adding tracing to ECS \u002F EKS \u002F Lambda, validating a sampling configuration, or generating daemon deployment CLI and IaC templates. Triggers: X-Ray, distributed tracing, X-Ray daemon, sampling rules, service map, X-Ray SDK, OpenTelemetry, ADOT, Lambda Powertools, CloudWatch ServiceLens.","https:\u002F\u002Fgithub.com\u002Fjhkchan\u002Faws-agent-skills\u002Fblob\u002Fmain\u002Fskills\u002Fxray-tracing-deployer\u002FSKILL.md",[],[],{"skillNo":151,"name":152,"nameZh":6,"description":153,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":154,"categories":155,"keywords":156,"publishedAt":19},"01M7ADTVJ7DCBM9CB1FY51GH7J","wellarchitected-workload-auditor","Audits AWS Well-Architected Tool workloads for review staleness, per-pillar high-risk issue counts, milestone tracking gaps, and remediation plan completeness. Emits a deterministic verdict (STALE_REVIEW | HIGH_RISK | CONFIG_GAP | OK) per workload with per-pillar risk breakdown, milestone trend analysis, and specific remediation. Use when reviewing Well-Architected workloads, checking WA review freshness, auditing high-risk issues per pillar, validating milestone coverage, or tracking remediation plans.","https:\u002F\u002Fgithub.com\u002Fjhkchan\u002Faws-agent-skills\u002Fblob\u002Fmain\u002Fskills\u002Fwellarchitected-workload-auditor\u002FSKILL.md",[],[],{"skillNo":158,"name":159,"nameZh":6,"description":160,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":161,"categories":162,"keywords":163,"publishedAt":19},"01M7ADT59G6FTTNZYHT2QRPNNP","wellarchitected-review-operator","Operates AWS Well-Architected Tool reviews end-to-end — creates workloads, runs pillar reviews (operational excellence, security, reliability, performance, cost optimization, sustainability, Prosperity), answers questions with risk-tier rationale, generates reports and improvement plans, creates milestones, and integrates with Trusted Advisor and Well-Architected Labs. Runs deterministic pre-checks (workload existence, lens availability, pillar coverage), emits the exact update-answer \u002F get-consolidated-report CLI behind a CONFIRM gate, and verifies risk-tier transitions. Emits READY | BLOCKED | COMPLETED. Use when creating a workload, answering pillar questions, generating an improvement plan, creating a milestone, or integrating with Trusted Advisor. Triggers: well-architected tool, well architected review, workload review, pillar, operational excellence, security, reliability, performance, cost optimization, sustainability, prosperity, improvement plan, milestone, trusted advisor.","https:\u002F\u002Fgithub.com\u002Fjhkchan\u002Faws-agent-skills\u002Fblob\u002Fmain\u002Fskills\u002Fwellarchitected-review-operator\u002FSKILL.md",[],[],{"skillNo":165,"name":166,"nameZh":6,"description":167,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":168,"categories":169,"keywords":170,"publishedAt":19},"01M7ADSH5JA9QHNPPHQCD7EVA7","wafv2-web-acl-deployer","Provisions AWS WAFv2 Web ACLs with correct production defaults: scope selection (CLOUDFRONT vs REGIONAL), managed rule groups (AWSManagedRulesCommonRuleSet, SQLiRuleSet, LinuxRuleSet, WindowsRuleSet, IPReputationList, BotControlRuleSet, AmazonIpReputationList, ATP), custom rules (byte match, IP set, regex pattern, geo match, size constraint, rate-based), rule priority ordering, logging destinations (Kinesis Firehose, CloudWatch Logs, S3), resource association (ALB, API Gateway, CloudFront), rate-based rules with aggregate keys (IP, forwarded IP), Challenge and CAPTCHA actions, and account takeover prevention. Emits a READY_TO_DEPLOY checklist. Use when creating a Web ACL, attaching managed rules, configuring rate limiting, enabling WAF logging, associating a Web ACL with an ALB\u002FAPI Gateway\u002FCloudFront, or configuring CAPTCHA\u002FChallenge actions. Triggers: create WAF Web ACL, WAFv2, managed rule groups, WAF rate limiting, WAF logging, WAF CAPTCHA, WAF Challenge action, bot control, ATP managed rules.","https:\u002F\u002Fgithub.com\u002Fjhkchan\u002Faws-agent-skills\u002Fblob\u002Fmain\u002Fskills\u002Fwafv2-web-acl-deployer\u002FSKILL.md",[],[],{"skillNo":172,"name":173,"nameZh":6,"description":174,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":175,"categories":176,"keywords":177,"publishedAt":19},"01M7ADRYFAT8R73FBNCHRC573X","wafv2-web-acl-auditor","Audits AWS WAFv2 Web ACL configurations to determine whether the ACL provides effective protection: default-action posture (Allow vs Block), managed-rule-group coverage gaps, rule effectiveness (BLOCK vs COUNT, shadow\u002Fbypass rules, stale exclusions), rate-based rule correctness, logging and visibility configuration, and text-transformation bypass vectors. Emits a deterministic verdict per Web ACL. Use when reviewing a WAFv2 Web ACL for security posture, checking managed-rule coverage, validating rate-limit configuration, auditing WAF logging, or hardening a WAF before production deployment. Triggers: WAF, WAFv2, Web ACL, managed rule group, AWSManagedRules, rate-based rule, CAPTCHA, Challenge, OverrideAction, Count mode, forwarded IP, Bot Control, ATP, text transformation, WAF logging, WAF visibility, OWASP, SQLi, XSS, RFI.","https:\u002F\u002Fgithub.com\u002Fjhkchan\u002Faws-agent-skills\u002Fblob\u002Fmain\u002Fskills\u002Fwafv2-web-acl-auditor\u002FSKILL.md",[],[],{"skillNo":179,"name":180,"nameZh":6,"description":181,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":182,"categories":183,"keywords":184,"publishedAt":19},"01M7ADR8W7G72JX4KFGN03QK8Q","waf-rule-deployer","Provisions AWS WAFv2 rule sets with production defaults: Web ACL creation (CloudFront scope in us-east-1 vs Regional scope), rule groups (managed vs custom) with capacity planning in WCU (Web ACL Capacity Units, 1500 default per ACL), managed rule groups (AWSManagedRulesCommonRuleSet, AWSManagedRulesSQLiRuleSet, AWSManagedRulesAmazonIpReputationList, AWSManagedRulesLinuxRuleSet, AWSManagedRulesWindowsRuleSet, AWSManagedRulesUnixRuleSet), custom rules (byte-match, regex pattern set, geo-match, rate-based), IP set and regex pattern set resources, rule priority ordering (lowest number evaluated first), action types (allow, block, count, CAPTCHA, Challenge), bot control managed rule group, account takeover. Triggers: create WAF rule, WAF managed rule group, WAF custom rule, WAF byte match, WAF geo match, WAF rate based rule, WAF IP set, WAF regex pattern set, WAF WCU budget, WAF CloudFront ACL, WAF logging Kinesis Firehose, WAF bot control, WAF ATP, WAF label matching, WAF Challenge action, WAF CAPTCHA.","https:\u002F\u002Fgithub.com\u002Fjhkchan\u002Faws-agent-skills\u002Fblob\u002Fmain\u002Fskills\u002Fwaf-rule-deployer\u002FSKILL.md",[],[]]