CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

aws-iam

Provides verified corrections for IAM behaviors that AI agents frequently get wrong — policy evaluation edge cases, trust policy gotchas, STS session limits, Organizations quirks, and SAML/MFA specifics. Also provides structured workflows for IAM role management and baseline policy generation from application source code or a Terraform plan JSON. Covers condition operator safety (ForAnyValue/ForAllValues with Null checks), bucket policy deny patterns (VPC endpoint restrictions, org paths), confused deputy protection, and service role creation for AWS services (Glue, CloudTrail, Lambda, ECS, etc.) with aws:SourceAccount/aws:SourceArn trust conditions. Applies when creating IAM roles, writing IAM or bucket policies, generating policies from application source code or a Terraform plan JSON, working with STS, Organizations, or condition operators, or any task needing a service or execution role. Does not cover non-IAM authorization like Cognito user-pool policies or app-level RBAC.

Quality

94%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

The canonical home for this skill is aws-iam in aws/agent-toolkit-for-aws

SKILL.md
Quality
Evals
Security

Quality

Content

93%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

An exemplary reference-style skill body: dense with verified, non-obvious corrections, fully actionable identifiers and examples, and clean routing to a well-organized bundle. The only gap is that multi-step workflow validation lives entirely in the reference files rather than being summarized in the body, which costs it slightly on workflow clarity.

DimensionReasoningScore

Conciseness

The body is a terse catalog of facts Claude cannot reliably recall from pre-training ('Instance profiles: waiter + `time.sleep(10)` pattern', 'Managed policy max versions: 5') with zero padding or explanation of known IAM concepts, and exactly one JSON example where the detail is required. Every line carries a non-obvious verified fact, matching the 'every token earns its place' anchor.

5 / 5

Actionability

It provides a complete, copy-paste-ready JSON policy demonstrating the ForAllValues + Null pattern, an exact CLI command ('aws organizations list-available-policy-types'), exact exception and method names ('DuplicatePolicyAttachmentException', 'activate()'), and concrete fixes ('use ForAnyValue:StringEqualsIgnoreCase', 'Scope Resource to specific role ARNs or an IAM path'). The guidance is fully executable across the common cases.

5 / 5

Workflow Clarity

Routing conditions are unambiguous ('Read [references/aws-iam-role-management.md] if the user needs to create, scope, or maintain IAM roles', a MUST directive for policy generation) and a global verification checkpoint is mandated ('verify specific claims... against official AWS documentation rather than relying on pre-training'). However, the body contains no explicit validation feedback loops or step sequences for the workflows it routes to — those live in the reference files — so it fits 'clear sequence with most checkpoints present; minor validation gaps' rather than anchor 5.

4 / 5

Progressive Disclosure

The body (~92 lines) keeps terse high-value corrections inline by design and defers deeper patterns to real, one-level-deep reference files ('See [references/common-pitfalls.md]'), each signaled with explicit read conditions. All referenced paths resolve to actual files in the bundle, and cross-links between references are lateral with no nesting chains, giving easy navigation and an appropriately split structure.

5 / 5

Total

19

/

20

Passed

Description

92%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

A strong description: concrete, densely specific capabilities paired with an explicit 'Applies when' trigger clause and explicit scope exclusions. Third-person voice throughout, no fluff or over-claims. The only weakness is incomplete synonym coverage in its trigger terms.

DimensionReasoningScore

Specificity

The description lists multiple concrete capabilities — 'verified corrections for IAM behaviors', 'structured workflows for IAM role management', 'baseline policy generation from application source code or a Terraform plan JSON', 'service role creation... with aws:SourceAccount/aws:SourceArn trust conditions' — with named condition operators, AWS services, and trust condition keys. Coverage within the IAM domain is comprehensive, matching the anchor-5 example rather than the 'minor gaps' of anchor 4.

5 / 5

Completeness

It explicitly answers both 'what' (verified corrections, role management workflows, policy generation, named coverage areas) and 'when' ('Applies when creating IAM roles, writing IAM or bucket policies... or any task needing a service or execution role') with concrete trigger phrases, plus explicit exclusions ('Does not cover non-IAM authorization like Cognito user-pool policies or app-level RBAC').

5 / 5

Trigger Term Quality

The trigger clause covers strong natural terms — 'creating IAM roles, writing IAM or bucket policies, generating policies from application source code or a Terraform plan JSON, working with STS, Organizations, or condition operators, or any task needing a service or execution role' — but a few natural synonyms users would say are absent (e.g., 'pass role', 'assume role', 'trust policy' as triggers). This fits 'good keyword coverage; a few natural terms missing' rather than the comprehensive synonym coverage of anchor 5.

4 / 5

Distinctiveness Conflict Risk

It occupies a clear AWS IAM niche with distinct, technical trigger vocabulary and explicit non-goals, so overlap with other skills is minimal — matching the 'clear niche with distinct triggers' anchor.

5 / 5

Total

19

/

20

Passed

Validation

100%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository

aws/agent-toolkit-for-aws

Path

plugins/aws-core/skills/aws-iam/SKILL.md

Reviewed

Table of Contents

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.