AWS Agents For Devsecops
AWS Core
Core Skills · AWS…
Messaging And Streaming Skills
Migration And Modernization Skills
Networking And Content Delivery Skills
Security And Identity Skills
System Table Skills
Web And Mobile Development
120 chapters · 648 min
Core Skills
Chapter 41 of 120
Covers AWS security services and workflows — Security Hub V2 (OCSF) findings, connectors, aggregators, automation rules, and security posture summaries; Security Hub CSPM…
6 minutes · 1,380 words · 6 sections
STOP — Do not answer from general knowledge. Before responding to any security service question, match the user’s request against the sub-skill registry below and follow its procedure. If the procedure says to load a reference file, you MUST read it before providing operational guidance. Never skip the routing step.
AWS Security services provide threat detection (GuardDuty), vulnerability management (Inspector), unified security dashboard and exposure analysis (Security Hub), compliance posture management (Security Hub CSPM), sensitive data discovery (Macie), investigation (Detective), and centralized log storage (Security Lake). Each service has dedicated reference procedures for configuration review and findings/investigation summarization.
This skill works with or without the AWS MCP server. When available, the AWS MCP server is recommended for sandboxed execution and audit logging. Procedures use standard AWS CLI syntax (aws <service> <command>).
See references/services-overview.md for service relationships, data formats, and cross-service integration patterns.
Read-only APIs only. This skill and all its references use exclusively non-mutating APIs. NEVER reference, recommend, or invoke any API that creates, modifies, deletes, enables, disables, or otherwise mutates resource state or configuration — not even in prose recommendations. See service reference files for the complete allowed API list.
No severity judgements on configuration state. Present what is and is not configured factually. Do not assign severity labels, gap assessments, or editorial framing (e.g., “critical gap”, “security issue”) to configuration state.
No false-positive suppression recommendations. Focus on helping customers understand findings. Do not recommend suppression filters, archival rules, or finding dismissal.
Prioritize Attack Sequences in GuardDuty. Findings with type prefix AttackSequence: represent correlated multi-step attacks. Always surface these first, before severity breakdown.
Prioritize Exposure findings in Security Hub. Exposure findings (attack paths, resource exposure) represent Security Hub’s unique cross-service correlation. Surface these first in any findings summary.
Expensive operations require explicit request. MUST NOT paginate through all member accounts by default. Per-account enumeration only executes if the user explicitly requests detailed account-level information. Use statistics/count APIs where available (e.g., get-coverage-statistics).
Match the user’s language. Respond in the same language the user writes in.
Verify, don’t guess. If you cannot confirm a fact from a reference file or API output, say so.
Sensitive data disclosure. When a procedure produces output that may contain sensitive information (full finding bodies, IP addresses, resource identifiers, network configurations, threat intelligence details), present a summary first. Note what sensitive data the full output contains. Display the complete raw response only when the caller explicitly requests it.
Find the sub-skill — Match the user’s request against the sub-skill registry below. Match on meaning, not exact wording. If ambiguous, ask: “Are you checking configuration, or do you need a findings summary?”
If a sub-skill matches — read references/{sub-skill-id}.md and follow its procedure.
If no sub-skill matches — answer from the service reference files listed below. Load references/services-overview.md for cross-service context, or the relevant service reference file (e.g., references/guardduty.md) for API scope and severity scoring questions.
Cross-service overview — When the user asks about overall security posture across multiple services, start with references/services-overview.md, then route to relevant sub-skills.
| ID | Name | Trigger Phrases | When to Route Here | Reference |
|---|---|---|---|---|
guardduty-configuration | GuardDuty Config Review | “is GuardDuty configured”, “check detector”, “GuardDuty features enabled”, “runtime monitoring setup” | User wants to verify GuardDuty deployment completeness | references/guardduty-configuration.md |
guardduty-findings | GuardDuty Findings Summary | “summarize GuardDuty findings”, “what threats”, “GuardDuty severity breakdown”, “attack sequences” | User wants a findings posture snapshot | references/guardduty-findings.md |
inspector-configuration | Inspector Config Review | “is Inspector scanning”, “Inspector enabled”, “scan types”, “coverage gaps” | User wants to verify Inspector deployment | references/inspector-configuration.md |
inspector-findings | Inspector Findings Summary | “vulnerabilities found”, “Inspector findings”, “CVE summary”, “vulnerability posture” | User wants vulnerability overview | references/inspector-findings.md |
security-hub-configuration | Security Hub Config Review | “Security Hub integrations”, “aggregation configured”, “connectors”, “automation rules”, “V2 automation rules”, “OCSF automation rules” | User wants to verify Security Hub V2 (OCSF) setup | references/security-hub-configuration.md |
security-hub-findings | Security Hub Findings Summary | “risk overview”, “exposure findings”, “attack paths”, “OCSF findings”, “security posture trends” | User wants Security Hub V2 (OCSF) findings overview | references/security-hub-findings.md |
security-hub-cspm-configuration | CSPM Config Review | “standards enabled”, “controls”, “FSBP”, “CIS”, “PCI-DSS”, “NIST”, “compliance setup”, “AI security”, “AI best practices”, “CSPM automation rules”, “ASFF automation rules” | User wants to verify compliance standards setup | references/security-hub-cspm-configuration.md |
security-hub-cspm-findings | CSPM Compliance Summary |
| Keywords | Route to |
|---|---|
| “automation rules” (ambiguous) | Both Security Hub and Security Hub CSPM have automation rules. If customer uses Security Hub V2 (OCSF), route to Security Hub config. If customer uses Security Hub CSPM (ASFF), route to CSPM config. Ask if unclear. |
| “standards”, “controls”, “compliance”, “FSBP”, “CIS”, “PCI”, “NIST”, “ASFF” | Security Hub CSPM skills |
| “integrations”, “risk score”, “attack path”, “OCSF”, “exposure”, “connectors” | Security Hub skills |
| “threat detection”, “GuardDuty”, “detector”, “runtime monitoring”, “attack sequence” | GuardDuty skills |
| “vulnerability”, “CVE”, “Inspector”, “scanning”, “code vulnerability” | Inspector skills |
| “sensitive data”, “classification”, “Macie”, “PII”, “data discovery” | Macie skills |
| “investigation”, “behavior graph”, “Detective”, “indicators” | Detective skills |
| “data lake”, “log sources”, “Security Lake”, “subscribers”, “ingestion” | Security Lake skills |
| “organization policies”, “org policies”, “policy type”, “list-policies --filter” | Organization Policies (cross-service) |
Note: If a customer is using Security Hub V2 (OCSF), they should use Security Hub automation rules (list-automation-rules-v2) and should NOT use Security Hub CSPM features for new rules, even though CSPM remains technically available.
Load service reference files on demand — only when the current turn requires context about service capabilities, API scope, or severity scoring.
| Reference | Content | When to Load |
|---|---|---|
references/services-overview.md | Cross-service relationships, data formats, membership models, admin discovery, API conventions | Cross-service questions, general security posture, “which services should I enable” |
references/guardduty.md | GuardDuty APIs, severity scoring, service notes | GuardDuty-specific questions about APIs or severity |
references/inspector.md | Inspector APIs, severity scoring, service notes | Inspector-specific questions about APIs or severity |
references/security-hub.md | Security Hub V2 (OCSF) APIs, severity scoring, service notes | Security Hub V2-specific questions about APIs or severity |
references/security-hub-cspm.md | Security Hub CSPM (V1/ASFF) APIs, severity scoring, service notes | CSPM-specific questions about APIs or severity |
references/macie.md | Macie APIs, severity scoring, service notes | Macie-specific questions about APIs or severity |
references/detective.md | Detective APIs, severity scoring, service notes | Detective-specific questions about APIs or severity |
references/security-lake.md | Security Lake APIs, service notes | Security Lake-specific questions about APIs |
references/organization-policies.md | Organization policies discovery pattern, policy types, Organizations APIs | Questions about org-level policy enforcement across security services |
aws:SourceArn and aws:SourceAccount condition keys where applicable.Install this repository
npx skills add aws/agent-toolkit-for-aws/plugin marketplace add aws/agent-toolkit-for-awsSkills install per repository, not per chapter — the CLI has no documented per-skill form, so we do not print one.
Covers AWS security services and workflows — Security Hub V2 (OCSF) findings, connectors, aggregators, automation rules, and security posture summaries; Security Hub CSPM (V1/ASFF) controls and compliance standards; GuardDuty threat findings; Inspector vulnerability findings; Macie sensitive data findings; Detective investigation; and Security Lake configuration and data aggregation. Applicable when questions involve security posture, Exposure findings, CSPM failed controls, threat findings, vulnerability findings, sensitive data findings, automation rules, or cross-service security configuration across AWS environments. Procedures use standard AWS CLI syntax and work with or without the AWS MCP server.
The verbatim description from this skill’s front matter — the string an agent matches on to decide whether to load it.
main, last pushed 10 August 2026.SKILL.md, not by matching a directory convention. 17 distinct layouts observed: plugins/aws-agents-for-devsecops/skills/*/SKILL.md, plugins/aws-agents/skills/*/SKILL.md, plugins/aws-core/skills/*/SKILL.md, skills/core-skills/*/SKILL.md, skills/specialized-skills/analytics-skills/*/SKILL.md, skills/specialized-skills/database-skills/*/SKILL.md, skills/specialized-skills/ec2-skills/*/SKILL.md, skills/specialized-skills/messaging-and-streaming-skills/*/SKILL.md, skills/specialized-skills/migration-and-modernization-skills/*/SKILL.md, skills/specialized-skills/networking-and-content-delivery-skills/*/SKILL.md, skills/specialized-skills/operations-skills/*/SKILL.md, skills/specialized-skills/resilience-skills/*/SKILL.md, skills/specialized-skills/security-and-identity-skills/*/SKILL.md, skills/specialized-skills/serverless-skills/*/SKILL.md.| “compliance posture”, “failed controls”, “pass rate”, “ASFF findings”, “third-party findings” |
| User wants compliance findings overview |
references/security-hub-cspm-findings.md |
macie-configuration | Macie Config Review | “Macie configured”, “data discovery setup”, “classification jobs”, “Macie enabled” | User wants to verify Macie deployment | references/macie-configuration.md |
macie-findings | Macie Findings Summary | “sensitive data found”, “Macie findings”, “data classification results”, “PII detected” | User wants sensitive data overview | references/macie-findings.md |
detective-configuration | Detective Config Review | “Detective configured”, “behavior graph”, “Detective members”, “data sources” | User wants to verify Detective deployment | references/detective-configuration.md |
detective-investigations | Detective Investigations Summary | “Detective investigations”, “investigation status”, “indicators”, “finding groups” | User wants investigation landscape overview | references/detective-investigations.md |
security-lake-configuration | Security Lake Config Review | “Security Lake configured”, “log sources enabled”, “subscribers”, “data lake setup” | User wants to verify Security Lake deployment | references/security-lake-configuration.md |
security-lake-sources | Security Lake Sources Summary | “what’s flowing into Security Lake”, “ingestion status”, “source health”, “data lake exceptions” | User wants data lake health overview | references/security-lake-sources.md |
organization-policies | Organization Policies Review | “organization policies”, “org policies”, “SECURITYHUB_POLICY”, “INSPECTOR_POLICY”, “list-policies”, “policy targets”, “policy enforcement” | User wants to review or discover AWS Organizations service policies | references/organization-policies.md |
skills/specialized-skills/storage-skills/*/SKILL.mdskills/specialized-skills/system-table-skills/*/SKILL.mdskills/specialized-skills/web-and-mobile-development/*/SKILL.mdh1 and no skipped levels:.claude-plugin/marketplace.json by Amazon Web Services, declaring 4 plugins. It is read for editorial metadata only — never as the skill index, which is always the repository tree./aws/agent-toolkit-for-aws.md, and each chapter at its own .md URL.23 files · 96 KB
Everything this skill ships beside its prose. All of it is set here, as subchapters of chapter 41.
Documentation the agent loads on demand, rather than up front.